Local development

Summarized from LOCAL-DEV.md. Requires Docker Desktop and the TenancyEngine stack.

Quick start

1. Start the platform stack per TenancyEngine local development.
2. Start TenaBill API + web from the tenabill repo (docker compose up -d, then run API and TenaBill.Web).
3. Open the merchant console at https://console-dev.tenabill.com (tunnel) or the configured local URL in your appsettings.Development.json.

OIDC merchant console

Merchant operators sign in through SaaSRuntime (tenabill-merchant-console OIDC client). Tokens include merchant_slug from TenancyEngine identity claims.

Claim	TenaBill behavior
merchant_slug	Resolve active merchant by slug (required)
merchant_id	Passed through when present

Dev seed: merchant@demo.tenabill.local / ChangeMe!Dev123 with merchant_slug=tenancyengine-platform.

Dev URLs

Service	URL
TenaBill API	https://api-dev.tenabill.com
Merchant console	https://console-dev.tenabill.com
Customer portal	https://portal-dev.tenabill.com
Hosted pay	https://pay-dev.tenabill.com
SaaSRuntime (OIDC)	https://auth-dev.saasruntime.com
Mailpit	http://127.0.0.1:18025

Contextual help in dev

Run this docs site locally so console ? icons and the help drawer resolve:

cd D:\repos\tenabill\docs
npm install
npm run dev

Dev docs base URL: http://localhost:5174.