ASP.NET Core 8 backend for the SimPle multiplayer game platform.

• ASP.NET Core 8 — Web API
• PostgreSQL + EF Core 8 — database and migrations
• Argon2id — password hashing
• JWT (HS256, 15-min access) + rotating refresh tokens (SHA-256 hashed, 7-day)
• Google reCAPTCHA v2 — server-side verification
• Google Identity Services — OAuth ID token flow
• MailKit — SMTP email delivery
• FluentValidation — request validation
• xUnit + NSubstitute — unit and integration tests

1. Copy .env from the example and fill in credentials:

   cp src/SimPle.Api/.env.example src/SimPle.Api/.env
   

2. Or run the setup script (creates a random-key .env automatically):

   .\scripts\Initialize-AuthEnvironment.ps1

3. Start PostgreSQL:

   docker compose -f compose.auth.yml up -d
   

4. Start local MinIO for profile avatar/banner uploads:

   docker compose -f compose.storage.yml up -d

   MinIO API: http://localhost:9000; console: http://localhost:9001; bucket: simple-profile-assets-dev.
5. If browser direct uploads are blocked by CORS, configure local MinIO CORS:

   mc alias set local http://localhost:9000 simpleadmin simpleadmin123
   mc cors set local/simple-profile-assets-dev cors.local.json
   mc cors info local/simple-profile-assets-dev

6. Apply migrations:

   dotnet ef database update --project src/SimPle.Infrastructure --startup-project src/SimPle.Api
   

7. Run the API:

   dotnet run --project src/SimPle.Api
   

   Swagger is available at https://localhost:5147/swagger.

dotnet test

373 tests total: 217 unit tests, 156 integration tests.

GitHub Actions runs on every push to main and feature/**: build → unit tests → integration tests → NuGet vulnerability scan.