The best practice of building Koa2 with TypeScript.
-
Run
npm init elc
-
Install dependencies:
yarn
-
fill out
.env.dev
, and runprisma db push
to synchronize the data model -
Start the server:
yarn dev
. visit: http://127.0.0.1:3001/api/user/list
src
├── app
│ ├── controllers --- server controllers
│ ├── helpers --- helper func (database / redis / interceptor / error handler / validator...)
│ ├── jobs --- task (periodic task / trigger task / email server...)
│ └── services --- adhesive controller and model
├── config
│ ├── constants --- environment variable
│ ├── koa.middlewares --- middlewares for Koa
│ ├── routing.middlewares --- middlewares for Routing Controller
│ ├── routing.options --- configs for Routing Controller
│ ├── bootstrap --- lifecycle
│ └── interceptors --- global interceptor
│ └── utils --- pure functions for help
└── test --- utils for testcase
├── .env --- environment file
-
Separation configuration and business logic.
-
Test cases and lint configuration.
-
The best practice for Dependency Injection in Koa project.
-
Get constraints on your data model with Prisma.
-
TypeScript hotload.
-
app.ts
-> collect env varsconstants
-> collect env filesvariables.env
-
envs ready, call
bootstrap.before()
-
lift
routing-controllers
-> lift Koa middlewares -> registerContainer
for DI -
start Koa & invoke
bootstrap.after()
after startup
The project uses Prisma as the intelligent ORM tool by default. Supports PostgreSQL
, MySQL
and SQLite
.
- You can change the data type and connection method in the
.env
file - After each modification to file
/prisma/schema.prisma
, you need to runprisma migrate dev
to migrate the database. - After each modification to file
/prisma/schema.prisma
, you need to runprisma generate
to sync types.
When nodejs is running, ENV
does not mean NODE_ENV
:
- After NodeJS project is built, we always run it as
NODE_ENV=PRODUCTION
, which may affect some framework optimizations. NODE_ENV
only identifies the NodeJS runtime, independent of the business.- You should use
ENV
to identify the environment.
For the data settings of each environment, you can refer to the following:
-
Development Mode (
ENV=development
): read configurations fromconfigs/constants/development.ts
file, but it will still be overwritten by.env
file. -
Production Mode (
ENV=production
): read configurations fromconfigs/constants/production.ts
file, but it will still be overwritten by.env
file.
This project is licensed under the MIT License. See the LICENSE file for more info.