Announcements
How system administrators publish in-app announcements at /admin/announcements, who sees them, and how users dismiss them.
Audit log
How system administrators search platform-wide audit events, inspect event details, reveal restricted fields and export events as CSV under /admin/audit-log.
Announcements
How system administrators publish in-app announcements at /admin/announcements, who sees them, and how users dismiss them.
Audit log
How system administrators search platform-wide audit events, inspect event details, reveal restricted fields and export events as CSV under /admin/audit-log.
How system administrators configure the customer invoice platform fee, the inbound email domain and route distance services at /admin/settings, and how platform settings are stored.
Platform settings holds operable configuration that applies to the whole platform. The settings page is at /admin/settings, under Admin > Finance > Settings.
Settings are stored in the database, not in environment variables, so administrators can change them without a deployment. Secrets and deployment configuration still belong in environment variables.
Each setting is a row in the platform settings table of the better-supabase settings module, with a key, a JSON value, the update time and the user who changed it. Values are validated per key in application code and again by a JSON Schema check in the database, so a malformed value is refused either way. When a key has no row, the platform uses its built-in default.
| Key | Edited on | Default |
|---|---|---|
invoice_payment_fee | Platform settings, Customer invoice platform fee | 150 basis points (1.5%) |
email_inbound | Platform settings, Inbound email | Off (no domain) |
routing | Platform settings, Route distance | Off (no URLs) |
ai_agent_policy | AI settings, Policy tab | Agent ceiling, High threshold |
ai_runtime_defaults | AI settings, Policy tab | See AI settings |
Any signed-in user can read platform settings, because features such as invoice sending and chat need them at runtime. Writes are limited per key, as described under Permissions.
When an organization's customer pays an invoice online, the platform is the merchant of record. The fee is taken as the Stripe application fee on the destination charge before the funds are transferred to the organization.
Choose a Fee type:
Select Save. See Invoices and Stripe billing operations.
Inbound email sets the receiving domain configured in Resend, such as inbound.example.com. Employees forward receipts to their personal expenses+ address at this domain to create draft expense claims. Leave the field empty to turn receipt forwarding off.
Route distance takes a Geocoder URL for a Nominatim-compatible geocoder and a Router URL for an OSRM-compatible router. Together they calculate mileage distances for expense claims. Both must be full URLs; leave either empty to keep distance entry manual.
Every platform setting change is recorded in the audit log as a platform setting mutation.
| Key | Effect |
|---|---|
platform.billing.manage | Opens /admin/settings and writes invoice_payment_fee, email_inbound and routing. |
platform.aiModel.manage | Writes ai_agent_policy and ai_runtime_defaults. |
System Admin has both keys. System Support has neither.
Last updated on
Announcements
How system administrators publish in-app announcements at /admin/announcements, who sees them, and how users dismiss them.
Audit log
How system administrators search platform-wide audit events, inspect event details, reveal restricted fields and export events as CSV under /admin/audit-log.
