ASP.NET Core 7.0 codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.

This codebase was created to demonstrate a fully fledged fullstack application built with last ASP.NET Core 6.0 (with Feature orientation) including CRUD operations, authentication, routing, pagination, and more.

We've gone to great lengths to adhere to the ASP.NET Core community styleguides & best practices.

For more information on how to this works with other frontends/backends, head over to the RealWorld repo.

See my works for my personal Backend & Frontend RealWorld apps collection.

This project use PostgreSQL as main database provider. You can run it easily via docker-compose up -d.

Two databases will spin up, one for normal development and one dedicated for integrations tests. Indeed In-Memory testing are poorly suitable for real integrations tests for me. See Avoid In-Memory Databases for Tests.

make seed # migrate and fill db with fake data
make run

And that's all, go to http://localhost:5000/swagger

Launch follow scripts for validating realworld schema :

make fresh # wipe all database for clean state
make run
npx newman run postman.json --global-var "APIURL=http://localhost:5000/api" --global-var="USERNAME=johndoe" --global-var="[email protected]" --global-var="PASSWORD=password"

This project is fully tested via xUnit, just run make test for launching it. All SQL queries are automatically showed up for easy debug and easy N+1 detection and coverage rapport will be generated. Use dotnet reportgenerator in order to generate HTML rapport.

Use make test-watch-app for realtime test watching, perfect for TDD.

Use make publish for publishing the app. Be sure to have PostgreSQL running before. This will execute all pipeline with code format checking, building, testing then publishing under publish directory.

The local Dockerfile is suitable as production container.