Skip to content
Michael Yali edited this page Apr 18, 2020 · 9 revisions

Why?

NestJS is probably one of the best things that happened to Node.js community a couple of years ago. It was a missing part that provides a truly important architectural solution for a wide range of backend development aspects. But, despite the fact that it allows creating RESTful applications efficiently, an important CRUD scaffolding functionality that is present in many other HTTP frameworks was missing. That's why Nestjsx/crud came out. And we hope you'll find it very useful.

Structure

The project follows monorepository structural practice and contains several packages:

  • @nestjsx/crud - core package which provides @Crud() decorator for endpoints generation, global configuration, validation, helper decorators (docs)
  • @nestjsx/crud-typeorm - TypeORM package which provides base TypeOrmCrudService with methods for CRUD database operations for relational databases (docs)
  • @nestjsx/crud-request - request builder/parser package wich provides RequestQueryBuilder class for a frontend usage and RequestQueryParser that is being used internaly for handling and validating query/path params on a backend side (docs)

Cloning and running tests

  1. Clone this repository.

  2. Run preparational scripts:

docker-compose up -d
yarn bootstrap
yarn build
yarn test

Running an example project

  1. Clone and prepare an example project.

  2. Start a project:

yarn db:prepare:typeorm
yarn start:typeorm
  1. Use http://localhost:3000/docs to try it out.

  2. the code of example projects can be found under integration folder.