generator-jhipster-nodejs

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:

• The sample repo app with React client and Okta OAuth2
• The sample repo app with Angular client and JWT auth
• The sample repo app with Vue.js client and mongodb

These sample repos were generated with the blueprint v2.0.0 (JHipster 7) and are not representative of the current release anymore. For up-to-date application configurations, see the samples built by the CI.

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:

• NestJS base app with web controllers, swagger doc and JWT or OAuth2 passport auth services

• 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. MongoDB support is experimental in TypeORM so is in JHipster NodeJS.

• The app uses TypeORM and asks you a question for another sql db or for mongodb

• 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/Vue 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

This blueprint bundles the JHipster version it is built against and ships its own nhipster CLI, so the only requirement is a supported Node.js version:

• Node.js ^22.18.0 || >=24.11.0

The authoritative values are the engines of package.json, which also pins the supported generator-jhipster version.

A global jhipster or yo installation is not required: generator-jhipster is a direct dependency of this blueprint.

🚀 How to get started

1. Make sure you run a supported Node.js version (see Prerequisites).
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

yarn global is only available in Yarn Classic (1.x); with Yarn 2+ (Berry) install the blueprint with npm.

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 blueprint ships its own CLI, nhipster, which wraps the JHipster CLI with the blueprint already enabled. Both monolith and microservice application types are supported.

✅ General App generation

• nhipster

✅ Entity generation

• nhipster entity <entity-name>

✅ JDL model support generation

• nhipster jdl my_file.jdl

✅ Ci-cd generation

• nhipster ci-cd

For the last, in the generate-sample samples folder and jdl-samples there are some examples of jdl models.

Using Docker

1. Download the Dockerfile:

mkdir docker
cd docker
wget https://github.com/jhipster/generator-jhipster-nodejs/raw/main/docker/Dockerfile

2. Build the Docker images:

docker build -t jhipster-generator-nodejs:latest .

3. Make a folder where you want to generate the Application:

mkdir app
cd app

4. Run the generator image in one of the two following options.

• Run the generator from image to generate service:

docker run -it --rm -v $PWD:/home/jhipster/app jhipster-generator-nodejs

• Run and attach interactive shell to the generator docker container to work from inside the running container:

docker run -it --rm -v $PWD:/home/jhipster/app jhipster-generator-nodejs /bin/bash

🛠 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 ..
$ mkdir test-generation
$ cd test-generation

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 the roadmap.

Any questions Angelo Manganiello.

Contributors ✨

Thanks goes to these wonderful people:

Angelo Manganiello (founder stream lead)

Hadi Rasouli

Iván García Sainz-Aja

Daniel Franco

Ed Pham

Markus

Special Thanks

License

Apache-2.0 © Angelo Manganiello