hub / github.com/NarHakobyan/awesome-nest-boilerplate

github.com/NarHakobyan/awesome-nest-boilerplate @v11.0.0 sqlite

repository ↗ · DeepWiki ↗ · release v11.0.0 ↗

374 symbols 708 edges 101 files 2 documented · 1%

README

Awesome NestJS Boilerplate v11

This is an ever-evolving, very opinionated architecture and dev environment for new node projects using NestJS. Questions, feedback, and for now, even bikeshedding are welcome. 😄

Getting started

# 1. Clone the repository or click on "Use this template" button.
npx degit NarHakobyan/awesome-nest-boilerplate my-nest-app

# 2. Enter your newly-cloned folder.
cd my-nest-app

# 3. Create Environment variables file.
cp .env.example .env

# 3. Install dependencies. (Make sure yarn is installed: https://yarnpkg.com/lang/en/docs/install)
yarn

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

And, enjoy :)

Node Development

Scripts

# 4. Run development server and open http://localhost:3000
yarn start:dev

# 5. Read the documentation linked below for "Setup and development".

Build

To build the App, run

yarn build:prod

And you will see the generated file in dist that ready to be served.

Deno Development

We are excited to announce that this project now supports Deno! You can use Deno to run, build, and test your application. 🦕

Scripts

Here are the available scripts for Deno:

# Start the development server
deno task start

# Start the server with file watcher
deno task watch

# Run tests
deno task test

# Compile the application (not working yet)
deno task compile

To build the App using Deno, run:

deno task buildr

And you will see the generated file in dist that is ready to be served.

Bun Development

We are excited to announce that this project now supports Bun! You can use Bun to run, build, and test your application. 🧅

Scripts

Here are the available scripts for Bun:

# Start the development server
bun start:dev:bun

# Start the server with file watcher
bun watch:bun

# Run tests

bun test

# Build the application

bun build:bun

And you will see the generated file in dist that is ready to be served.

Features

Instant feedback: Enjoy the best DX (Developer eXperience) and code your app at the speed of thought! Your saved changes are reflected instantaneously.
JWT Authentication: Installed and configured JWT authentication.
Next generation Typescript: Always up to date typescript version.
Industry-standard routing: It's natural to want to add pages (e.g. /about`) to your application, and routing makes this possible.
Environment Configuration: development, staging and production environment configurations
Swagger Api Documentation: Already integrated API documentation. To see all available endpoints visit http://localhost:3000/documentation
Node, Bun, Deno: Support for Node, Bun, and Deno. You can run, build, and test your application using any of these runtime.
Linter: eslint + prettier = ❤️

Documentation

This project includes a docs folder with more details on:

Community

For help, discussion about best practices, or any other conversation that would benefit from being searchable:

Discuss Awesome NestJS Boilerplate on GitHub

Extension points exported contracts — how you extend this code

Array (Interface)

(no doc)

src/boilerplate.polyfill.ts

IUniqueValidationArguments (Interface)

(no doc)

src/validators/unique.validator.ts

IPageMetaDtoParameters (Interface)

(no doc)

src/common/dto/page-meta.dto.ts

ITranslationDecoratorInterface (Interface)

(no doc)

src/interfaces/ITranslationDecoratorInterface.ts

IFieldOptions (Interface)

(no doc)

src/decorators/field.decorators.ts

SelectQueryBuilder (Interface)

(no doc)

src/boilerplate.polyfill.ts

IExistsValidationArguments (Interface)

(no doc)

src/validators/exists.validator.ts

IFile (Interface)

(no doc)

src/interfaces/IFile.ts

Core symbols most depended-on inside this repo

getString

called by 14

src/shared/services/api-config.service.ts

IsUndefinable

called by 13

src/decorators/validator.decorators.ts

IsNullable

called by 13

src/decorators/validator.decorators.ts

StringField

called by 10

src/decorators/field.decorators.ts

get

called by 8

src/providers/context.provider.ts

snakeCase

called by 7

src/snake-naming.strategy.ts

StringFieldOptional

called by 7

src/decorators/field.decorators.ts

Auth

called by 7

src/decorators/http.decorators.ts

Shape

Method 144

Class 141

Function 74

Interface 11

Enum 4

Languages

TypeScript100%

Modules by API surface

src/decorators/field.decorators.ts29 symbols

src/shared/services/api-config.service.ts21 symbols

src/boilerplate.polyfill.ts11 symbols

src/snake-naming.strategy.ts9 symbols

src/providers/generator.provider.ts9 symbols

src/providers/context.provider.ts9 symbols

src/modules/user/user.service.ts9 symbols

src/modules/post/post.service.ts8 symbols

src/modules/post/post.controller.ts8 symbols

src/decorators/transform.decorators.ts8 symbols

src/validators/unique.validator.ts7 symbols

src/validators/exists.validator.ts7 symbols

Dependencies from manifests, versioned

@aws-sdk/client-s33.741.0 · 1×

@eslint/compat1.2.6 · 1×

@eslint/eslintrc3.2.0 · 1×

@eslint/js9.19.0 · 1×

@nestjs/cli11.0.2 · 1×

@nestjs/common11.0.5 · 1×

@nestjs/config4.0.0 · 1×

@nestjs/core11.0.7 · 1×

@nestjs/cqrs11.0.1 · 1×

@nestjs/jwt11.0.0 · 1×

@nestjs/microservices11.0.7 · 1×

@nestjs/passport11.0.5 · 1×

Datastores touched

(mysql)Database · 1 repos

For agents

$ claude mcp add awesome-nest-boilerplate \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact