README.md

A NestJS boilerplate for starting a new project faster.

Description

NestJS boilerplate for a typical project

Demo: https://nestjs-boilerplate-n27l.onrender.com/api-docs

Getting started

# Clone the repository
git clone https://github.com/vndevteam/nestjs-boilerplate.git

# Create environment variables file.
cp .env.example .env

# Install dependences.
pnpm install

Checklist

When you use this template, try follow the checklist to update your info properly

• Change the author name in LICENSE
• Change configurations in .env
• Remove the .github folder which contains the funding info
• Clean up the README.md file

Running the app

# development
$ pnpm start

# watch mode
$ pnpm start:dev

# production mode
$ pnpm start:prod

Features

• Fastify support. (Checkout the feature.fastify branch)
• Database. Support TypeORM
• Seeding (Typeorm Extension).
• Config Service (@nestjs/config).
• Mailing (@nestjs-modules/mailer & nodemailer).
• Sign in and sign up via email.
• Social sign in (Apple, Facebook, Google, Twitter).
• Admin and User roles.
• Pagination: Offset and Cursor (Clone from typeorm-cursor-pagination and add more features).
• Internationalization/Translations (I18N) (nestjs-i18n).
• File uploads. Support local and Amazon S3 drivers.
• Swagger.
• E2E and units tests.
• Docker.
• CI (Github Actions).

More documentations

Please read the docs. It contains the details about the project structure, conventions, and more.

References

• Awesome Nest Boilerplate
• Brocoders NestJS Boilerplate

Support

Discuss on Github