How to run

Everything except the mobile app is dockerized and can be started with a single command.

Prerequisites

Before starting the environment for the first time, generate the auth server signing certificates:

tools/generateAuthSigningCert.ps1

You will be prompted for a password that protects the generated certificates. The script writes the certificates and their passwords to .env.authserver-certs (used by Docker Compose) and updates src/authserver/appsettings.Local.json.

Re-run with -Force to regenerate existing certificates.

Start the environment

Run:

docker compose -f .\local_environment.dockercompose.yaml up

This will start:

• Database (PostgreSQL)
• Blob Storage (Azurite)
• Auth Server (OpenIddict)
• API
• Frontend (SPA)
• Converter service
• Initializer (seeds data)

Check Initialization

Check logs of the Initializer container to ensure data is ready: docker logs tbdanceInitializer

When you see "Data initialized", the application is ready to use.

Try to login

Once the environment is up, you can access the frontend at http://localhost:3000.

Test credentials:

• Login: testemail@email.com — Password: 1234 (full access: all groups and events)
• Login: testemail2@email.com — Password: 1234 (limited access: only the "Środy 18:00" group)

Get a token via REST (dev only)

In local development the auth server enables the OAuth2 password grant, so you can obtain a user token with a single REST call (no browser login). This is gated by AuthServer:AllowWeakPasswords=true and is never enabled outside development.

curl -k -X POST https://localhost:7259/connect/token \
  -d grant_type=password -d client_id=tbdancedancehttpclient \
  -d username=testemail@email.com -d password=1234 \
  -d "scope=openid profile tbdancedanceapi.read"

The response JSON contains access_token. Send it to the API as a bearer token: Authorization: Bearer <access_token>. A ready-to-run sample lives in src/backend/Application/httpRequests/token.http.

Mobile App

The mobile app is not included in the docker-compose environment. To run it, you need to open the solution in an IDE (like Rider or Visual Studio) and run the TB.DanceDance.Mobile project targeting your desired platform (Android, iOS, etc.).

Ensure the docker environment is running so the mobile app can connect to the API.