achebrol / nx-nestjs-angular-graphql

Dockerized Nx application with NestJS and Angular which are connected via Graphql and NGRX

The repo provides:

• a preconfigured Nx application
• which uses NestJS and Angular
• has configured unit and e2e tests
• and is ready for CircleCI CI/CD integration

Docker

To run the application, please ensure that you have docker and docker-compose installed locally.

1. Then simply execute

   docker-compose up --build

2. Wait a bit until backend and frontend have been successfully compiled

3. Open http://localhost in a browser

4. Profit

Nx

Nx is backed with:

• Shared entity models to have consistency on frontend and backend

• RenovateBot to update dependencies
• ESLint to lint frontend and backend
• Prettier to format files on save
• Husky to format files on commit

NestJS

NestJS is backed with:

• express and helmet to handle requests
• TypeORM and MySQL to manage entities
• GraphQL and code first approach
• Unit tests via Jest with CircleCI

Angular

Angular is backed with:

• NGRX to store and select entities
• Apollo Angular to support GraphQL
• ngrx-entity-relationship to manage entities with their relationships
• Unit tests via jasmine and Karma with CircleCI and Puppeteer
• E2E tests via Protractor with CircleCI and Puppeteer
• ng-mocks to mock dependencies in tests

SSO

Keycloak is backed with:

• An app user with a username user and a password user
• A master user with a username admin and a password admin on http://localhost/auth/admin

Email Catcher

smtp4dev which can be accessed on http://localhost/tools/emails/

CircleCi

CircleCI is backed with:

• Checking lint on frontend
• Executing unit tests on frontend and collecting reports via junit.xml and lcov.info
• Executing E2E tests on frontend and collecting reports via junit.xml
• Building frontend

• Checking lint on backend
• Executing unit tests on backend and collecting reports via junit.xml and lcov.info
• Building backend