Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mikemajesty/nestjs-monorepo
Monorepo boilerplate using Nestjs, authentication, docker, redis, secrets service, logs service, libs structure, anti corruption layer pattern, adapter pattern, dependency inversion pattern, mongodb, redis, swagger and tests.
https://github.com/mikemajesty/nestjs-monorepo
adapter-pattern anti-corruption-layer-pattern dependency-inversion-pattern generic-repository-pattern mongo mongodb mongodb-database mongoose mongoosejs monorepo monorepo-boilerplate monorepo-example monorepo-multipackage monoreponest multiplesdatabase nestjs nestjs-auth swaggger-documentation template
Last synced: 7 days ago
JSON representation
Monorepo boilerplate using Nestjs, authentication, docker, redis, secrets service, logs service, libs structure, anti corruption layer pattern, adapter pattern, dependency inversion pattern, mongodb, redis, swagger and tests.
- Host: GitHub
- URL: https://github.com/mikemajesty/nestjs-monorepo
- Owner: mikemajesty
- Created: 2021-11-05T22:07:20.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-01-18T20:05:19.000Z (11 months ago)
- Last Synced: 2024-12-03T17:10:22.845Z (18 days ago)
- Topics: adapter-pattern, anti-corruption-layer-pattern, dependency-inversion-pattern, generic-repository-pattern, mongo, mongodb, mongodb-database, mongoose, mongoosejs, monorepo, monorepo-boilerplate, monorepo-example, monorepo-multipackage, monoreponest, multiplesdatabase, nestjs, nestjs-auth, swaggger-documentation, template
- Language: TypeScript
- Homepage:
- Size: 707 KB
- Stars: 341
- Watchers: 8
- Forks: 88
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# Nestjs Monorepo Boilerplate
Check
- [monorepo docs](https://docs.nestjs.com/cli/monorepo)
- [contributing manual](./CONTRIBUTING.md)
| Statements | Branches | Functions | Lines |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
|  |  |  |  |
##### Monorepo with nestjs
- Docker
- Secrets Service
- Logs Service
- Pinojs
- Elastic
- Observability
- Jeager
- Opentracing
- Authentication
- Error Handler
- Libs Structure
- Dependency Inversion Pattern
- Anti Corruption Layer Pattern
- Interface Adapter Pattern
- Generic Repository Pattern
- Swaggger Documentation
- Redis
- Mongodb
- mongoose
- multiples databases
- Tests
- unit
- e2e
- 90% coverage
---
#### Prerequisite
- Node: 14 => <= 16
- Docker
- npm install -g commitizen
- npm install -g changelog
- https://stedolan.github.io/jq/download/
#### Instalation
- install monorepo dependencies
```bash
$ yarn monorepo:install
```
- install project dependencies
```bash
$ yarn workspace install
```
- install lib on project
```bash
$ yarn workspace add
```
---
#### Running local mongodb/redis/kibana/jeager
```bash
$ yarn infra:local
# http://0.0.0.0:8082/ to access mongo
# http://0.0.0.0:8081/ to access redis
# http://0.0.0.0:5601/app/home to access kibana
# http://0.0.0.0:16686/search to access jeager
```
#### Running the app
- local
```bash
$ yarn start:auth-api:dev
$ yarn start:cats-api:dev
```
- dev/hml/prd environment
```bash
$ docker-compose up --build
```
---
#### Create Access User
- http://0.0.0.0:8082/db/monorepo_auth/users
- Click [New Document]
```
{
"_id": ObjectID(),
"login": "",
"pass": ""
}
```
- now use this curl to get your access token
```
curl -X 'POST' 'http://0.0.0.0:4000/api/login' -H 'accept: application/json' -H 'Content-Type: application/json' -d '{ "login": "", "pass": "" }'
```
- use this token to access all monorepo internal APIs
---
##### workspace list
```bash
$ yarn workspaces info
```
- @app/cats.api
- @app/auth.api
- @tools/eslint.config
- @libs/utils
- @libs/modules
- @libs/core
---
#### Add new features
```bash
$ npm i -g @mikemajesty/monorepo-nestjs-cli
```
- ```bash
# type and choose your template
$ monorepo-nestjs-cli
```
- see [doc](https://github.com/mikemajesty/monorepo-nestjs-cli)
---
#### Tests
- unit
```bash
# Run monorepo tests
$ yarn test
```
```bash
# Run project tests
$ yarn test main.api
$ yarn test auth.api
$ yarn test libs
```
- e2e
```
$ yarn test:e2e
```
- coverage
```
$ yarn test:coverage
```
---
#### Lint
- Run monorepo lint
```bash
$ yarn lint
```
- Run project lint
```
$ yarn workspace lint
```
---
#### Build
- Run project build
```
$ yarn build
```
---
-- App Skeleton
```
.
├── apps
│ ├── auth-api
│ │ ├── Dockerfile
│ │ ├── jest.config.js
│ │ ├── package.json
│ │ ├── src
│ │ │ ├── main.ts
│ │ │ └── modules
│ │ │ ├── health
│ │ │ │ ├── adapter.ts
│ │ │ │ ├── controller.ts
│ │ │ │ ├── module.ts
│ │ │ │ ├── service.ts
│ │ │ │ ├── swagger.ts
│ │ │ │ └── __tests__
│ │ │ │ ├── controller.e2e.spec.ts
│ │ │ │ ├── module.spec.ts
│ │ │ │ └── service.spec.ts
│ │ │ ├── login
│ │ │ │ ├── adapter.ts
│ │ │ │ ├── controller.ts
│ │ │ │ ├── module.ts
│ │ │ │ ├── service.ts
│ │ │ │ ├── swagger.ts
│ │ │ │ └── __tests__
│ │ │ │ ├── controller.e2e.spec.ts
│ │ │ │ └── service.spec.ts
│ │ │ ├── module.ts
│ │ │ ├── __tests__
│ │ │ │ └── module.spec.ts
│ │ │ └── user
│ │ │ ├── adapter.ts
│ │ │ ├── entity.ts
│ │ │ ├── module.ts
│ │ │ ├── repository.ts
│ │ │ ├── schema.ts
│ │ │ └── __tests__
│ │ │ └── repository.spec.ts
│ │ ├── tests
│ │ │ └── initialization.js
│ │ ├── tsconfig.build.json
│ │ ├── tsconfig.json
│ │ └── yarn.lock
│ └── cats-api
│ ├── Dockerfile
│ ├── jest.config.js
│ ├── node_modules
│ ├── package.json
│ ├── src
│ │ ├── main.ts
│ │ └── modules
│ │ ├── cats
│ │ │ ├── adapter.ts
│ │ │ ├── controller.ts
│ │ │ ├── entity.ts
│ │ │ ├── module.ts
│ │ │ ├── repository.ts
│ │ │ ├── schema.ts
│ │ │ ├── swagger.ts
│ │ │ └── __tests__
│ │ │ ├── controller.e2e.spec.ts
│ │ │ └── repository.spec.ts
│ │ ├── health
│ │ │ ├── adapter.ts
│ │ │ ├── controller.ts
│ │ │ ├── module.ts
│ │ │ ├── service.ts
│ │ │ ├── swagger.ts
│ │ │ └── __tests__
│ │ │ ├── controller.e2e.spec.ts
│ │ │ ├── module.spec.ts
│ │ │ └── service.spec.ts
│ │ ├── module.ts
│ │ └── __tests__
│ │ └── module.spec.ts
│ ├── tests
│ │ └── initialization.js
│ ├── tsconfig.build.json
│ └── tsconfig.json
├── CHANGELOG.md
├── commitlint.config.ts
├── CONTRIBUTING.md
├── deploy
│ └── production-version.sh
├── docker-compose-local.yml
├── docker-compose.yml
├── jest.config.e2e.ts
├── jest.config.ts
├── libs
│ ├── core
│ │ ├── index.ts
│ │ ├── jest.config.js
│ │ ├── package.json
│ │ ├── tests
│ │ │ └── initialization.js
│ │ └── tsconfig.json
│ ├── modules
│ │ ├── auth
│ │ │ └── token
│ │ │ ├── adapter.ts
│ │ │ ├── module.ts
│ │ │ ├── service.ts
│ │ │ ├── __tests__
│ │ │ │ └── service.spec.ts
│ │ │ └── types.ts
│ │ ├── common
│ │ │ ├── http
│ │ │ │ ├── adapter.ts
│ │ │ │ ├── module.ts
│ │ │ │ ├── service.ts
│ │ │ │ └── __tests__
│ │ │ │ ├── module.spec.ts
│ │ │ │ └── service.spec.ts
│ │ │ ├── module.ts
│ │ │ └── __tests__
│ │ │ └── module.spec.ts
│ │ ├── database
│ │ │ ├── adapter.ts
│ │ │ ├── connection
│ │ │ │ ├── auth.ts
│ │ │ │ └── cats.ts
│ │ │ ├── entity.ts
│ │ │ ├── enum.ts
│ │ │ ├── repository.ts
│ │ │ ├── service.ts
│ │ │ └── __tests__
│ │ │ ├── repository.spec.ts
│ │ │ └── service.spec.ts
│ │ ├── global
│ │ │ ├── logger
│ │ │ │ ├── adapter.ts
│ │ │ │ ├── module.ts
│ │ │ │ ├── service.ts
│ │ │ │ ├── __tests__
│ │ │ │ │ ├── module.spec.ts
│ │ │ │ │ └── service.spec.ts
│ │ │ │ └── type.ts
│ │ │ ├── module.ts
│ │ │ ├── secrets
│ │ │ │ ├── adapter.ts
│ │ │ │ ├── enum.ts
│ │ │ │ ├── module.ts
│ │ │ │ ├── service.ts
│ │ │ │ └── __tests__
│ │ │ │ ├── module.spec.ts
│ │ │ │ └── service.spec.ts
│ │ │ └── __tests__
│ │ │ └── module.spec.ts
│ │ ├── index.ts
│ │ ├── jest.config.js
│ │ ├── package.json
│ │ ├── redis
│ │ │ ├── adapter.ts
│ │ │ ├── module.ts
│ │ │ ├── service.ts
│ │ │ ├── __tests__
│ │ │ │ └── service.spec.ts
│ │ │ └── types.ts
│ │ ├── __tests__
│ │ │ └── module.spec.ts
│ │ ├── tests
│ │ │ └── initialization.js
│ │ └── tsconfig.json
│ └── utils
│ ├── documentation
│ │ ├── constants.ts
│ │ └── swagger.ts
│ ├── exception.ts
│ ├── filters
│ │ ├── http-exception.filter.ts
│ │ └── __tests__
│ │ └── http-exception.filter.spec.ts
│ ├── index.ts
│ ├── interceptors
│ │ ├── exception
│ │ │ ├── http-exception.interceptor.ts
│ │ │ └── __tests__
│ │ │ └── http-exception.interceptor.spec.ts
│ │ └── logger
│ │ ├── http-logger.interceptor.ts
│ │ ├── http-tracing.interceptor.ts
│ │ └── __tests__
│ │ └── http-logger.interceptor.spec.ts
│ ├── jest.config.js
│ ├── middleware
│ │ └── auth
│ │ ├── is-logged.middleware.ts
│ │ └── __tests__
│ │ └── is-logged.middleware.spec.ts
│ ├── package.json
│ ├── request.ts
│ ├── static
│ │ └── htttp-status.json
│ ├── __tests__
│ │ └── exception.spec.ts
│ ├── tests
│ │ ├── initialization.js
│ │ ├── mock-utils.ts
│ │ └── __tests__
│ │ └── mock-utils.spec.ts
│ └── tsconfig.json
├── nest-cli.json
├── package.json
├── README.md
├── tests
│ └── common-initialization.js
├── tools
│ └── eslint
│ └── package.json
├── tsconfig.build.json
├── tsconfig.json
└── update-version.sh
```
---
#### Architecture
[
](https://drive.google.com/file/d/1B8MS8jOJ5fuE_S6BTbDoWJTKgPdBE9m9/view?usp=sharing)
- `├── tools`: Project tools like: eslint, prettier and etc.
- `├── tests`: Monorepo tests initializer like: env, mocks and configs.
- `├── apps`: Monorepo Applications.
- `├── apps ├── auth-api `: Authentication api, use to getting token to navigate between other projects.
- `├── apps ├── cats-api `: Use this API like an example to create other APIs.
- `├── libs`: Application shared libs.
- `├── libs ├── core`: Core business rules, don't use nestjs dependecies here, only class and rules that will be shared with other projects
- `├── libs ├── modules`: Application modules, use only nestjs modules here, you can add modules like: http, databse etc.
- `├── libs ├── utils`: Application utils, utilities that will shared with your monorepo.
- `├── libs ├── modules ├── global ├── secrets`: Monorepo secrets.
---
The following is a list of all the people that have contributed Nestjs monorepo boilerplate. Thanks for your contributions!
[
](https://github.com/mikemajesty)
## License
It is available under the MIT license.
[License](https://opensource.org/licenses/mit-license.php)