Repository files navigation

NestJS codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to theRealWorld API spec.

Clone the repository

git clone https://github.com/lujakob/nestjs-realworld-example-app.git

Switch to the repo folder

cd nestjs-realworld-example-app

Install dependencies

npm install

Copy config file and set JsonWebToken secret key

cp src/config.ts.example src/config.ts

The codebase contains examples of two different database abstractions, namelyTypeORM andPrisma.

The branchmaster implements TypeORM with a mySQL database.

The branchprisma implements Prisma with a mySQL database.

Create a new mysql database with the namenestjsrealworld
(or the name you specified in the ormconfig.json)

Copy TypeORM config example file for database settings

cp ormconfig.json.example

Set mysql database settings in ormconfig.json

{  "type": "mysql",  "host": "localhost",  "port": 3306,  "username": "your-mysql-username",  "password": "your-mysql-password",  "database": "nestjsrealworld",  "entities": ["src/**/**.entity{.ts,.js}"],  "synchronize": true}

Start local mysql server and create new database 'nestjsrealworld'

On application start, tables for all entities will be created.

To run the example with Prisma checkout branchprisma, remove the node_modules and runnpm install

Create a new mysql database with the namenestjsrealworld-prisma (or the name you specified inprisma/.env)

Copy prisma config example file for database settings

cp prisma/.env.example prisma/.env

Set mysql database settings in prisma/.env

DATABASE_URL="mysql://USER:PASSWORD@HOST:PORT/DATABASE"

To create all tables in the new database make the database migration from the prisma schema defined in prisma/schema.prisma

npx prisma migrate save --experimentalnpx prisma migrate up --experimental

Now generate the prisma client from the migrated database with the following command

npx prisma generate

The database tables are now set up and the prisma client is generated. For more information see the docs:

• https://www.prisma.io/docs/getting-started/setup-prisma/add-to-existing-project-typescript-mysql

• npm start - Start application
• npm run start:watch - Start application in watch mode
• npm run test - run Jest test runner
• npm run start:prod - Build application

This application adheres to the api specifications set by theThinkster team. This helps mix and match any backend with any other frontend without conflicts.

Full API Spec

More information regarding the project can be found herehttps://github.com/gothinkster/realworld

• npm start
• Test api withhttp://localhost:3000/api/articles in your favourite browser

This applications uses JSON Web Token (JWT) to handle authentication. The token is passed with each request using theAuthorization header withToken scheme. The JWT authentication middleware handles the validation and authentication of the token. Please check the following sources to learn more about JWT.

This example repo uses the NestJS swagger module for API documentation.NestJS Swagger -www.swagger.io