@quickback-dev/cli 0.72.8 → 0.72.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (240) hide show
  1. package/dist/commands/build.d.ts.map +1 -1
  2. package/dist/commands/build.js +8 -1
  3. package/dist/commands/build.js.map +1 -1
  4. package/dist/commands/db-explain.d.ts +67 -0
  5. package/dist/commands/db-explain.d.ts.map +1 -0
  6. package/dist/commands/db-explain.js +141 -0
  7. package/dist/commands/db-explain.js.map +1 -0
  8. package/dist/commands/db-export.d.ts +34 -0
  9. package/dist/commands/db-export.d.ts.map +1 -0
  10. package/dist/commands/db-export.js +250 -0
  11. package/dist/commands/db-export.js.map +1 -0
  12. package/dist/commands/db-insights.d.ts +60 -0
  13. package/dist/commands/db-insights.d.ts.map +1 -0
  14. package/dist/commands/db-insights.js +106 -0
  15. package/dist/commands/db-insights.js.map +1 -0
  16. package/dist/commands/db-recovery.d.ts +98 -0
  17. package/dist/commands/db-recovery.d.ts.map +1 -0
  18. package/dist/commands/db-recovery.js +558 -0
  19. package/dist/commands/db-recovery.js.map +1 -0
  20. package/dist/commands/db-target.d.ts +27 -0
  21. package/dist/commands/db-target.d.ts.map +1 -0
  22. package/dist/commands/db-target.js +83 -0
  23. package/dist/commands/db-target.js.map +1 -0
  24. package/dist/commands/db.d.ts +3 -0
  25. package/dist/commands/db.d.ts.map +1 -0
  26. package/dist/commands/db.js +43 -0
  27. package/dist/commands/db.js.map +1 -0
  28. package/dist/commands/effects.d.ts +8 -0
  29. package/dist/commands/effects.d.ts.map +1 -0
  30. package/dist/commands/effects.js +48 -0
  31. package/dist/commands/effects.js.map +1 -0
  32. package/dist/commands/platform-budget.d.ts +143 -0
  33. package/dist/commands/platform-budget.d.ts.map +1 -0
  34. package/dist/commands/platform-budget.js +619 -0
  35. package/dist/commands/platform-budget.js.map +1 -0
  36. package/dist/commands/preview.d.ts +57 -0
  37. package/dist/commands/preview.d.ts.map +1 -0
  38. package/dist/commands/preview.js +268 -0
  39. package/dist/commands/preview.js.map +1 -0
  40. package/dist/commands/search.d.ts +20 -0
  41. package/dist/commands/search.d.ts.map +1 -0
  42. package/dist/commands/search.js +133 -0
  43. package/dist/commands/search.js.map +1 -0
  44. package/dist/index.js +35 -1
  45. package/dist/index.js.map +1 -1
  46. package/dist/lib/api-client.d.ts +4 -0
  47. package/dist/lib/api-client.d.ts.map +1 -1
  48. package/dist/lib/api-client.js.map +1 -1
  49. package/dist/lib/cloudflare-spend-policies.d.ts +92 -0
  50. package/dist/lib/cloudflare-spend-policies.d.ts.map +1 -0
  51. package/dist/lib/cloudflare-spend-policies.js +289 -0
  52. package/dist/lib/cloudflare-spend-policies.js.map +1 -0
  53. package/dist/lib/compiler-stubs.d.ts +2 -0
  54. package/dist/lib/compiler-stubs.d.ts.map +1 -1
  55. package/dist/lib/compiler-stubs.js +2 -0
  56. package/dist/lib/compiler-stubs.js.map +1 -1
  57. package/dist/lib/d1-fingerprint.d.ts +8 -0
  58. package/dist/lib/d1-fingerprint.d.ts.map +1 -0
  59. package/dist/lib/d1-fingerprint.js +113 -0
  60. package/dist/lib/d1-fingerprint.js.map +1 -0
  61. package/dist/lib/file-loader.d.ts +12 -0
  62. package/dist/lib/file-loader.d.ts.map +1 -1
  63. package/dist/lib/file-loader.js +27 -1
  64. package/dist/lib/file-loader.js.map +1 -1
  65. package/dist/lib/migrations/plan.js +3 -0
  66. package/dist/lib/migrations/plan.js.map +1 -1
  67. package/dist/lib/migrations/postprocessors/index.d.ts +6 -5
  68. package/dist/lib/migrations/postprocessors/index.d.ts.map +1 -1
  69. package/dist/lib/migrations/postprocessors/index.js +24 -12
  70. package/dist/lib/migrations/postprocessors/index.js.map +1 -1
  71. package/dist/lib/migrations/postprocessors/search.d.ts +49 -0
  72. package/dist/lib/migrations/postprocessors/search.d.ts.map +1 -0
  73. package/dist/lib/migrations/postprocessors/search.js +160 -0
  74. package/dist/lib/migrations/postprocessors/search.js.map +1 -0
  75. package/dist/lib/migrations/prior-state.d.ts +7 -0
  76. package/dist/lib/migrations/prior-state.d.ts.map +1 -1
  77. package/dist/lib/migrations/prior-state.js +3 -0
  78. package/dist/lib/migrations/prior-state.js.map +1 -1
  79. package/dist/lib/migrations/types.d.ts +1 -1
  80. package/dist/lib/migrations/types.d.ts.map +1 -1
  81. package/dist/lib/migrations/types.js +1 -0
  82. package/dist/lib/migrations/types.js.map +1 -1
  83. package/dist/lib/preview-lifecycle.d.ts +139 -0
  84. package/dist/lib/preview-lifecycle.d.ts.map +1 -0
  85. package/dist/lib/preview-lifecycle.js +429 -0
  86. package/dist/lib/preview-lifecycle.js.map +1 -0
  87. package/dist/lib/preview.d.ts +146 -0
  88. package/dist/lib/preview.d.ts.map +1 -0
  89. package/dist/lib/preview.js +417 -0
  90. package/dist/lib/preview.js.map +1 -0
  91. package/dist/lib/wrangler-resources.d.ts.map +1 -1
  92. package/dist/lib/wrangler-resources.js +4 -2
  93. package/dist/lib/wrangler-resources.js.map +1 -1
  94. package/dist/skill/SKILL.md +9 -3
  95. package/dist/skill/agents/quickback-specialist/AGENT.md +9 -11
  96. package/dist/skill/docs/api/batch-operations.md +19 -0
  97. package/dist/skill/docs/api/caching.md +17 -0
  98. package/dist/skill/docs/api/crud.md +9 -0
  99. package/dist/skill/docs/api/errors.md +31 -2
  100. package/dist/skill/docs/api/query-params.md +6 -0
  101. package/dist/skill/docs/changelog/index.md +1 -0
  102. package/dist/skill/docs/configure/agents.md +1 -1
  103. package/dist/skill/docs/configure/bindings.md +177 -1
  104. package/dist/skill/docs/configure/cloudflare-access.md +43 -0
  105. package/dist/skill/docs/configure/domains.md +2 -2
  106. package/dist/skill/docs/configure/index.md +2 -2
  107. package/dist/skill/docs/configure/providers.md +5 -0
  108. package/dist/skill/docs/configure/single-tenant.md +1 -0
  109. package/dist/skill/docs/configure/tenant-databases.md +627 -14
  110. package/dist/skill/docs/define/access.md +26 -0
  111. package/dist/skill/docs/define/actions/defining.md +7 -1
  112. package/dist/skill/docs/define/actions/index.md +5 -0
  113. package/dist/skill/docs/define/actions/scoped-db.md +127 -1
  114. package/dist/skill/docs/define/authoring-basics.md +92 -0
  115. package/dist/skill/docs/define/changesets.md +8 -0
  116. package/dist/skill/docs/define/encryption.md +48 -2
  117. package/dist/skill/docs/define/feature.md +17 -2
  118. package/dist/skill/docs/define/guards.md +11 -3
  119. package/dist/skill/docs/define/index.md +1 -1
  120. package/dist/skill/docs/define/invariants.md +321 -0
  121. package/dist/skill/docs/define/issue-tracker-example.md +225 -0
  122. package/dist/skill/docs/define/masking.md +3 -3
  123. package/dist/skill/docs/define/rate-limit.md +63 -22
  124. package/dist/skill/docs/define/read.md +332 -5
  125. package/dist/skill/docs/define/relationships.md +10 -0
  126. package/dist/skill/docs/define/schema.md +137 -10
  127. package/dist/skill/docs/define/scopes.md +1 -0
  128. package/dist/skill/docs/define/transitions.md +9 -0
  129. package/dist/skill/docs/define/triggers.md +127 -1
  130. package/dist/skill/docs/platform/api-contract/index.md +35 -4
  131. package/dist/skill/docs/platform/auth/api-keys.md +26 -3
  132. package/dist/skill/docs/platform/auth/index.md +5 -2
  133. package/dist/skill/docs/platform/auth/plugins/index.md +1 -1
  134. package/dist/skill/docs/platform/auth/plugins/organization-defaults.md +37 -0
  135. package/dist/skill/docs/platform/auth/using-auth.md +2 -0
  136. package/dist/skill/docs/platform/database/d1.md +73 -1
  137. package/dist/skill/docs/platform/database/durable-effects.md +224 -0
  138. package/dist/skill/docs/platform/database/read-replication.md +9 -0
  139. package/dist/skill/docs/platform/database/recovery.md +292 -0
  140. package/dist/skill/docs/platform/database/using-d1.md +152 -2
  141. package/dist/skill/docs/platform/index.md +1 -0
  142. package/dist/skill/docs/platform/operations/budgets.md +224 -0
  143. package/dist/skill/docs/platform/queues/handlers.md +1 -0
  144. package/dist/skill/docs/platform/queues/index.md +18 -0
  145. package/dist/skill/docs/platform/realtime/table-changes.md +1 -0
  146. package/dist/skill/docs/platform/storage/using-r2.md +13 -0
  147. package/dist/skill/docs/platform/vector/embeddings.md +28 -4
  148. package/dist/skill/docs/platform/vector/using-embeddings.md +17 -0
  149. package/dist/skill/docs/platform/workflows/index.md +385 -0
  150. package/dist/skill/docs/start/deploy-browser.md +51 -0
  151. package/dist/skill/docs/start/deploy.md +97 -1
  152. package/dist/skill/docs/tooling/cli.md +117 -0
  153. package/dist/skill/docs/tooling/cloud-compiler/index.md +15 -0
  154. package/dist/skill/docs/ui/account/customization.md +6 -2
  155. package/dist/skill/docs/ui/account/environment-variables.md +7 -1
  156. package/dist/skill/docs/ui/account/features/admin.md +2 -2
  157. package/dist/skill/docs/ui/account/features/api-keys.md +1 -1
  158. package/dist/skill/docs/ui/account/features/index.md +10 -8
  159. package/dist/skill/docs/ui/account/features/organizations.md +19 -9
  160. package/dist/skill/docs/ui/account/features/passkeys.md +6 -2
  161. package/dist/skill/docs/ui/account/features/sessions.md +2 -2
  162. package/dist/skill/docs/ui/account/index.md +61 -30
  163. package/dist/skill/docs/ui/account/with-quickback.md +1 -1
  164. package/dist/skill/docs/ui/admin/connecting.md +1 -1
  165. package/dist/skill/docs/ui/admin/index.md +1 -1
  166. package/dist/skill/docs/ui/admin/record-layouts.md +3 -3
  167. package/package.json +1 -1
  168. package/src/skill/SKILL.md +9 -3
  169. package/src/skill/agents/quickback-specialist/AGENT.md +9 -11
  170. package/src/skill/docs/api/batch-operations.md +19 -0
  171. package/src/skill/docs/api/caching.md +17 -0
  172. package/src/skill/docs/api/crud.md +9 -0
  173. package/src/skill/docs/api/errors.md +31 -2
  174. package/src/skill/docs/api/query-params.md +6 -0
  175. package/src/skill/docs/changelog/index.md +1 -0
  176. package/src/skill/docs/configure/agents.md +1 -1
  177. package/src/skill/docs/configure/bindings.md +177 -1
  178. package/src/skill/docs/configure/cloudflare-access.md +43 -0
  179. package/src/skill/docs/configure/domains.md +2 -2
  180. package/src/skill/docs/configure/index.md +2 -2
  181. package/src/skill/docs/configure/providers.md +5 -0
  182. package/src/skill/docs/configure/single-tenant.md +1 -0
  183. package/src/skill/docs/configure/tenant-databases.md +627 -14
  184. package/src/skill/docs/define/access.md +26 -0
  185. package/src/skill/docs/define/actions/defining.md +7 -1
  186. package/src/skill/docs/define/actions/index.md +5 -0
  187. package/src/skill/docs/define/actions/scoped-db.md +127 -1
  188. package/src/skill/docs/define/authoring-basics.md +92 -0
  189. package/src/skill/docs/define/changesets.md +8 -0
  190. package/src/skill/docs/define/encryption.md +48 -2
  191. package/src/skill/docs/define/feature.md +17 -2
  192. package/src/skill/docs/define/guards.md +11 -3
  193. package/src/skill/docs/define/index.md +1 -1
  194. package/src/skill/docs/define/invariants.md +321 -0
  195. package/src/skill/docs/define/issue-tracker-example.md +225 -0
  196. package/src/skill/docs/define/masking.md +3 -3
  197. package/src/skill/docs/define/rate-limit.md +63 -22
  198. package/src/skill/docs/define/read.md +332 -5
  199. package/src/skill/docs/define/relationships.md +10 -0
  200. package/src/skill/docs/define/schema.md +137 -10
  201. package/src/skill/docs/define/scopes.md +1 -0
  202. package/src/skill/docs/define/transitions.md +9 -0
  203. package/src/skill/docs/define/triggers.md +127 -1
  204. package/src/skill/docs/platform/api-contract/index.md +35 -4
  205. package/src/skill/docs/platform/auth/api-keys.md +26 -3
  206. package/src/skill/docs/platform/auth/index.md +5 -2
  207. package/src/skill/docs/platform/auth/plugins/index.md +1 -1
  208. package/src/skill/docs/platform/auth/plugins/organization-defaults.md +37 -0
  209. package/src/skill/docs/platform/auth/using-auth.md +2 -0
  210. package/src/skill/docs/platform/database/d1.md +73 -1
  211. package/src/skill/docs/platform/database/durable-effects.md +224 -0
  212. package/src/skill/docs/platform/database/read-replication.md +9 -0
  213. package/src/skill/docs/platform/database/recovery.md +292 -0
  214. package/src/skill/docs/platform/database/using-d1.md +152 -2
  215. package/src/skill/docs/platform/index.md +1 -0
  216. package/src/skill/docs/platform/operations/budgets.md +224 -0
  217. package/src/skill/docs/platform/queues/handlers.md +1 -0
  218. package/src/skill/docs/platform/queues/index.md +18 -0
  219. package/src/skill/docs/platform/realtime/table-changes.md +1 -0
  220. package/src/skill/docs/platform/storage/using-r2.md +13 -0
  221. package/src/skill/docs/platform/vector/embeddings.md +28 -4
  222. package/src/skill/docs/platform/vector/using-embeddings.md +17 -0
  223. package/src/skill/docs/platform/workflows/index.md +385 -0
  224. package/src/skill/docs/start/deploy-browser.md +51 -0
  225. package/src/skill/docs/start/deploy.md +97 -1
  226. package/src/skill/docs/tooling/cli.md +117 -0
  227. package/src/skill/docs/tooling/cloud-compiler/index.md +15 -0
  228. package/src/skill/docs/ui/account/customization.md +6 -2
  229. package/src/skill/docs/ui/account/environment-variables.md +7 -1
  230. package/src/skill/docs/ui/account/features/admin.md +2 -2
  231. package/src/skill/docs/ui/account/features/api-keys.md +1 -1
  232. package/src/skill/docs/ui/account/features/index.md +10 -8
  233. package/src/skill/docs/ui/account/features/organizations.md +19 -9
  234. package/src/skill/docs/ui/account/features/passkeys.md +6 -2
  235. package/src/skill/docs/ui/account/features/sessions.md +2 -2
  236. package/src/skill/docs/ui/account/index.md +61 -30
  237. package/src/skill/docs/ui/account/with-quickback.md +1 -1
  238. package/src/skill/docs/ui/admin/connecting.md +1 -1
  239. package/src/skill/docs/ui/admin/index.md +1 -1
  240. package/src/skill/docs/ui/admin/record-layouts.md +3 -3
@@ -355,6 +355,27 @@ also writes `.dev.vars.example` with every declared secret, for local
355
355
  `wrangler dev`. Neon and PlanetScale keep their own template, and any declared
356
356
  secret it lacks is appended to it.
357
357
 
358
+ ### Manage Account Spend Policies
359
+
360
+ ```bash
361
+ quickback platform budget status --account <account-id>
362
+ quickback platform budget plan budget.json --out budget-plan.json --account <account-id>
363
+ quickback platform budget apply budget-plan.json --confirm <digest> --account <account-id>
364
+ quickback platform budget history --account <account-id> [--policy <id>]
365
+ quickback platform budget rollback-plan budget-plan.json --out rollback.json --account <account-id>
366
+ ```
367
+
368
+ These commands manage Cloudflare spending alerts and spending limits for
369
+ Workers and Durable Objects across a whole account, using the official `cf`
370
+ CLI. They are account-level platform controls. They are not per-tenant quotas
371
+ and they do not cap an invoice. Every command needs `--account <id>` or
372
+ `--env <target>`, where the target's `accountId` comes from
373
+ `quickback.config.ts`. The account is printed first, and each `cf` call is
374
+ pinned to it. `plan`, `status`, `history` and `rollback-plan` are read-only.
375
+ `apply` runs only a reviewed plan file and requires its `--confirm` digest.
376
+ `quickback build` and `quickback deploy` never change account policies. See
377
+ [Account spend policies](/platform/operations/budgets).
378
+
358
379
  ### Compact D1 Schema Migrations
359
380
 
360
381
  ```bash
@@ -393,6 +414,26 @@ The route path and each target's API hostname come from
393
414
  `reports/ops.manifest.json`. The command needs no database credentials. The
394
415
  first failure stops the run and exits `1`.
395
416
 
417
+ ### Check and Rebuild Search Indexes
418
+
419
+ ```bash
420
+ quickback search status --env production
421
+ quickback search rebuild --env production # prints the plan
422
+ quickback search rebuild --env production --apply --generation __qb_fts_articles_1a2b3c4d
423
+ ```
424
+
425
+ Operates on the [`read.search`](/define/read#full-text-search-readsearch)
426
+ FTS5 indexes in the target's features D1, as owned by the newest
427
+ `*_quickback_search_*.sql` migration. `status` runs FTS5 `'integrity-check'`
428
+ per index and exits 1 when an index is missing (search migration not applied)
429
+ or out of sync with its table. `rebuild` re-derives the index from the table
430
+ and verifies it; it is a dry run unless `--apply --generation <name>` names the
431
+ generation shown in the plan. No query text is accepted — the statements are
432
+ fixed — and it runs through `wrangler d1 execute` with your Cloudflare
433
+ credentials (`--database` defaults to `DB`, `--local` targets local D1).
434
+ Tenant-object indexes are rebuilt automatically on wake after a migration or
435
+ dump restore.
436
+
396
437
  ### View Documentation
397
438
 
398
439
  ```bash
@@ -666,6 +707,24 @@ not overwrite global IDs for named targets. Postgres migrations and remote
666
707
  Hyperdrive cache/target verification remain operator-owned. See
667
708
  [Deploying](/start/deploy#named-deployment-targets).
668
709
 
710
+ ### Preview environments
711
+
712
+ ```bash
713
+ quickback preview plan --name pr-123 [--env <target>] [--json]
714
+ quickback preview up --name pr-123 [--env <target>] [--ttl <hours>] [--seed <file>]
715
+ quickback preview status [--name pr-123] [--json]
716
+ quickback preview down --name pr-123 [--apply]
717
+ quickback preview gc [--apply] [--limit <n>]
718
+ ```
719
+
720
+ Creates a temporary preview with its own Worker, D1, KV and R2 resources. It
721
+ uses the selected target as a template, applies a synthetic seed and expires.
722
+ `plan` is read-only. `down` and `gc` only review until you pass `--apply`.
723
+ Teardown deletes only resources recorded in
724
+ `.quickback/previews/<name>/ledger.json`, re-verifying each before deleting it.
725
+ Unsupported resource graphs are refused before any account call. See
726
+ [Ephemeral previews](/start/deploy#ephemeral-previews).
727
+
669
728
  ### Verify Neon migrations
670
729
 
671
730
  ```bash
@@ -681,3 +740,61 @@ role. Local migration inventory changes abort parent apply. See
681
740
  [Neon canaries](/platform/database/neon#required-migration-canaries) for role
682
741
  selection, inventory-check limits and cleanup behavior. `quickback migrate`
683
742
  continues to mean authored-source codemods, not database migration execution.
743
+
744
+
745
+ ## D1 diagnostics
746
+
747
+ Read-only D1 tools. Both need `reports/d1-query-catalog.json`, which a build emits when
748
+ [`diagnostics`](/platform/database/using-d1#sampled-query-diagnostics) is set
749
+ (`sampleRate: 0` keeps runtime sampling off).
750
+
751
+ ```bash
752
+ quickback db explain --fingerprint '<fingerprint>' [--input params.json] --binding DB [--local | --remote [--env <target>]] [--json]
753
+ quickback db insights --binding DB --env <target> [--window 24h] [--sort reads|writes|time|count] [--aggregate sum|avg] [--limit 20] [--json]
754
+ quickback db insights --env <target> --account <id> --all-databases [--json]
755
+ ```
756
+
757
+ - **`db explain`** runs one `EXPLAIN QUERY PLAN` for a fingerprint copied from a
758
+ `D1_QUERY` event or `db insights`. It is local by default, and remote only with
759
+ `--remote`. A project with named environments must also pass `--env <target>`. It accepts only canonical read-only `SELECT` fingerprints over
760
+ catalog names. `--input` is a JSON array of synthetic primitive parameters,
761
+ encoded as SQLite literals. The output shows indexes used, full scans and
762
+ temp-B-tree sorts as advice. Nothing is applied.
763
+ - **`db insights`** reads remote Query Insights through your installed
764
+ Wrangler 4.x, with the query strings redacted to fingerprints. Unknown
765
+ bindings never widen to account-wide analytics. Output is top-N adaptive
766
+ analytics, not a billing total.
767
+
768
+ Neither command runs business SQL, changes indexes or installs dependencies.
769
+ Unsupported Wrangler output and failed commands report an error code without
770
+ echoing raw output. See [Explain and Query Insights](/platform/database/using-d1#explain-and-query-insights).
771
+
772
+ ## D1 recovery and exports
773
+
774
+ Fenced restores need [`recovery`](/platform/database/recovery) compiled in and
775
+ deployed. The operator key comes from the environment variable named by
776
+ `recovery.operatorKey.env` (default `QB_RECOVERY_OPERATOR_KEY`), never from a
777
+ plan file. Each database is an independent restore point.
778
+
779
+ ```bash
780
+ quickback db checkpoint --env <target> --binding DB [--binding AUTH_DB] [--out checkpoint.json]
781
+ quickback db restore-plan --env <target> --url <origin> --binding DB (--timestamp <RFC3339> | --checkpoint checkpoint.json) --out restore.json [--writers-stopped <name,...>] [--reissue-pending]
782
+ quickback db restore-apply restore.json --confirm <plan-digest> [--retry-unknown] [--drain-timeout 120] [--acknowledge-failures]
783
+ quickback db restore-status --operation <id> --url <origin>
784
+ quickback db restore-verify restore.json
785
+ quickback db restore-resume --operation <id> --plan restore.json --confirm <resume-digest>
786
+ quickback db restore-undo-plan --operation <id> --plan restore.json --out undo.json
787
+ quickback db export-plan --env <target> --binding DB --format d1|sqlite3_cli_only --directory <absolute path outside git> --out export.json [--table <name>]
788
+ quickback db export-apply export.json --confirm <digest> [--restart]
789
+ quickback db export-status export.json
790
+ quickback db export-verify <receipt.json>
791
+ quickback effects state|list|replay|resolve|reconcile --url <origin> …
792
+ ```
793
+
794
+ - **Planning is read-only.** A plan records target identity, bookmarks, the migration manifest, the control generations, the recovery hooks and the declared stopped writers. Plan files are never overwritten.
795
+ - **Destructive steps need the exact digest.** `restore-apply` reruns resume from the recorded stage. The fence stays held on every failure.
796
+ - **Reopening needs a fresh verification digest.** Only `restore-resume` reopens, and only with that digest.
797
+ - **Exports are protected.** They land only in a real directory outside every Git worktree. Their receipts carry hashes, never data.
798
+
799
+ Wrangler output, SQL and signed URLs are never echoed. See
800
+ [D1 recovery](/platform/database/recovery).
@@ -51,6 +51,21 @@ without changing their definitions or generated output.
51
51
 
52
52
  ## Processing, analytics, and AI use
53
53
 
54
+ Validation requests (`/compile?complete=false`), including Start's definition
55
+ feedback loop, run in a private edge Worker behind the hosted compiler's normal
56
+ authentication and admission checks. The edge Worker has no public workers.dev
57
+ or preview URL. Compiler implementation code stays server-side; callers receive
58
+ generated application files and diagnostics.
59
+
60
+ Complete backend builds continue to use the container pool. If the edge validator
61
+ fails or does not respond within 60 seconds, the proxy falls back to a container.
62
+ The edge Worker has a 60-second CPU limit;
63
+ edge and fallback share a 110-second response budget so Start can return a
64
+ retryable error before its two-minute client timeout.
65
+ Normal validation errors are returned directly so the caller can correct the
66
+ definitions. Moving validation to the edge does not make complete builds
67
+ unlimited or change their authentication requirements.
68
+
54
69
  - Compile payloads are processed for the request. Full compiles use a
55
70
  per-request temporary work directory that is deleted in a `finally` cleanup
56
71
  on success or failure; validation compiles run in memory.
@@ -93,7 +93,7 @@ setAppConfig({
93
93
  | `privacy` | "Privacy Policy" | Footer link text |
94
94
  | `support` | "Contact Support" | Footer link text |
95
95
  | `company` | (from `VITE_COMPANY_NAME`) | Footer company name |
96
- | `organizations` | "Organizations" | Navigation and page titles. Profile and the user menu prefix this as **Manage …** (`Manage Organizations`). |
96
+ | `organizations` | "Organizations" | Navigation, the switcher, and Home. The singular form (trailing `s` dropped) labels **New …** and **… settings**, so `"Workspaces"` gives **New workspace**. |
97
97
 
98
98
  ## Custom Messages
99
99
 
@@ -153,7 +153,7 @@ setAppConfig({
153
153
  welcome: '/getting-started',
154
154
  },
155
155
  authenticated: {
156
- dashboard: '/dashboard',
156
+ home: '/home',
157
157
  profile: '/my-account',
158
158
  settings: '/preferences',
159
159
  },
@@ -364,3 +364,7 @@ import './custom-styles.css'; // Your overrides
364
364
  - **[With Quickback](/ui/account/with-quickback)** - How the compiler builds and bundles your customized UI
365
365
  - **[Environment Variables](/ui/account/environment-variables)** - Complete configuration reference
366
366
  - **[Feature Flags](/ui/account/features)** - Enable/disable features
367
+
368
+ ### Compiler-managed logo and favicon
369
+
370
+ For generated applications, set `account.logoUrl` and `account.faviconUrl` in `quickback.config.ts`. These reach the generic Account bundle through runtime configuration, so no edits to generated JavaScript or per-customer SPA rebuild are required. Use same-origin public asset paths or trusted HTTPS image URLs. `account.logoUrl: ''` hides the logo. The source-level `setAppConfig` customization above remains available for a separately maintained Account app.
@@ -149,6 +149,7 @@ Enable or disable features using boolean environment variables. **Every flag car
149
149
  |---|---|---|
150
150
  | `VITE_ENABLE_ORGANIZATIONS` | `organizations` | `false` |
151
151
  | `VITE_ENABLE_ORG_TEAMS` | `orgTeams` | `false` |
152
+ | `VITE_ENABLE_ORG_CREATION` | `orgCreation` | `false` |
152
153
  | `VITE_ENABLE_ADMIN` | `admin` | `false` |
153
154
  | `VITE_ENABLE_FILE_UPLOADS` | `fileUploads` | `false` |
154
155
  | `VITE_ENABLE_PASSKEY` | `passkey` | `false` |
@@ -193,7 +194,12 @@ VITE_ENABLE_REALTIME=false # default: false
193
194
  VITE_ENABLE_ORGANIZATIONS=false # default: false
194
195
  VITE_ENABLE_ORG_TEAMS=false # default: false
195
196
  # Auto-set to true when the BA config has organization({ teams: { enabled: true } }).
196
- # When false the Teams tab is hidden and the auth client doesn't expose team APIs.
197
+ # When false the Teams page is hidden and the auth client doesn't expose team APIs.
198
+ VITE_ENABLE_ORG_CREATION=false # default: false
199
+ # Auto-set to true when the BA config sets
200
+ # plugins.organization.allowUserToCreateOrganization: true. When false there is no
201
+ # "New organization" button and /organizations/new redirects home (the server
202
+ # closes POST /organization/create; operators create orgs from Admin).
197
203
 
198
204
  # Admin
199
205
  VITE_ENABLE_ADMIN=false # default: false — the compiler always emits it explicitly
@@ -72,7 +72,7 @@ curl -X POST https://api.example.com/auth/v1/admin/set-role \
72
72
 
73
73
  Better Auth's `organization.create` seats whoever calls it. For an operator that is an escalation rather than a convenience: the membership it grants is tenant-data access — under `cms.access: "member"`, access to that organization's records — which is exactly what the `appmanager`/`sysadmin` split withholds.
74
74
 
75
- So organization creation asks for an `ownerUserId`, seats that user, and never seats the caller. Self-serve creation (`POST /auth/v1/organization/create`) is closed by default for the same reason; a project that wants it sets `plugins.organization.allowUserToCreateOrganization: true`.
75
+ So organization creation asks for an `ownerUserId`, seats that user, and never seats the caller. Self-serve creation (`POST /auth/v1/organization/create`) is closed by default for the same reason; a project that wants it sets `plugins.organization.allowUserToCreateOrganization: true`. Account UI follows the same setting: it shows **New organization** (and serves `/organizations/new`) only when that option is `true`. Both routes refuse [reserved slugs](/platform/auth/plugins/organization-defaults#reserved-organization-slugs).
76
76
 
77
77
  An operator who genuinely wants their own organization creates one naming themselves as owner — explicit, and visible in the audit trail rather than implied by whoever happened to make the call.
78
78
 
@@ -127,7 +127,7 @@ The admin domain serves the same Account SPA at root (`/`). The SPA's client-sid
127
127
 
128
128
  ## CMS Access Control
129
129
 
130
- When both CMS and Account UI are enabled, the Account profile shows a CMS action. It opens the sole organization directly or lets a multi-organization user choose one first. You can restrict this to the sysadmin tier only:
130
+ When both CMS and Account UI are enabled, the Account top bar and Home show a CMS action. It opens the current (or sole) organization directly, or lets a multi-organization user choose one first. You can restrict this to the sysadmin tier only:
131
131
 
132
132
  ```typescript
133
133
  cms: { domain: "cms.example.com", access: "sysadmin" },
@@ -1,6 +1,6 @@
1
1
  # API Key Management
2
2
 
3
- API keys are a user credential. Manage them at `/api-keys`, linked from `/profile`. The `apiKey` plugin is on by default.
3
+ API keys are a user credential. Manage them at `/api-keys` (**API keys** under Account in the sidebar). The `apiKey` plugin is on by default.
4
4
 
5
5
  ## Creating API Keys
6
6
 
@@ -11,18 +11,20 @@ Control which features are available in your Account UI deployment using feature
11
11
 
12
12
  ### `appConfig.features`
13
13
 
14
- These eleven flags populate `appConfig.features` and are the ones `isFeatureEnabled()` accepts.
14
+ These thirteen flags populate `appConfig.features` and are the ones `isFeatureEnabled()` accepts.
15
15
 
16
16
  | Variable | `features` key | Default |
17
17
  |---|---|---|
18
18
  | `VITE_ENABLE_ORGANIZATIONS` | `organizations` | `false` |
19
19
  | `VITE_ENABLE_ORG_TEAMS` | `orgTeams` | `false` |
20
+ | `VITE_ENABLE_ORG_CREATION` | `orgCreation` | `false` |
20
21
  | `VITE_ENABLE_ADMIN` | `admin` | `false` |
21
22
  | `VITE_ENABLE_FILE_UPLOADS` | `fileUploads` | `false` |
22
23
  | `VITE_ENABLE_PASSKEY` | `passkey` | `false` |
23
24
  | `VITE_ENABLE_EMAIL_OTP` | `emailOTP` | `false` |
24
25
  | `VITE_ENABLE_PASSWORD` | `password` | `true` |
25
26
  | `VITE_ENABLE_GOOGLE_OAUTH` | `googleOAuth` | `false` |
27
+ | `VITE_ENABLE_CLOUDFLARE_OAUTH` | `cloudflareOAuth` | `false` |
26
28
  | `VITE_ENABLE_SUBSCRIPTIONS` | `subscriptions` | `false` |
27
29
  | `VITE_ENABLE_REALTIME` | `realtime` | `false` |
28
30
  | `VITE_ENABLE_API_KEYS` | `apiKeys` | `true` |
@@ -176,10 +178,10 @@ VITE_ENABLE_GOOGLE_OAUTH=false # default: false
176
178
 
177
179
  **When enabled:**
178
180
  - "Continue with Google" button on the login and signup pages
179
- - Google row on `/connected-accounts` (linked from **Manage Connected Accounts** on `/profile`)
181
+ - Google row under **Connected accounts** on `/security`
180
182
 
181
183
  **When disabled:**
182
- - No social sign-in button, no **Manage Connected Accounts** link, no `/connected-accounts` page
184
+ - No social sign-in button and no **Connected accounts** card on `/security`
183
185
 
184
186
  **Requirements:**
185
187
  - Google OAuth credentials configured on the Better Auth side
@@ -192,7 +194,7 @@ VITE_ENABLE_CLOUDFLARE_OAUTH=false # default: false
192
194
 
193
195
  **When enabled:**
194
196
  - "Continue with Cloudflare" button on the login and signup pages
195
- - Cloudflare rows on `/connected-accounts` — unlike
197
+ - Cloudflare rows under **Connected accounts** on `/security` — unlike
196
198
  Google, more than one Cloudflare identity can be linked to the same user
197
199
  (**Connect another Cloudflare account**), and every linked identity signs
198
200
  in to this user. Link work and personal Cloudflare logins here so each one
@@ -265,11 +267,11 @@ VITE_ENABLE_ORGANIZATIONS=false # default: false
265
267
  ```
266
268
 
267
269
  **When enabled:**
268
- - `/dashboard` lists organizations and pending invitations
269
- - Organization management pages (`/$slug`)
270
+ - Home (`/home`) lists your organizations, each with **Open** / **CMS** / settings, plus pending invitations
271
+ - The organization switcher in the top bar (a plain label with one organization, a menu with several)
272
+ - The organization sidebar group: General (`/$slug`), Members, Teams, Billing
270
273
  - Member invitations and roles
271
- - `/organizations/*` routes
272
- - Sign-in still lands on `/profile`; **Manage Organizations** opens `/dashboard`
274
+ - `/organizations/new`, only when `VITE_ENABLE_ORG_CREATION` is also on
273
275
 
274
276
  **When disabled:**
275
277
  - Single-user mode only
@@ -1,37 +1,43 @@
1
1
  # Organizations
2
2
 
3
- Account UI provides a complete organization management interface when `VITE_ENABLE_ORGANIZATIONS=true`. `/dashboard` is that surface: the organizations you belong to and pending invitations. **Manage Organizations** on `/profile` (and in the user menu) opens it. Personal account settings live on `/profile`. The profile **Go to…** picker opens the tenant app using `account.appUrl` and `account.tenantPattern` — see [Customization](/ui/account/customization#tenant-url-patterns). When CMS is enabled, the profile also offers an access-aware CMS action: one membership opens directly, several memberships produce a picker, and the selected organization is made active before navigation. A pinned project targets only its configured organization; it never labels another membership as the CMS destination. Teams are a separate opt-in (`VITE_ENABLE_ORG_TEAMS`), surfaced when the compiler detects `organization({ teams: { enabled: true } })` in the Better Auth config.
3
+ Account UI provides a complete organization management interface when `VITE_ENABLE_ORGANIZATIONS=true`.
4
+
5
+ - **Home** (`/home`) lists the organizations you belong to, each with **Open** (the tenant app, via `account.appUrl` and `account.tenantPattern`; see [Customization](/ui/account/customization#tenant-url-patterns)), **CMS**, and a settings gear. Pending invitations sit above the list.
6
+ - **The top bar** shows the organization you're in. With one organization it is a plain label. With several it is a switcher: picking an organization opens it in the app, and its gear opens its settings.
7
+ - **The sidebar** has a group for the current organization: **General**, **Members**, **Teams**, **Billing**.
8
+
9
+ Opening the app or the CMS for an organization makes it the session's active organization first. With exactly one organization, sessions start with it active ([Organization Defaults](/platform/auth/plugins/organization-defaults)). A pinned project (`features.pinnedOrganizationId`) shows only its configured organization and never offers another membership. Teams are a separate opt-in (`VITE_ENABLE_ORG_TEAMS`), surfaced when the compiler detects `organization({ teams: { enabled: true } })` in the Better Auth config.
4
10
 
5
11
  ## Organization CRUD
6
12
 
7
- - Create new organizations, with `checkSlug` debounce on the slug field
8
- - Update name, **slug** (rename navigates to the new URL), and **metadata** (JSON object)
13
+ - Create new organizations at `/organizations/new`, with `checkSlug` debounce on the slug field. Reserved slugs (`home`, `admin`, `api`, `sudo`, …) are refused with the server's reason; see [Organization Defaults](/platform/auth/plugins/organization-defaults). Only offered when the project allows self-serve creation (`plugins.organization.allowUserToCreateOrganization: true`, surfaced as `VITE_ENABLE_ORG_CREATION`). Otherwise operators create organizations from [Admin](/ui/account/features/admin)
14
+ - **General** (`/$slug`): update name, **slug** (rename navigates to the new URL), and **metadata** (JSON object). Members without `organization:update` see a read-only summary
9
15
  - **Logo upload** only when `account.fileUploads: true` **and** managed R2 is configured with valid credentials (`R2_ACCOUNT_ID`, `R2_ACCESS_KEY_ID`, `R2_SECRET_ACCESS_KEY`). Start apps leave this off. See [Avatars](/ui/account/features/avatars).
10
16
  - Delete organizations — gated on the `organization:delete` permission (default: owner)
11
17
 
12
18
  ## Member Management
13
19
 
14
- - Invite members by email (with an optional team picker when teams are enabled)
20
+ - **Members** (`/$slug/members`): the member list with an **Invite** button. Invite by email, with an optional team picker when teams are enabled
15
21
  - Assign roles: **owner**, **admin**, **member**
16
22
  - Change roles and remove members — actions are filtered per-target by the role hierarchy (non-owners can't manage owner-role members)
17
- - Leave the organization
23
+ - Leave the organization from **General** (owners can't leave; they transfer ownership or delete)
18
24
 
19
25
  > **Note:** These three roles (`owner`, `admin`, `member`) are Better Auth's built-in organization roles and map directly to Account UI's role picker. Use the same roles in your Quickback [Access](/define/access) rules — with [`auth.roleHierarchy`](/define/access#role-hierarchy) configured, you can write `roles: ["member+"]` to mean "member and above." [Custom org roles](/define/access#custom-org-roles) declared in your access trees are auto-registered with the organization plugin, so `invite-member` / `update-member-role` accept them too.
20
26
 
21
27
  ## Invitations
22
28
 
23
- - Pending invitation list, per organization
29
+ - Pending invitations per organization, under the member list on **Members** (the old `/$slug/invitations` path redirects there)
24
30
  - Resend, cancel (per-org), accept, and reject (per-user)
25
- - Pending invites across organizations land on the user's `/dashboard`
31
+ - Pending invites across organizations appear on the user's Home, with Accept / Decline
26
32
  - Invitations carry an optional `teamId` when teams are enabled — the invitee joins that team on accept
27
33
 
28
34
  ## Teams
29
35
 
30
36
  Set `organization({ teams: { enabled: true } })` in your Better Auth config. The compiler emits `VITE_ENABLE_ORG_TEAMS=true` and the SPA exposes:
31
37
 
32
- - **Teams tab** on each organization, split into "Your teams" and "Other teams"
38
+ - **Teams** page on each organization, split into "Your teams" and "Other teams"
33
39
  - **Team detail** page with member roster, add/remove members
34
- - **Active-team picker** in the organization header — switches `session.activeTeamId` via `setActiveTeam`, so server-side handlers can scope by team
40
+ - **Active-team picker** on the Teams page — switches `session.activeTeamId` via `setActiveTeam`, so server-side handlers can scope by team
35
41
  - **Team-aware invitations** — when sending an invite, optionally pick a team; the member is added on accept
36
42
 
37
43
  Per-team actions (create / rename / delete / add-member / remove-member) gate on the `team:create`, `team:update`, and `team:delete` permissions from Better Auth's default statements.
@@ -48,3 +54,7 @@ This means projects that ship custom roles get a UI that matches what their serv
48
54
 
49
55
  - [Environment Variables](/ui/account/environment-variables)
50
56
  - [Account UI Overview](/ui/account)
57
+
58
+ ## Billing
59
+
60
+ When subscriptions are on (`VITE_ENABLE_SUBSCRIPTIONS`), each organization has a **Billing** page (`/$slug/billing`) showing its plan and subscription status. Operators manage subscriptions for every organization from **Admin → Subscriptions**.
@@ -1,6 +1,6 @@
1
1
  # Passkeys
2
2
 
3
- When the passkey feature is enabled (`enablePasskey` on the runtime config, default: `false`), Account UI provides passkey registration and management. When it is off, the passkey routes guard themselves at runtime — direct navigation redirects away and the management pages never render.
3
+ When the passkey feature is enabled (`enablePasskey` on the runtime config, default: `false`), Account UI provides passkey registration and management. Passkeys are managed on **Security** (`/security`); the old `/passkeys` path redirects there. When the feature is off, the Passkeys card, the Home prompt, and `/passkeys/setup` are hidden, and direct navigation redirects away.
4
4
 
5
5
  ## Passkey Registration
6
6
 
@@ -16,9 +16,13 @@ When the passkey feature is enabled (`enablePasskey` on the runtime config, defa
16
16
 
17
17
  ## Managing Passkeys
18
18
 
19
+ On **Security** (`/security`):
20
+
19
21
  - View registered passkeys
20
22
  - Remove individual passkeys
21
- - Register additional passkeys
23
+ - Register additional passkeys, with an optional name
24
+
25
+ Home shows an **Add a passkey** prompt while you have none.
22
26
 
23
27
  ## Requirements
24
28
 
@@ -1,6 +1,6 @@
1
1
  # Session Management
2
2
 
3
- Account UI includes a session management page where users can view and revoke their active sessions.
3
+ **Sessions** (`/devices`, under Account in the sidebar) lists your active sessions and lets you revoke them.
4
4
 
5
5
  ## Active Sessions
6
6
 
@@ -14,7 +14,7 @@ Users can see all devices where they're currently logged in, including:
14
14
 
15
15
  Users can revoke any session except their current one. This immediately invalidates the session token.
16
16
 
17
- Two events revoke other sessions without a click: changing the password from the profile page (the UI sends `revokeOtherSessions: true`), and resetting it through the forgot-password flow (the server default `revokeSessionsOnPasswordReset: true`, see [Session Freshness and Password Reset](/platform/auth/security#session-freshness-and-password-reset)).
17
+ Two events revoke other sessions without a click: changing the password with the current password on **Security** (the UI sends `revokeOtherSessions: true`), and resetting it with an emailed code — on **Security** when email OTP is on, or through the forgot-password flow (the server default `revokeSessionsOnPasswordReset: true`, see [Session Freshness and Password Reset](/platform/auth/security#session-freshness-and-password-reset)).
18
18
 
19
19
  ## Related
20
20
 
@@ -4,25 +4,57 @@ A complete authentication and account management frontend that ships with the Qu
4
4
 
5
5
  ## What's Included
6
6
 
7
- Account UI is a single React SPA that contains three distinct sections:
7
+ Account UI is a single React SPA. Every signed-in page renders inside one shell:
8
+
9
+ - **Top bar**: your app's name (links to Home), the organization you're in, an **Open {org} ↗** button, a **CMS** button, and the account menu.
10
+ - **Sidebar**: a **Home** entry, then an **Account** group, then a group for the current organization, then **Platform → Admin** for operators. On mobile the sidebar becomes a slide-out drawer.
11
+
12
+ | Sidebar entry | Path | What's there |
13
+ |---|---|---|
14
+ | **Home** | `/home` | The landing page after sign-in: pending invitations, your organizations with **Open** / **CMS** / settings buttons, and a passkey prompt when you have none |
15
+ | Account → **Profile** | `/profile` | Photo, name, email, and **Delete account** |
16
+ | Account → **Security** | `/security` | Password, passkeys, and connected (Google / Cloudflare) logins |
17
+ | Account → **Sessions** | `/devices` | Signed-in devices; sign out one or all |
18
+ | Account → **API keys** | `/api-keys` | Personal API keys (when the `apiKey` plugin is on) |
19
+ | *Org* → **General** | `/$slug` | Name, slug, logo, metadata; **Leave** and **Delete** |
20
+ | *Org* → **Members** | `/$slug/members` | Members and roles, an **Invite** button, and pending invitations |
21
+ | *Org* → **Teams** | `/$slug/teams` | Teams and the active-team picker (when teams are on) |
22
+ | *Org* → **Billing** | `/$slug/billing` | The organization's subscription (when subscriptions are on) |
23
+ | Platform → **Admin** | `/admin` | Users, organizations, subscriptions (operators only) |
24
+
25
+ The shell collapses with your configuration. Without organizations there is no organization switcher and no org group. With nothing to launch (no organizations, no `account.appUrl`, no CMS), Home is skipped and sign-in lands on **Profile**. Old paths redirect, so existing links keep working: `/dashboard` → `/home`, `/passkeys` and `/connected-accounts` → `/security`, `/$slug/settings` → `/$slug`, `/$slug/invitations` → `/$slug/members`.
8
26
 
9
- ### Account (every user)
27
+ Served on its own domain (e.g., `auth.example.com`) or at `/account/` when embedded alongside the CMS.
10
28
 
11
- Login, signup, profile editing, password management, device sessions, email changes, and account deletion. This is what every user interacts with. After sign-in, Account UI lands on `/profile`.
29
+ ### Getting into the app
12
30
 
13
- When organizations are enabled, `/profile` has **Manage Organizations** (the `/dashboard` org list and invites) and a **Go to…** control that opens the tenant app. The URL is `account.appUrl` plus `account.tenantPattern` with the org slug substituted (the same `getTenantUrl` used on the org dashboard). One org is a single button; several orgs is a picker. The control is hidden when those config values cannot produce a URL.
31
+ There is one rule for every **Open** button: the organization's tenant URL (`account.appUrl` plus `account.tenantPattern` with the slug substituted), else the plain `account.appUrl`, else no button. Opening the app for an organization first makes it the session's active organization, the same way the CMS launch does, so the app never opens into an organization left active by an earlier visit.
14
32
 
15
- When the project also enables the CMS, the profile has a separate CMS action. One membership opens that organization directly; several memberships produce an organization picker. Account UI makes the selected organization active before navigating, so the CMS cannot inherit a different active organization from an earlier session. The action follows `cms.access`: membership is required in `"member"` mode, while only `user.role === "sysadmin"` sees it in `"sysadmin"` mode. A zero-membership sysadmin opens the tenant picker only when `cms.sysadmin: true` explicitly enables cross-tenant scope. When `features.pinnedOrganizationId` is set, the profile targets only that fixed organization and never offers the caller's other memberships.
33
+ Accepting an invitation opens the app for that organization when the project has an app URL. Otherwise it goes to Home.
16
34
 
17
- Served on its own domain (e.g., `auth.example.com`) or at `/account/` when embedded alongside the CMS.
35
+ ### Organizations
36
+
37
+ How the organization switcher in the top bar behaves depends on how many organizations you belong to:
38
+
39
+ | Organizations | Top bar | Home |
40
+ |---|---|---|
41
+ | 0 | No switcher | Pending invitations and an empty state. **Open** goes to the plain `account.appUrl` when set. |
42
+ | 1 | The org's name as a plain label (no menu) | One large **Open {org}** button, plus **Open CMS** and settings |
43
+ | 2+ | A menu. Picking an org opens it in the app; the gear opens its settings. | One row per org with **Open**, **CMS**, and settings |
44
+
45
+ With exactly one organization, the session starts with it active, so the app, the CMS, and org-scoped API calls default to it. The server does this when the session is created ([Organization Defaults](/platform/auth/plugins/organization-defaults)), and Account UI repeats it for older sessions. Neither overrides an organization that is already active. When `features.pinnedOrganizationId` is set, the shell shows only that organization, so it always behaves as a single-organization account.
46
+
47
+ Some slugs are reserved (`home`, `admin`, `api`, `sudo`, …) because they would shadow a route; the slug field says so as you type. See [Organization Defaults](/platform/auth/plugins/organization-defaults#reserved-organization-slugs).
48
+
49
+ **New organization** appears (on Home and in the switcher) only when the project allows self-serve creation with `plugins.organization.allowUserToCreateOrganization: true`. By default the server closes `POST /organization/create`, and operators create organizations from **Admin → Organizations** instead. See [Admin](/ui/account/features/admin).
18
50
 
19
- ### Organization Management (multi-tenant)
51
+ ### CMS launch
20
52
 
21
- `/dashboard` is org management — org list, pending invitations, and the path into org settings (`/$slug`). Personal account settings stay on `/profile`. Only available when `auth.organizations` is enabled.
53
+ When the project also enables the CMS, the top bar and Home have a CMS action. It opens the current organization's CMS directly. Otherwise, one membership opens that organization and several memberships produce a picker. Account UI makes the selected organization active before navigating, so the CMS cannot inherit a different active organization from an earlier session. The action follows `cms.access`: membership is required in `"member"` mode, while only `user.role === "sysadmin"` sees it in `"sysadmin"` mode. A zero-membership sysadmin opens the tenant picker only when `cms.sysadmin: true` explicitly enables cross-tenant scope. When `features.pinnedOrganizationId` is set, the action targets only that fixed organization and never offers the caller's other memberships.
22
54
 
23
- ### Admin Panel (admin users only)
55
+ ### Admin Panel (operators only)
24
56
 
25
- User management dashboard — view all users, search, create accounts, ban/unban, reset passwords, and manage sessions. Only accessible to users with the `admin` role. Can be served on its own domain (e.g., `admin.example.com`) via the `adminDomain` config.
57
+ User management: view all users, search, create accounts, ban/unban, reset passwords, manage sessions, and create organizations with a named owner. It is visible to operator roles (`appmanager`, `sysadmin`) when `auth.admin` is on, and renders inside the same shell. Can be served on its own domain (e.g., `admin.example.com`) via the `adminDomain` config.
26
58
 
27
59
  ## How to Enable
28
60
 
@@ -54,24 +86,23 @@ npx wrangler deploy
54
86
 
55
87
  That's it. The compiler:
56
88
  1. Reads your auth feature flags and branding from the config
57
- 2. Generates a `.env` file with the correct `VITE_*` variables
58
- 3. Builds the SPA from source with Vite (inside Docker)
59
- 4. Excludes routes for disabled features (compile-time tree shaking)
60
- 5. Bundles the built assets into your Worker alongside the API
89
+ 2. Copies the generic prebuilt Account bundle (built once, when the compiler image is built) into `src/apps/account/`
90
+ 3. Emits the per-project values (feature flags, URLs, branding) that the Worker injects into every served page as `window.__QUICKBACK_RUNTIME`
91
+ 4. Serves the assets from your Worker alongside the API
61
92
 
62
- No manual `.env` configuration needed. No separate deployment.
93
+ Compiles never run Vite. No manual `.env` configuration needed. No separate deployment.
63
94
 
64
95
  See [Configuration](/configure) for all `account` options and [Multi-Domain Architecture](/configure/domains) for custom domain setup.
65
96
 
66
- ### Skip SPA Rebuild
97
+ ### Skip Staging the Account Assets
67
98
 
68
- After the first compile, skip rebuilding the Account SPA on subsequent compiles:
99
+ After the first compile, skip copying the Account assets on subsequent compiles:
69
100
 
70
101
  ```typescript
71
102
  account: { build: false, /* ...other options */ }
72
103
  ```
73
104
 
74
- Useful when iterating on API features — saves significant compile time. Set back to `true` (or omit) when you need to update the Account UI.
105
+ Use it while iterating on API features. Set it back to `true` (or omit it) to pick up a newer Account bundle.
75
106
 
76
107
  ### Custom Output Directory
77
108
 
@@ -81,28 +112,28 @@ account: { outputDir: "my-custom-path/account" }
81
112
 
82
113
  Changes where compiled Account assets are placed, instead of the default `src/apps/account/`.
83
114
 
84
- ## Compile-Time Feature Gating
115
+ ## Feature Gating
85
116
 
86
- Auth feature flags control which pages are included in the bundle:
117
+ Auth feature flags control which pages and controls exist:
87
118
 
88
119
  | Flag | Pages Included |
89
120
  |------|---------------|
90
- | `auth.password` | Password login, inline password change on profile |
91
- | `auth.emailOTP` | Email OTP login flow, email-based password reset |
92
- | `auth.passkey` | Passkey setup and management |
93
- | `auth.organizations` | `/dashboard` (org list + invitations), org creation, member management |
94
- | `auth.admin` | Admin panel (user management) |
121
+ | `auth.password` | Password login; **Change password** on Security |
122
+ | `auth.emailOTP` | Email OTP login flow, email-based password reset; on Security, password changes are confirmed with an emailed code |
123
+ | `auth.passkey` | Passkeys on Security, the `/passkeys/setup` prompt, the passkey nudge on Home |
124
+ | `auth.organizations` | The organization switcher, org cards and invitations on Home, the org sidebar group (General, Members, Teams, Billing) |
125
+ | `auth.admin` | Admin panel (user and organization management) |
95
126
 
96
- When a flag is `false`, the corresponding routes **guard themselves at runtime** — each feature route checks its flag from the worker-injected `window.__QUICKBACK_RUNTIME` config in `beforeLoad` and redirects away, and navigation entries for it are hidden. The Account SPA ships as one generic prebuilt bundle; flags decide which surfaces exist for your project.
127
+ When a flag is `false`, the corresponding routes **guard themselves at runtime** — each feature route checks its flag from the worker-injected `window.__QUICKBACK_RUNTIME` config in `beforeLoad` and redirects away, and its sidebar entries and buttons are hidden. The Account SPA ships as one generic prebuilt bundle; flags decide which surfaces exist for your project.
97
128
 
98
129
  ## Features
99
130
 
100
131
  - **Authentication** — Email/password, passkeys (WebAuthn), email OTP, email verification, password reset, and the confirm page that magic-link emails open (`/magic-link`)
101
- - **Account Management** — Profile editing, avatar upload, password changes, device/session management, account deletion
102
- - **Connected Accounts** — Link Google and Cloudflare logins from `/connected-accounts` (linked from profile)
103
- - **Organizations** — Multi-tenant org management with owner/admin/member roles, invitations, and org settings
132
+ - **Account Management** — Profile editing, avatar upload, password changes, session management, account deletion
133
+ - **Connected Accounts** — Link Google and Cloudflare logins on `/security`
134
+ - **Organizations** — Multi-tenant org management with owner/admin/member roles, invitations, teams, billing, and org settings
104
135
  - **Admin Panel** — User management dashboard with search, create, ban/unban, password reset, and session viewing
105
- - **API Keys** — Generate and manage API keys from `/api-keys` (linked from profile)
136
+ - **API Keys** — Generate and manage API keys from `/api-keys`
106
137
  - **CLI Authorization** — Device authorization flow for `quickback login`
107
138
 
108
139
  ## Next Steps
@@ -68,7 +68,7 @@ auth: {
68
68
  password: true, // Email/password login + inline password change
69
69
  emailOTP: false, // Email OTP login flow
70
70
  passkey: true, // WebAuthn passkey setup + management
71
- organizations: true, // /dashboard org list, org management, invitations
71
+ organizations: true, // org switcher, Home org list + invitations, org settings
72
72
  admin: true, // Admin panel (user management)
73
73
  }
74
74
  ```
@@ -138,7 +138,7 @@ This adds a custom domain route to `wrangler.toml`. Both `api.example.com` and `
138
138
 
139
139
  CMS access defaults to `access: "sysadmin"` — only `user.role === "sysadmin"` (the cross-tenant data-plane tier) can use `/cms/*`. Set `access: "member"` to also admit anyone holding an organization membership. `user.role === "appmanager"` opens the CMS in neither mode: it is the control-plane tier and belongs at `/account/admin`. The gate is enforced at multiple layers:
140
140
 
141
- - **Account UI** hides the "Go to CMS" button for callers outside those roles.
141
+ - **Account UI** hides its **CMS** button for callers outside those roles.
142
142
  - **CMS SPA shell** — the Worker redirects unauthenticated requests to login. Sign-in is the only shell-level gate; the app itself is a generic bundle. For a caller `/api/v1/schema` would admit, the Worker also inlines the schema registry in the shell as a non-executing `<script type="application/json" id="__qb-cms-bootstrap">` block, so the CMS starts without fetching it. The block uses the same admission check as `/api/v1/schema`, so it never carries anything that route would refuse. With [Cloudflare Access](/configure/cloudflare-access), it is inlined only when `/api/v1/schema` needs no Access application or the same one the shell request passed. The CMS shell is served `Cache-Control: private, no-store`.
143
143
  - **`/api/v1/schema`** returns `401 AUTH_MISSING` to anonymous callers `403 CMS_ACCESS_DENIED` (naming the role required) to signed-in callers outside those roles, and `403 MFA_REQUIRED` to an operator whose session lacks the second factor `auth.operatorMfa` demands, so schema metadata can't be scraped by hitting the API directly.
144
144
  - **`custom_view` routes** are gated on `userRole: ["appmanager"]` rather than org membership, so saved views can't be listed or modified without platform-control-plane rights.
@@ -181,7 +181,7 @@ Start apps ship that setting. A sysadmin who also holds an organization membersh
181
181
  > **File uploads need valid R2 credentials**
182
182
  >
183
183
  > Profile pictures and organization logos are **Account UI**, not the CMS — they
184
- > live at `/account/profile` and `/account/<slug>/settings`. They only work with
184
+ > live at `/account/profile` and `/account/<slug>` (the organization's General page). They only work with
185
185
  > `account.fileUploads: true`, [managed R2](/platform/storage/r2)
186
186
  > (`defineFileStorage("cloudflare-r2", { managed: true })`), and the
187
187
  > `R2_ACCOUNT_ID` / `R2_ACCESS_KEY_ID` / `R2_SECRET_ACCESS_KEY` secrets. A
@@ -38,9 +38,9 @@ export default feature("contacts", {
38
38
  // Contact details are detected as sensitive; on a CRM contact record they
39
39
  // are the point of the record, so this one is reviewed and left visible.
40
40
  masking: { email: false, phone: false, mobile: false },
41
- create: { /* ... */ },
42
- update: { /* ... */ },
43
- delete: { /* ... */ },
41
+ create: { access: { roles: ["owner", "admin", "member"] } },
42
+ update: { access: { roles: ["owner", "admin", "member"] } },
43
+ delete: { access: { roles: ["owner", "admin"] } },
44
44
  layouts: {
45
45
  default: {
46
46
  sections: [