Skip to content

jhipster-projects/generator-jhipster-nodejs

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

generator-jhipster-nodejs

NPM version Dependency Status Generator Build Status Generator Test Status Sonar Cloud Quality Gate Sonar Cloud Coverage Rate Sonar Cloud Reliability Rate Sonar Cloud Security Rate Sonar Cloud Maintainability Rate Sonar Cloud Duplicated Code Gitter Downloads

generator-jhipster-nodejs, the official NodeJS blueprint that uses NestJS TypeScript Framework for your backend. We encourage you to use it and give us your feedback.

Notes

For the features of the last release refers to CHANGELOG.md.

Demo

The UI is inherited from standard JHipster app client. So only backend generation changes. For this, a live app running is less useful than the code and the app structure shows in:

Greetings, nodejs Hipster!

This project adds nodejs for your backend, all TypeScript files generation, not Java!, to the JHipster application 😎. It is based on JHipster Blueprint 🔵, that is meant to be used in a JHipster application.

The generator applies this standard configuration for the NodeJS app:

  • The app starts with four seed users (admin, basic user and anonymous roles), as standard JHipster monolithic app, with SQLite for dev and configurable sql db for prod
  • The app uses TypeORM and asks you a question for another sql db
  • TypeORM is also used for the automatically migration and versioning of the database scripts
  • The app runs also as a full stack app including, for the monolitich choice, the Angular/React client with the home page set for NHipster and CRUD operations for entity generated with subgenerator and jdl import

A previous of a jwt auth app:

Prerequisites

As this is a JHipster blueprint, we expect you have JHipster and its related tools already installed:

🚀 How to get started

  1. Make sure you have followed the JHipster installation guide and that both yeoman and jhipster are installed.
  2. Install the package with npm install -g generator-jhipster-nodejs
  3. And generate the application with nhipster

Installation Details

With NPM

To install this blueprint:

npm install -g generator-jhipster-nodejs

To update this blueprint:

npm update -g generator-jhipster-nodejs

With Yarn

To install this blueprint:

yarn global add generator-jhipster-nodejs

To update this blueprint:

yarn global upgrade generator-jhipster-nodejs

🚦 What we have now

This is a blueprint that is runnable by:

jhipster --blueprints nodejs

However, it also ships with an nhipster CLI that you can use as a shortcut.

✅ General App generation

  • nhipster

✅ Controller generation

  • nhipster spring-controller <controller-name>

✅ Service generation

  • nhipster spring-service <service-name>

✅ Entity generation

  • nhipster entity <entity-name>

✅ JDL Entity model support generation

  • nhipster import-jdl my_file.jdl

For the last, in the test-integration/samples/FOLDER_NAME-jdl there are some examples of jdl models.

🛠 Steps to develop a generator feature and test it

Shell steps:

$ git clone https://github.com/jhipster/generator-jhipster-nodejs.git
$ cd generator-jhipster-nodejs
$ git checkout -b feature/my-feature
$ npm install
$ npm link
$ cd ..
$ git clone https://github.com/jhipster/generator-jhipster.git
$ cd generator-jhipster
$ npm install
$ npm link
$ cd ..
$ mkdir test-generation
$ cd test-generation
$ npm link generator-jhipster
$ npm link generator-jhipster-nodejs

Now you will develop under the generator-jhipster-nodejs that you have cloned with git. After finish, to generate the app and check your feature, run in test-generation folder:

  • nhipster

❤️ For community

Found an issue, check if is already opened or closed, otherwise open a new feature or bug.

Interested in contributing, check out our contributing guide to get started.

Refer for contribution to roadmap or to kanban board.

Any questions Angelo Manganiello.

Contributors ✨

Thanks goes to these wonderful people:

Angelo Manganiello (founder stream lead)
Angelo Manganiello
(founder stream lead)
Hadi Rasouli
Hadi Rasouli
Iván García Sainz-Aja
Iván García Sainz-Aja
Daniel Franco
Daniel Franco
Ed Pham
Ed Pham

Special Thanks

License

Apache-2.0 © Angelo Manganiello

About

A NodeJS blueprint that creates the backend using NodeJS

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 71.8%
  • JavaScript 25.6%
  • Shell 2.3%
  • TypeScript 0.3%