Feature flags
Entitlements and staged rollouts for portal capabilities.
Overview
Feature delivery combines:
- Tenant entitlements — JSON on
Tenant.entitlements(module toggles). - Plan tier —
Tenant.planTier/ Clerk orgpublicMetadata.plan_tier(Core, Standard, Pro). - Application flags — environment variables consumed by Next.js.
Runbook: docs/TENANT_ENTITLEMENTS.md.
Entitlements JSON
null entitlements means all modules on for backward compatibility. When present, keys gate UI routes:
| Key | Module |
|---|---|
guestPasses | Guest pass creation (Standard+) |
deliveryScan | Delivery scan features |
rolodex | Contact rolodex |
notificationTemplates | Custom notification templates |
documents | Document portal |
maintenance | Maintenance requests |
Plan tier gates
Standard and Pro tiers unlock additional modules per Billing architecture. Evaluate tier server-side when the decision affects security.
Testing
Maintain a staging tenant with constrained entitlements to validate degraded experiences before customer launches.
Last verified: 2026-06-21 (commit 293c4a7)