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.lab.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.lab.tenabill.com
Merchant console	https://console.lab.tenabill.com
Customer portal	https://portal-demo.lab.tenabill.com (per-merchant portal-{slug}; the bare apex needs ?merchant={slug})
Hosted pay	https://pay.lab.tenabill.com
SaaSRuntime (OIDC)	https://auth.lab.saasruntime.com
Mailpit	http://127.0.0.1:18025

Lane labels: lab. = local ORION dev lane, stage. = METEOR staging lane, none = production; dev./staging. labels denote the ISV app environment, not the platform lane.

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.