@agent-native/core 0.124.3 → 0.124.4

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 (254) hide show
  1. package/README.md +1 -1
  2. package/corpus/README.md +2 -2
  3. package/corpus/core/CHANGELOG.md +10 -0
  4. package/corpus/core/docs/content/cloneable-saas.mdx +9 -9
  5. package/corpus/core/docs/content/creating-templates.mdx +2 -2
  6. package/corpus/core/docs/content/deployment.mdx +23 -0
  7. package/corpus/core/docs/content/faq.mdx +4 -4
  8. package/corpus/core/docs/content/key-concepts.mdx +1 -1
  9. package/corpus/core/docs/content/multi-app-workspace.mdx +1 -1
  10. package/corpus/core/docs/content/syncing-template-changes.mdx +1 -1
  11. package/corpus/core/docs/content/template-analytics-developers.mdx +2 -2
  12. package/corpus/core/docs/content/template-analytics.mdx +2 -2
  13. package/corpus/core/docs/content/template-assets-developers.mdx +3 -3
  14. package/corpus/core/docs/content/template-assets.mdx +2 -2
  15. package/corpus/core/docs/content/template-brain-developers.mdx +2 -2
  16. package/corpus/core/docs/content/template-brain.mdx +1 -1
  17. package/corpus/core/docs/content/template-calendar-developers.mdx +1 -1
  18. package/corpus/core/docs/content/template-calendar.mdx +1 -1
  19. package/corpus/core/docs/content/template-chat.mdx +1 -1
  20. package/corpus/core/docs/content/template-clips-developers.mdx +4 -4
  21. package/corpus/core/docs/content/template-clips.mdx +2 -2
  22. package/corpus/core/docs/content/template-content-developers.mdx +2 -2
  23. package/corpus/core/docs/content/template-content.mdx +1 -1
  24. package/corpus/core/docs/content/template-design-brand-and-figma.mdx +1 -1
  25. package/corpus/core/docs/content/template-design-developers.mdx +2 -2
  26. package/corpus/core/docs/content/template-design.mdx +2 -2
  27. package/corpus/core/docs/content/template-dispatch-developers.mdx +5 -5
  28. package/corpus/core/docs/content/template-forms-developers.mdx +1 -1
  29. package/corpus/core/docs/content/template-forms.mdx +1 -1
  30. package/corpus/core/docs/content/template-mail-developers.mdx +2 -2
  31. package/corpus/core/docs/content/template-mail.mdx +2 -2
  32. package/corpus/core/docs/content/template-plan-developers.mdx +3 -3
  33. package/corpus/core/docs/content/template-plan.mdx +3 -3
  34. package/corpus/core/docs/content/template-slides-developers.mdx +4 -4
  35. package/corpus/core/docs/content/template-slides.mdx +1 -1
  36. package/corpus/core/docs/content/what-is-agent-native.mdx +5 -5
  37. package/corpus/core/package.json +1 -1
  38. package/corpus/core/src/a2a/auth-policy.ts +1 -1
  39. package/corpus/core/src/agent/production-agent.ts +14 -1
  40. package/corpus/core/src/agent/run-manager.ts +6 -13
  41. package/corpus/core/src/cli/index.ts +11 -1
  42. package/corpus/core/src/client/route-chunk-recovery.ts +18 -7
  43. package/corpus/core/src/db/client.ts +7 -6
  44. package/corpus/core/src/db/migrations.ts +2 -1
  45. package/corpus/core/src/deploy/build.ts +290 -4
  46. package/corpus/core/src/deploy/nitro-preset.ts +50 -0
  47. package/corpus/core/src/integrations/pending-tasks-retry-job.ts +2 -1
  48. package/corpus/core/src/scripts/call-agent.ts +4 -2
  49. package/corpus/core/src/server/agent-discovery.ts +1 -0
  50. package/corpus/core/src/server/agent-run-context.ts +13 -3
  51. package/corpus/core/src/server/request-context.ts +2 -0
  52. package/corpus/core/src/shared/cloudflare-globals.d.ts +2 -1
  53. package/corpus/core/src/shared/runtime.ts +2 -0
  54. package/corpus/core/src/templates/default/.agents/skills/secrets/SKILL.md +29 -0
  55. package/corpus/core/src/templates/default/app/i18n/ar-SA.ts +6 -6
  56. package/corpus/core/src/templates/default/app/i18n/de-DE.ts +6 -6
  57. package/corpus/core/src/templates/default/app/i18n/en-US.ts +6 -6
  58. package/corpus/core/src/templates/default/app/i18n/es-ES.ts +6 -6
  59. package/corpus/core/src/templates/default/app/i18n/fr-FR.ts +6 -6
  60. package/corpus/core/src/templates/default/app/i18n/hi-IN.ts +6 -6
  61. package/corpus/core/src/templates/default/app/i18n/ja-JP.ts +6 -6
  62. package/corpus/core/src/templates/default/app/i18n/ko-KR.ts +6 -6
  63. package/corpus/core/src/templates/default/app/i18n/pt-BR.ts +6 -6
  64. package/corpus/core/src/templates/default/app/i18n/zh-CN.ts +6 -6
  65. package/corpus/core/src/templates/default/app/i18n/zh-TW.ts +6 -6
  66. package/corpus/core/src/templates/headless/.agents/skills/secrets/SKILL.md +29 -0
  67. package/corpus/core/src/templates/workspace-core/.agents/skills/secrets/SKILL.md +29 -0
  68. package/corpus/core/src/vite/client.ts +20 -1
  69. package/corpus/templates/analytics/actions/restore-dashboard-revision.ts +9 -2
  70. package/corpus/templates/analytics/app/components/dashboard/DashboardHistoryPanel.tsx +3 -0
  71. package/corpus/templates/analytics/app/components/dashboard/DashboardPanelSkeleton.tsx +1 -1
  72. package/corpus/templates/analytics/app/global.css +10 -9
  73. package/corpus/templates/analytics/app/hooks/use-chart-tooltip-portal.ts +59 -18
  74. package/corpus/templates/analytics/app/hooks/use-dashboard-revisions.ts +14 -2
  75. package/corpus/templates/analytics/app/i18n-data.ts +102 -0
  76. package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/index.tsx +232 -2
  77. package/corpus/templates/analytics/changelog/2026-07-27-chart-tooltips-stay-beside-the-cursor-when-they-extend-beyon.md +6 -0
  78. package/corpus/templates/analytics/changelog/2026-07-27-chat-no-longer-claims-a-data-source-is-disconnected-when-it-.md +6 -0
  79. package/corpus/templates/analytics/changelog/2026-07-27-dashboard-changes-can-be-undone-with-cmd-z-and-actions-menu.md +6 -0
  80. package/corpus/templates/analytics/changelog/2026-07-27-dashboard-redo-with-cmd-shift-z-and-actions-menu.md +6 -0
  81. package/corpus/templates/analytics/changelog/2026-07-27-dashboard-skeletons-are-subtler-and-smoother.md +6 -0
  82. package/corpus/templates/analytics/server/lib/dashboards-store.ts +61 -20
  83. package/corpus/templates/analytics/server/lib/real-data-actions.ts +1 -0
  84. package/corpus/templates/analytics/server/plugins/agent-chat.ts +7 -3
  85. package/corpus/templates/calendar/app/components/layout/Sidebar.tsx +7 -32
  86. package/corpus/templates/calendar/changelog/2026-07-27-calendar-s-sidebar-now-uses-a-cleaner-layout-with-fewer-util.md +6 -0
  87. package/corpus/templates/content/app/components/editor/database/sidebar.tsx +14 -6
  88. package/corpus/templates/content/app/components/sidebar/DocumentSidebar.tsx +32 -37
  89. package/corpus/templates/content/changelog/2026-07-27-content-sidebar-page-lists-now-load-with-quiet-skeletons-and.md +6 -0
  90. package/corpus/templates/design/app/components/layout/Sidebar.tsx +16 -18
  91. package/corpus/templates/design/changelog/2026-07-27-collapsed-sidebar-keeps-the-agent-native-logo.md +6 -0
  92. package/corpus/templates/dispatch/AGENTS.md +7 -2
  93. package/corpus/templates/dispatch/actions/view-screen.ts +3 -2
  94. package/corpus/templates/dispatch/changelog/2026-07-17-curated-template-remixes.md +1 -1
  95. package/corpus/templates/dispatch/changelog/2026-07-27-creating-an-app-from-a-curated-template-now-uses-clearer-mor.md +6 -0
  96. package/corpus/templates/dispatch/changelog/2026-07-27-thread-debug-accepts-request-run-ids.md +6 -0
  97. package/corpus/templates/slides/actions/create-design-system.ts +10 -2
  98. package/corpus/templates/slides/actions/import-file.ts +173 -1
  99. package/corpus/templates/slides/actions/list-slide-comments.ts +16 -1
  100. package/corpus/templates/slides/actions/update-design-system.ts +13 -2
  101. package/corpus/templates/slides/app/components/editor/AssetLibraryPanel.tsx +35 -12
  102. package/corpus/templates/slides/app/components/editor/EditorToolbar.tsx +36 -0
  103. package/corpus/templates/slides/app/i18n/en-US.ts +3 -0
  104. package/corpus/templates/slides/app/lib/dynamic-import.ts +63 -0
  105. package/corpus/templates/slides/app/lib/export-pdf-client.ts +3 -2
  106. package/corpus/templates/slides/app/lib/export-pptx-client.ts +5 -2
  107. package/corpus/templates/slides/app/pages/DesignSystems.tsx +9 -1
  108. package/corpus/templates/slides/server/db/schema.ts +11 -0
  109. package/corpus/templates/slides/server/handlers/assets.ts +64 -19
  110. package/corpus/templates/slides/server/handlers/import/html-converter.ts +38 -0
  111. package/corpus/templates/slides/server/plugins/db.ts +20 -0
  112. package/corpus/templates/slides/shared/design-system-validation.ts +62 -0
  113. package/dist/a2a/auth-policy.js +1 -1
  114. package/dist/a2a/auth-policy.js.map +1 -1
  115. package/dist/agent/production-agent.d.ts +1 -0
  116. package/dist/agent/production-agent.d.ts.map +1 -1
  117. package/dist/agent/production-agent.js +12 -1
  118. package/dist/agent/production-agent.js.map +1 -1
  119. package/dist/agent/run-manager.d.ts +2 -0
  120. package/dist/agent/run-manager.d.ts.map +1 -1
  121. package/dist/agent/run-manager.js +4 -10
  122. package/dist/agent/run-manager.js.map +1 -1
  123. package/dist/cli/index.js +8 -1
  124. package/dist/cli/index.js.map +1 -1
  125. package/dist/client/route-chunk-recovery.d.ts.map +1 -1
  126. package/dist/client/route-chunk-recovery.js +16 -7
  127. package/dist/client/route-chunk-recovery.js.map +1 -1
  128. package/dist/collab/awareness.d.ts +2 -2
  129. package/dist/collab/awareness.d.ts.map +1 -1
  130. package/dist/collab/routes.d.ts +1 -1
  131. package/dist/collab/struct-routes.d.ts +1 -1
  132. package/dist/db/client.d.ts.map +1 -1
  133. package/dist/db/client.js +4 -2
  134. package/dist/db/client.js.map +1 -1
  135. package/dist/db/migrations.d.ts.map +1 -1
  136. package/dist/db/migrations.js +2 -1
  137. package/dist/db/migrations.js.map +1 -1
  138. package/dist/deploy/build.d.ts +25 -0
  139. package/dist/deploy/build.d.ts.map +1 -1
  140. package/dist/deploy/build.js +227 -4
  141. package/dist/deploy/build.js.map +1 -1
  142. package/dist/deploy/nitro-preset.d.ts +8 -0
  143. package/dist/deploy/nitro-preset.d.ts.map +1 -0
  144. package/dist/deploy/nitro-preset.js +36 -0
  145. package/dist/deploy/nitro-preset.js.map +1 -0
  146. package/dist/integrations/pending-tasks-retry-job.d.ts.map +1 -1
  147. package/dist/integrations/pending-tasks-retry-job.js +2 -1
  148. package/dist/integrations/pending-tasks-retry-job.js.map +1 -1
  149. package/dist/notifications/routes.d.ts +3 -3
  150. package/dist/observability/routes.d.ts +3 -3
  151. package/dist/progress/routes.d.ts +1 -1
  152. package/dist/provider-api/actions/custom-provider-registration.d.ts +11 -11
  153. package/dist/provider-api/actions/provider-api.d.ts +11 -11
  154. package/dist/scripts/call-agent.d.ts.map +1 -1
  155. package/dist/scripts/call-agent.js +4 -2
  156. package/dist/scripts/call-agent.js.map +1 -1
  157. package/dist/secrets/routes.d.ts +3 -3
  158. package/dist/server/agent-discovery.d.ts.map +1 -1
  159. package/dist/server/agent-discovery.js +1 -0
  160. package/dist/server/agent-discovery.js.map +1 -1
  161. package/dist/server/agent-run-context.d.ts.map +1 -1
  162. package/dist/server/agent-run-context.js +10 -3
  163. package/dist/server/agent-run-context.js.map +1 -1
  164. package/dist/server/request-context.d.ts +2 -0
  165. package/dist/server/request-context.d.ts.map +1 -1
  166. package/dist/server/request-context.js.map +1 -1
  167. package/dist/server/transcribe-voice.d.ts +1 -1
  168. package/dist/shared/runtime.d.ts.map +1 -1
  169. package/dist/shared/runtime.js +2 -0
  170. package/dist/shared/runtime.js.map +1 -1
  171. package/dist/templates/default/.agents/skills/secrets/SKILL.md +29 -0
  172. package/dist/templates/default/app/i18n/ar-SA.ts +6 -6
  173. package/dist/templates/default/app/i18n/de-DE.ts +6 -6
  174. package/dist/templates/default/app/i18n/en-US.ts +6 -6
  175. package/dist/templates/default/app/i18n/es-ES.ts +6 -6
  176. package/dist/templates/default/app/i18n/fr-FR.ts +6 -6
  177. package/dist/templates/default/app/i18n/hi-IN.ts +6 -6
  178. package/dist/templates/default/app/i18n/ja-JP.ts +6 -6
  179. package/dist/templates/default/app/i18n/ko-KR.ts +6 -6
  180. package/dist/templates/default/app/i18n/pt-BR.ts +6 -6
  181. package/dist/templates/default/app/i18n/zh-CN.ts +6 -6
  182. package/dist/templates/default/app/i18n/zh-TW.ts +6 -6
  183. package/dist/templates/headless/.agents/skills/secrets/SKILL.md +29 -0
  184. package/dist/templates/workspace-core/.agents/skills/secrets/SKILL.md +29 -0
  185. package/dist/vite/client.d.ts +1 -1
  186. package/dist/vite/client.d.ts.map +1 -1
  187. package/dist/vite/client.js +16 -0
  188. package/dist/vite/client.js.map +1 -1
  189. package/docs/content/cloneable-saas.mdx +9 -9
  190. package/docs/content/creating-templates.mdx +2 -2
  191. package/docs/content/deployment.mdx +23 -0
  192. package/docs/content/faq.mdx +4 -4
  193. package/docs/content/key-concepts.mdx +1 -1
  194. package/docs/content/multi-app-workspace.mdx +1 -1
  195. package/docs/content/syncing-template-changes.mdx +1 -1
  196. package/docs/content/template-analytics-developers.mdx +2 -2
  197. package/docs/content/template-analytics.mdx +2 -2
  198. package/docs/content/template-assets-developers.mdx +3 -3
  199. package/docs/content/template-assets.mdx +2 -2
  200. package/docs/content/template-brain-developers.mdx +2 -2
  201. package/docs/content/template-brain.mdx +1 -1
  202. package/docs/content/template-calendar-developers.mdx +1 -1
  203. package/docs/content/template-calendar.mdx +1 -1
  204. package/docs/content/template-chat.mdx +1 -1
  205. package/docs/content/template-clips-developers.mdx +4 -4
  206. package/docs/content/template-clips.mdx +2 -2
  207. package/docs/content/template-content-developers.mdx +2 -2
  208. package/docs/content/template-content.mdx +1 -1
  209. package/docs/content/template-design-brand-and-figma.mdx +1 -1
  210. package/docs/content/template-design-developers.mdx +2 -2
  211. package/docs/content/template-design.mdx +2 -2
  212. package/docs/content/template-dispatch-developers.mdx +5 -5
  213. package/docs/content/template-forms-developers.mdx +1 -1
  214. package/docs/content/template-forms.mdx +1 -1
  215. package/docs/content/template-mail-developers.mdx +2 -2
  216. package/docs/content/template-mail.mdx +2 -2
  217. package/docs/content/template-plan-developers.mdx +3 -3
  218. package/docs/content/template-plan.mdx +3 -3
  219. package/docs/content/template-slides-developers.mdx +4 -4
  220. package/docs/content/template-slides.mdx +1 -1
  221. package/docs/content/what-is-agent-native.mdx +5 -5
  222. package/package.json +1 -1
  223. package/src/a2a/auth-policy.ts +1 -1
  224. package/src/agent/production-agent.ts +14 -1
  225. package/src/agent/run-manager.ts +6 -13
  226. package/src/cli/index.ts +11 -1
  227. package/src/client/route-chunk-recovery.ts +18 -7
  228. package/src/db/client.ts +7 -6
  229. package/src/db/migrations.ts +2 -1
  230. package/src/deploy/build.ts +290 -4
  231. package/src/deploy/nitro-preset.ts +50 -0
  232. package/src/integrations/pending-tasks-retry-job.ts +2 -1
  233. package/src/scripts/call-agent.ts +4 -2
  234. package/src/server/agent-discovery.ts +1 -0
  235. package/src/server/agent-run-context.ts +13 -3
  236. package/src/server/request-context.ts +2 -0
  237. package/src/shared/cloudflare-globals.d.ts +2 -1
  238. package/src/shared/runtime.ts +2 -0
  239. package/src/templates/default/.agents/skills/secrets/SKILL.md +29 -0
  240. package/src/templates/default/app/i18n/ar-SA.ts +6 -6
  241. package/src/templates/default/app/i18n/de-DE.ts +6 -6
  242. package/src/templates/default/app/i18n/en-US.ts +6 -6
  243. package/src/templates/default/app/i18n/es-ES.ts +6 -6
  244. package/src/templates/default/app/i18n/fr-FR.ts +6 -6
  245. package/src/templates/default/app/i18n/hi-IN.ts +6 -6
  246. package/src/templates/default/app/i18n/ja-JP.ts +6 -6
  247. package/src/templates/default/app/i18n/ko-KR.ts +6 -6
  248. package/src/templates/default/app/i18n/pt-BR.ts +6 -6
  249. package/src/templates/default/app/i18n/zh-CN.ts +6 -6
  250. package/src/templates/default/app/i18n/zh-TW.ts +6 -6
  251. package/src/templates/headless/.agents/skills/secrets/SKILL.md +29 -0
  252. package/src/templates/workspace-core/.agents/skills/secrets/SKILL.md +29 -0
  253. package/src/vite/client.ts +20 -1
  254. /package/corpus/templates/slides/server/routes/api/assets/{[filename].delete.ts → [id].delete.ts} +0 -0
package/README.md CHANGED
@@ -27,7 +27,7 @@ https://github.com/user-attachments/assets/ef51644b-6506-46d8-8083-0af7b7e5b65c
27
27
 
28
28
  ## Try an Agent-Native app
29
29
 
30
- Fork a working app and let the agent evolve it. **You can customize everything.**
30
+ Start from a working app and let the agent evolve it. **You can customize everything.**
31
31
 
32
32
  <table>
33
33
  <tr>
package/corpus/README.md CHANGED
@@ -28,6 +28,6 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
28
28
 
29
29
  ## Generated Counts
30
30
 
31
- - core files: 1736
31
+ - core files: 1737
32
32
  - toolkit files: 160
33
- - template files: 6791
33
+ - template files: 6803
@@ -1,5 +1,15 @@
1
1
  # @agent-native/core
2
2
 
3
+ ## 0.124.4
4
+
5
+ ### Patch Changes
6
+
7
+ - c849ba0: Recover clicked routes in the desktop app when a stale lazy route chunk is encountered.
8
+ - c849ba0: Label final-response-guard corrective retries as framework directives. They are
9
+ appended as user-role messages, so an unlabeled one reads like an injected user
10
+ turn — models were refusing them out loud to the real user ("this message looks
11
+ like a prompt injection attempt") instead of revising the draft.
12
+
3
13
  ## 0.124.3
4
14
 
5
15
  ### Patch Changes
@@ -1,13 +1,13 @@
1
1
  ---
2
2
  title: "Templates"
3
- description: "Fork a working SaaS product and make it yours — agent included."
3
+ description: "Start from a working SaaS product and make it yours — agent included."
4
4
  ---
5
5
 
6
6
  # Templates
7
7
 
8
8
  Want to ship your own AI-powered analytics tool? Mail client? Forms builder? Pick a template, and you've got a working SaaS in minutes — agent, database, auth, and deploy pipeline already wired up.
9
9
 
10
- Most starter templates give you a blank scaffold and a long TODO list. Agent-native flips that. Each template is a **complete, SaaS-grade product** — already runnable on day one, already shippable, and entirely yours to customize, brand, and deploy. Think of them as cloneable SaaS, not starter kits: you're forking a finished product, not staring at boilerplate.
10
+ Most starter templates give you a blank scaffold and a long TODO list. Agent-native flips that. Each template is a **complete, SaaS-grade product** — already runnable on day one, already shippable, and entirely yours to customize, brand, and deploy. Think of them as Cloneable SaaS, not starter kits: you're starting from a finished product, not staring at boilerplate.
11
11
 
12
12
  Building a workflow with no browser UI at all — a Slack bot, a nightly report, a webhook responder? See [Automation-First Apps](/docs/pure-agent-apps) instead; the templates on this page all ship a full browser UI alongside the agent.
13
13
 
@@ -52,7 +52,7 @@ This isn't a theoretical claim. The framework's author runs his actual inbox on
52
52
 
53
53
  The path from "I want my own SaaS" to "I have my own SaaS" is short:
54
54
 
55
- <Diagram id="doc-block-1ab5jb9" title="Fork and customize" summary="Pick a finished product, brand it, evolve it in plain English, and ship it to your own domain.">
55
+ <Diagram id="doc-block-1ab5jb9" title="Start from a working app" summary="Pick a finished product, brand it, evolve it in plain English, and ship it to your own domain.">
56
56
 
57
57
  ```html
58
58
  <div class="diagram-fork">
@@ -105,18 +105,18 @@ The path from "I want my own SaaS" to "I have my own SaaS" is short:
105
105
  3. **Customize it.** Ask the agent to add the column you need, change how the inbox groups, connect to your internal API, add a new view. The agent edits the code; you review the diff.
106
106
  4. **Ship it.** Run the deploy command. You now have your own production SaaS at your own domain.
107
107
 
108
- Steps 2–4 typically take days, not months. Step 3 is open-ended — your forked SaaS evolves over time, in plain English, by talking to the agent.
108
+ Steps 2–4 typically take days, not months. Step 3 is open-ended — your customized SaaS evolves over time, in plain English, by talking to the agent.
109
109
 
110
110
  ## Why this is practical {#why}
111
111
 
112
- A traditional fork-the-codebase model breaks down at scale: every user maintaining their own inbox sounds like a maintenance nightmare. Two framework decisions make it work:
112
+ A separate-codebase-per-user model breaks down at scale: every user maintaining their own inbox sounds like a maintenance nightmare. Two framework decisions make it work:
113
113
 
114
- 1. **The agent does the maintenance.** You don't write code to add a column or wire a new integration — you ask the agent. So "your own forked inbox" is a feature, not a burden.
114
+ 1. **The agent does the maintenance.** You don't write code to add a column or wire a new integration — you ask the agent. So "your own customized inbox" is a feature, not a burden.
115
115
  2. **Per-user customization without per-user code.** Skills, memory, instructions, connected MCP servers, and sub-agents all live in SQL. Every user gets their own customization layer; the shared codebase hosts all of them at once.
116
116
 
117
117
  The result: Claude-Code-level flexibility for each user, with normal SaaS deployment economics.
118
118
 
119
- <Diagram id="doc-block-bhg7mw" title="Why per-user forks scale" summary={"Two ideas keep the fork-and-customize model practical: the agent does the maintenance, and per-user customization lives in SQL — not in per-user code."}>
119
+ <Diagram id="doc-block-bhg7mw" title="Why per-user customization scales" summary={"Two ideas keep the start-from-a-working-app model practical: the agent does the maintenance, and per-user customization lives in SQL — not in per-user code."}>
120
120
 
121
121
  ```html
122
122
  <div class="diagram-why">
@@ -159,9 +159,9 @@ The result: Claude-Code-level flexibility for each user, with normal SaaS deploy
159
159
 
160
160
  </Diagram>
161
161
 
162
- ## Don't want to fork? {#hosted}
162
+ ## Don't want to customize? {#hosted}
163
163
 
164
- You don't have to. Every example app is also available as a hosted app on `agent-native.com` — `mail.agent-native.com`, `calendar.agent-native.com`, and so on. Use the hosted version for free or paid; fork only when you want to change something the hosted version doesn't expose.
164
+ You don't have to. Every example app is also available as a hosted app on `agent-native.com` — `mail.agent-native.com`, `calendar.agent-native.com`, and so on. Use the hosted version for free or paid; create your own app from a template when you want to change something the hosted version doesn't expose.
165
165
 
166
166
  ## Try it with a skill {#try-with-a-skill}
167
167
 
@@ -5,7 +5,7 @@ description: "How to create and publish your own agent-native app templates."
5
5
 
6
6
  # Creating Templates
7
7
 
8
- Templates are complete, forkable agent-native apps that solve a real workflow. The first-party templates are built with the same framework surface you use: React routes for the UI, Drizzle SQL for data, actions for operations, workspace resources for agent behavior, and polling sync so the agent and UI stay aligned.
8
+ Templates are complete, cloneable agent-native apps that solve a real workflow. The first-party templates are built with the same framework surface you use: React routes for the UI, Drizzle SQL for data, actions for operations, workspace resources for agent behavior, and polling sync so the agent and UI stay aligned.
9
9
 
10
10
  Use `@agent-native/core` for the runtime contract: actions, server plugins,
11
11
  database helpers, app state, routing helpers, and agent chat. Use
@@ -536,6 +536,6 @@ workspace pointed at current build output.
536
536
  - [**Multi-App Workspace**](/docs/multi-app-workspace) — make the template fit
537
537
  naturally alongside sibling apps and Dispatch.
538
538
  - [**Syncing Template Changes**](/docs/syncing-template-changes) — pull later
539
- upstream template fixes into an app that already forked from it.
539
+ upstream template fixes into an app that was already created from it.
540
540
  - [**Templates**](/docs/cloneable-saas) — turn a template into a
541
541
  publishable product you can share and deploy.
@@ -441,6 +441,29 @@ export default defineConfig({
441
441
  });
442
442
  ```
443
443
 
444
+ ## Cloudflare Workers {#cloudflare-workers}
445
+
446
+ Use Nitro's native module output for a Cloudflare Worker. This keeps SSR
447
+ enabled and emits the Worker entry point plus static assets under
448
+ `.output/server` and `.output/public`:
449
+
450
+ ```ts filename="vite.config.ts"
451
+ export default defineConfig({
452
+ plugins: [agentNative({ nitro: { preset: "cloudflare_module" } })],
453
+ });
454
+ ```
455
+
456
+ Build and deploy the generated Worker with Wrangler:
457
+
458
+ ```bash
459
+ npx @agent-native/core@latest build
460
+ npx wrangler deploy --config .output/server/wrangler.json
461
+ ```
462
+
463
+ You can also select the preset explicitly with
464
+ `NITRO_PRESET=cloudflare_module`. Configure a durable external SQL database
465
+ before deploying; a Worker filesystem is not a persistent application store.
466
+
444
467
  ## AWS Lambda {#aws-lambda}
445
468
 
446
469
  ```ts filename="vite.config.ts"
@@ -20,7 +20,7 @@ Agent-native is for people who want a real app and an AI agent to work from the
20
20
  - **Use a hosted app** if you want Mail, Calendar, Forms, Plan, or another finished template with no setup — start at the [template gallery](/templates).
21
21
  - **Start with Chat** if you want the default from-scratch path: users can talk to the agent immediately, then you extend with actions, native results, and screens — start with [Getting Started](/docs/getting-started) or [Chat](/docs/template-chat).
22
22
  - **Start automation-first** if you are building scheduled jobs, queues, scripts, integration workers, or external-agent workflows with no browser UI yet — start with [Automation-First Apps](/docs/pure-agent-apps).
23
- - **Fork and customize a template** if you want your own SaaS product with auth, database, UI, and agent actions already wired — see [Templates](/docs/cloneable-saas).
23
+ - **Start from a template and customize it** if you want your own SaaS product with auth, database, UI, and agent actions already wired — see [Templates](/docs/cloneable-saas).
24
24
  - **Build from scratch** if you want the framework primitives for a new agent-driven product — start with [Getting Started](/docs/getting-started).
25
25
  - **Connect another agent or code tool** if you want Claude, ChatGPT, Codex, Cursor, or GitHub Copilot / VS Code to use an agent-native app — see [External Agents](/docs/external-agents) and [Skills Guide](/docs/skills-guide).
26
26
 
@@ -126,13 +126,13 @@ The framework ships with production-ready templates including [Chat](/docs/templ
126
126
 
127
127
  ### Can I customize templates? {#can-i-customize-templates}
128
128
 
129
- That's the whole point. Fork a template and customize it by asking the agent. "Add a priority field to forms." "Connect to our Salesforce instance." "Change the color scheme to match our brand." The agent modifies the code, and your app evolves over time.
129
+ That's the whole point. Start from a template and customize it by asking the agent. "Add a priority field to forms." "Connect to our Salesforce instance." "Change the color scheme to match our brand." The agent modifies the code, and your app evolves over time.
130
130
 
131
131
  ### Can I build something the templates don't cover? {#build-from-scratch}
132
132
 
133
133
  Yes. If you want a basic agentic app, run `npx @agent-native/core@latest create my-chat-app --template chat`; you get durable chat threads, actions, auth, SQL-backed runtime state, native inline result rendering, and room to add your own screens. If you are building a no-browser automation, run `npx @agent-native/core@latest create my-agent --headless`. See [Getting Started](/docs/getting-started), [Automation-First Apps](/docs/pure-agent-apps), and [Chat](/docs/template-chat).
134
134
 
135
- ### Can I try it without forking a template? {#try-with-a-skill}
135
+ ### Can I try it without starting from a template? {#try-with-a-skill}
136
136
 
137
137
  Yes — install a skill into a coding agent you already use with one command and no scaffold required. See the [Skills Guide](/docs/skills-guide#app-backed-skills) for the walkthrough.
138
138
 
@@ -252,6 +252,6 @@ The shared database, live sync, actions system, and application state only work
252
252
 
253
253
  - [**Getting Started**](/docs/getting-started) — build your first action and render it inline in chat
254
254
  - [**What Is Agent-Native?**](/docs/what-is-agent-native) — the full explanation behind the answers above
255
- - [**Templates**](/docs/cloneable-saas) — fork a complete SaaS product instead of starting from scratch
255
+ - [**Templates**](/docs/cloneable-saas) — start from a complete SaaS product instead of starting from scratch
256
256
  - [**Key Concepts**](/docs/key-concepts) — the architecture: SQL, actions, polling sync, and portability
257
257
  - [**Deployment**](/docs/deployment) — host on your own domain or any Nitro-compatible provider
@@ -403,7 +403,7 @@ This is a feature, not a bug. The agent can safely edit the app's source code: c
403
403
 
404
404
  There's no shared codebase to break. You own the app, and the agent evolves it for you over time:
405
405
 
406
- 1. Fork a template (e.g. the analytics template)
406
+ 1. Start from a template (e.g. the analytics template)
407
407
  2. Customize it by asking the agent
408
408
  3. "Add a new chart type for cohort analysis" — the agent builds it
409
409
  4. "Connect to our Stripe account" — the agent writes the integration
@@ -35,7 +35,7 @@ Anything every app in your org should agree on can live in `packages/shared`:
35
35
 
36
36
  Each individual app becomes _just a set of screens_ — routes, dashboards, views, domain-specific actions. Framework defaults cover the rest until you add a real workspace customization.
37
37
 
38
- That same boundary applies when your app wants to use another first-party app. A new workspace dashboard that needs email, calendar, analytics, and company-memory context should use the existing Mail, Calendar, Analytics, and Brain apps as connected neighbors over links or A2A. It should not clone those templates, create a wrapper app that nests them, or scaffold child apps inside itself just to get access to their data or agents. Fork or scaffold a copy only when you explicitly want to customize that app.
38
+ That same boundary applies when your app wants to use another first-party app. A new workspace dashboard that needs email, calendar, analytics, and company-memory context should use the existing Mail, Calendar, Analytics, and Brain apps as connected neighbors over links or A2A. It should not create wrapper apps that nest them or scaffold child apps inside itself just to get access to their data or agents. Start from a template only when you explicitly want to customize that app.
39
39
 
40
40
  ## Getting started {#getting-started}
41
41
 
@@ -5,7 +5,7 @@ description: "agent-native template pulls later upstream first-party template ch
5
5
 
6
6
  # Syncing Template Changes
7
7
 
8
- `agent-native create` copies a first-party template into your app and then makes it yours — substituting the app name, renaming `_gitignore`, rewriting `package.json`, pinning `workspace:*` and `catalog:` dependencies to concrete versions, and (in a workspace) swapping in inherited auth and chat plugins. From that moment the app is a fork. Fixes and improvements that land in the template upstream do not reach it.
8
+ `agent-native create` copies a first-party template into your app and then makes it yours — substituting the app name, renaming `_gitignore`, rewriting `package.json`, pinning `workspace:*` and `catalog:` dependencies to concrete versions, and (in a workspace) swapping in inherited auth and chat plugins. From that moment the app is an independent app derived from the template. Fixes and improvements that land in the template upstream do not reach it.
9
9
 
10
10
  `agent-native upgrade` does not close that gap. It moves package versions, runs import codemods, and refreshes skill directories — it never touches a file that was copied out of a template.
11
11
 
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  title: "Analytics: Extending the Template"
3
- description: "The data model, action reference, and customization points for forking and extending the Analytics template — dashboards, monitoring, errors, session replay, and the /agents admin surface."
3
+ description: "The data model, action reference, and customization points for customizing and extending the Analytics template — dashboards, monitoring, errors, session replay, and the /agents admin surface."
4
4
  ---
5
5
 
6
6
  # Extending Analytics
7
7
 
8
- This page is for anyone forking the Analytics template or building on it directly: the data model, the action surface, and the places meant to be extended.
8
+ This page is for anyone customizing the Analytics template or building on it directly: the data model, the action surface, and the places meant to be extended.
9
9
 
10
10
  ## Quick start
11
11
 
@@ -115,7 +115,7 @@ Analytics is more than dashboards and the dictionary — here's everywhere you'l
115
115
 
116
116
  ## For developers
117
117
 
118
- Fork the Analytics template from the CLI:
118
+ Create an Analytics app from the template via the CLI:
119
119
 
120
120
  ```bash
121
121
  npx @agent-native/core@latest create my-analytics --standalone --template analytics
@@ -129,6 +129,6 @@ See [Getting Started](/docs/getting-started) for the rest of the setup (installi
129
129
  - [**Monitoring, Errors, and Session Replay**](/docs/template-analytics-monitoring-and-sessions) — uptime, error triage, and replay
130
130
  - [**Connecting and Extending Data Sources**](/docs/template-analytics-connectors) — the full connector catalog and the escape hatches
131
131
  - [**Extending Analytics**](/docs/template-analytics-developers) — data model, actions, and customizing the template
132
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model, and every other domain template to start from
132
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model, and every other domain template to start from
133
133
  - [**Getting Started**](/docs/getting-started) — the framework fundamentals: actions, application state, and live sync
134
134
  - [**Sharing**](/docs/sharing) — the share-grant model dashboards and analyses build on
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  title: "Assets — architecture and data model"
3
- description: "The SQL schema, access-control model, and action reference for developers forking or extending the Assets template."
3
+ description: "The SQL schema, access-control model, and action reference for developers customizing or extending the Assets template."
4
4
  ---
5
5
 
6
6
  # Assets — architecture and data model
7
7
 
8
- This page is for anyone forking the [Assets](/docs/template-assets) template or extending it: the action inventory, data model, access-control rules, and the places to start when you want to change how Assets works.
8
+ This page is for anyone customizing the [Assets](/docs/template-assets) template or extending it: the action inventory, data model, access-control rules, and the places to start when you want to change how Assets works.
9
9
 
10
10
  ## Quick start
11
11
 
@@ -384,7 +384,7 @@ needed:
384
384
 
385
385
  <FileTree
386
386
  id="doc-block-assets11"
387
- title="Where to look when forking Assets"
387
+ title="Where to look when customizing Assets"
388
388
  entries={[
389
389
  {
390
390
  path: "templates/assets/server/db/schema.ts",
@@ -94,7 +94,7 @@ When you open the app, the selected library, prompt, references, and generated c
94
94
  - **Generate, refine, and review through chat or a library** — candidates, feedback, designer handoff, and the admin audit log all live in [Generating, refining, and reviewing assets](/docs/template-assets-generation).
95
95
  - **Build a preset once and let everyone else run it** — a locked prompt template, model, aspect ratio, reference board, and logo policy, so a marketer just pastes a brief and tags the preset. See [Presets: design once, run everywhere](/docs/template-assets-presets).
96
96
  - **Use Assets from another app or agent** — embed the picker, call Assets over A2A or MCP, reuse governed Creative Context, or install the Assets skill in a coding agent. See [Using Assets from other apps and agents](/docs/template-assets-integrations).
97
- - **Fork and extend the template** — the SQL schema, access control, and extension points live in [Assets — architecture and data model](/docs/template-assets-developers).
97
+ - **Create your own app from the template and extend it** — the SQL schema, access control, and extension points live in [Assets — architecture and data model](/docs/template-assets-developers).
98
98
 
99
99
  ## Getting started
100
100
 
@@ -126,6 +126,6 @@ To run your own copy: `npx @agent-native/core@latest create my-assets --standalo
126
126
  - [**Generating, refining, and reviewing assets**](/docs/template-assets-generation) — candidates, feedback, designer handoff, and the audit log
127
127
  - [**Using Assets from other apps and agents**](/docs/template-assets-integrations) — the embedded picker, A2A, Creative Context, and coding-agent install
128
128
  - [**Assets — architecture and data model**](/docs/template-assets-developers) — the SQL schema, access control, and action reference
129
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model
129
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model
130
130
  - [**A2A Protocol**](/docs/a2a-protocol) — how other apps call Assets
131
131
  - [**Sharing & Privacy**](/docs/sharing) — library-level access control
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  title: "Brain: Developer Guide"
3
- description: "Data model, action reference, and extension points for forking or self-hosting the Brain institutional-memory template."
3
+ description: "Data model, action reference, and extension points for customizing or self-hosting the Brain institutional-memory template."
4
4
  ---
5
5
 
6
6
  # Brain: Developer Guide
7
7
 
8
- This page is for anyone forking the Brain template, running it as a service, or wiring another app to call it. It covers the data model, the full action inventory, how source credentials resolve, and where to make changes.
8
+ This page is for anyone customizing the Brain template, running it as a service, or wiring another app to call it. It covers the data model, the full action inventory, how source credentials resolve, and where to make changes.
9
9
 
10
10
  ## Quick start
11
11
 
@@ -191,5 +191,5 @@ action reference.
191
191
  - [**Dispatch**](/docs/dispatch) — the workspace control plane
192
192
  - [**Dispatch template**](/docs/template-dispatch) — the scaffolded coordination app
193
193
  - [**A2A Protocol**](/docs/a2a-protocol) — cross-app delegation
194
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model, and every other domain template to start from
194
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model, and every other domain template to start from
195
195
  - [**Getting Started**](/docs/getting-started) — the framework fundamentals: actions, application state, and live sync
@@ -5,7 +5,7 @@ description: "Quick start, the full action inventory, data model, routes, and ho
5
5
 
6
6
  # Developer Guide
7
7
 
8
- This page is for anyone forking the Calendar template or extending it: the quick start, every action, the data model, the route surface, and how to add to it. See [Calendar](/docs/template-calendar) for what the app does.
8
+ This page is for anyone customizing the Calendar template or extending it: the quick start, every action, the data model, the route surface, and how to add to it. See [Calendar](/docs/template-calendar) for what the app does.
9
9
 
10
10
  ## Quick start
11
11
 
@@ -131,7 +131,7 @@ The agent will query Google Calendar live for any schedule question — it never
131
131
  - [**Booking Links**](/docs/template-calendar-booking-links) — creating, sharing, and managing Calendly-style booking pages
132
132
  - [**Talking to the Agent**](/docs/template-calendar-agent) — prompts by task, application state, and Extensions
133
133
  - [**Developer Guide**](/docs/template-calendar-developers) — quick start, actions, data model, and routes
134
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model, and every other domain template to start from
134
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model, and every other domain template to start from
135
135
  - [**Getting Started**](/docs/getting-started) — the framework fundamentals: actions, application state, and live sync
136
136
  - [**Mail**](/docs/template-mail) — a sibling domain template covering inbox and automations
137
137
  - [**Automations**](/docs/automations) — trigger jobs off calendar and booking events
@@ -130,7 +130,7 @@ Use it for scheduled jobs, queues, CLI loops, or external-agent workflows where
130
130
  - [**Your first feature in Chat**](/docs/template-chat-first-edits) — the starter chat route, annotated, plus a full walkthrough of adding a real feature
131
131
  - [**Chat — runtime and admin surfaces**](/docs/template-chat-developers) — core tables, auth, and the Database/Observability/Extensions pages that ship by default
132
132
  - [**Getting Started**](/docs/getting-started) — build the chat-first path from action to inline result to app page
133
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model, and every domain template to start from instead
133
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model, and every domain template to start from instead
134
134
  - [**Agent Surfaces**](/docs/agent-surfaces) — chat, inline UI, app pages, embedded, automation, and external-agent patterns
135
135
  - [**Actions**](/docs/actions) — the action system chat and UI both call
136
136
  - [**Native Chat UI**](/docs/native-chat-ui) — chat surface primitives and runtime options
@@ -1,12 +1,12 @@
1
1
  ---
2
2
  title: "Extending Clips"
3
- description: "Data model, action reference, and setup steps for forking, self-hosting, or extending the Clips template — recordings, transcripts, meetings, organizations, and the Chrome extension/bug-report embed."
3
+ description: "Data model, action reference, and setup steps for customizing, self-hosting, or extending the Clips template — recordings, transcripts, meetings, organizations, and the Chrome extension/bug-report embed."
4
4
  search: "Clips developers data model actions schema self-host Chrome extension bug report embed"
5
5
  ---
6
6
 
7
7
  # Extending Clips
8
8
 
9
- The rest of this doc is for anyone forking the Clips template, self-hosting it, or extending it with new capabilities.
9
+ The rest of this doc is for anyone customizing the Clips template, self-hosting it, or extending it with new capabilities.
10
10
 
11
11
  ## Quick start
12
12
 
@@ -351,7 +351,7 @@ Every agent-callable operation is a TypeScript file in `templates/clips/actions/
351
351
 
352
352
  ## Customizing it
353
353
 
354
- Clips is a complete, cloneable template — fork it and ask the agent to extend it. Some examples:
354
+ Clips is a complete, cloneable template — start from it and ask the agent to extend it. Some examples:
355
355
 
356
356
  - "Add a filler-word removal button that strips ums and uhs from the transcript and re-stitches the video."
357
357
  - "Auto-post my standup notes to Slack #eng whenever a meeting ends." (Connect Slack first via [Messaging](/docs/messaging).)
@@ -368,6 +368,6 @@ The agent edits routes, components, the transcript pipeline, and the schema as n
368
368
  - [**Capturing Everywhere**](/docs/template-clips-capture-everywhere) — desktop, mobile, Rewind, Screen Memory, and the Chrome extension from a user's perspective
369
369
  - [**Sharing, Teams, and Agent-Readable Clips**](/docs/template-clips-sharing-and-teams) — the sharing model this data model backs
370
370
  - [**AI Pipeline, Editing, and Insights**](/docs/template-clips-ai-and-editing) — the transcription and editing pipeline these actions power
371
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model
371
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model
372
372
  - [**Context Awareness**](/docs/context-awareness) — how the agent knows the current clip and playhead
373
373
  - [**Agent Teams**](/docs/agent-teams) — delegate transcript cleanup to a specialist sub-agent
@@ -113,7 +113,7 @@ Live demo: [clips.agent-native.com](https://clips.agent-native.com).
113
113
  - [**Capturing Everywhere**](/docs/template-clips-capture-everywhere) — the desktop app, the mobile companion, Rewind quick-save, Screen Memory, and the Chrome extension.
114
114
  - [**Sharing, Teams, and Agent-Readable Clips**](/docs/template-clips-sharing-and-teams) — visibility, passwords, organizations, and pasting a clip link into an agent.
115
115
  - [**AI Pipeline, Editing, and Insights**](/docs/template-clips-ai-and-editing) — transcription, non-destructive editing, and view analytics.
116
- - [**Extending Clips**](/docs/template-clips-developers) — for anyone forking or extending the template.
117
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model
116
+ - [**Extending Clips**](/docs/template-clips-developers) — for anyone customizing or extending the template.
117
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model
118
118
  - [**Context Awareness**](/docs/context-awareness) — how the agent knows the current clip and playhead
119
119
  - [**Agent Teams**](/docs/agent-teams) — delegate transcript cleanup to a specialist sub-agent
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  title: "Content: Developer Guide"
3
- description: "Data model, action inventory, routes, and extension points for forking or extending the Content template."
3
+ description: "Data model, action inventory, routes, and extension points for customizing or extending the Content template."
4
4
  ---
5
5
 
6
6
  # Content: Developer Guide
7
7
 
8
- This page is for anyone forking the Content template or building on it: the full data model, every action grouped by area, the route surface, and the places to look when adding a feature. If you're looking for how to use the app day to day, see the [Content overview](/docs/template-content) and its linked pages instead.
8
+ This page is for anyone customizing the Content template or building on it: the full data model, every action grouped by area, the route surface, and the places to look when adding a feature. If you're looking for how to use the app day to day, see the [Content overview](/docs/template-content) and its linked pages instead.
9
9
 
10
10
  ## Quick start
11
11
 
@@ -117,7 +117,7 @@ See [Getting started](/docs/getting-started) for the rest of the setup (`cd`, `p
117
117
  - [**Databases, properties & forms**](/docs/template-content-databases) — inline databases, property types, views, external sources, and intake forms
118
118
  - [**Local files, Notion & Builder CMS sync**](/docs/template-content-sync) — the Obsidian-style folder workflow plus Notion and Builder CMS round-trips
119
119
  - [**Developer Guide**](/docs/template-content-developers) — data model, action inventory, routes, and how to extend the template
120
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model, and every other domain template to start from
120
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model, and every other domain template to start from
121
121
  - [**Getting Started**](/docs/getting-started) — the framework fundamentals: actions, application state, and live sync
122
122
  - [**Real-Time Collaboration**](/docs/real-time-collaboration) — the Yjs pipeline documents share with other collaborative surfaces
123
123
  - [**Sharing**](/docs/sharing) — the share-grant model documents build on
@@ -18,7 +18,7 @@ Every design system also carries an optional set of custom instructions and a de
18
18
  - **Website** — paste a URL and Design pulls colors, fonts, the favicon, and the social preview image straight off the live site.
19
19
  - **GitHub repo or code files** — Design indexes the actual CSS and tokens from your codebase, so the system matches what's really deployed rather than a guess.
20
20
  - **Documents** — DOCX, PPTX, or PDF uploads; presentations are usually the strongest signal for brand colors and fonts.
21
- - **An existing design or design system** — fork one you already have instead of starting over.
21
+ - **An existing design or design system** — start from one you already have instead of starting over.
22
22
 
23
23
  When several sources come in together, Design cross-references them — code sources are the most trustworthy, the website confirms what's actually shipped, documents fill in gaps — before merging everything into one system.
24
24
 
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  title: "Extending Design"
3
- description: "The data model, action reference, and editor extension points for forking or building on the Design template."
3
+ description: "The data model, action reference, and editor extension points for customizing or building on the Design template."
4
4
  ---
5
5
 
6
6
  # Extending Design
7
7
 
8
- This page is for anyone forking the Design template or building on top of it directly: the data model, the full action surface, and how the editor's overview canvas and extension points fit together.
8
+ This page is for anyone customizing the Design template or building on top of it directly: the data model, the full action surface, and how the editor's overview canvas and extension points fit together.
9
9
 
10
10
  ### Quick start
11
11
 
@@ -118,7 +118,7 @@ Live demo: [design.agent-native.com](https://design.agent-native.com).
118
118
  - "Turn this repeated card into a reusable component."
119
119
  - "Export this prototype as a ZIP once the final variant is selected."
120
120
 
121
- Building on Design or forking the template? See [Extending Design](/docs/template-design-developers).
121
+ Building on Design or customizing the template? See [Extending Design](/docs/template-design-developers).
122
122
 
123
123
  ## What's next
124
124
 
@@ -126,5 +126,5 @@ Building on Design or forking the template? See [Extending Design](/docs/templat
126
126
  - [**Quality Passes and Components**](/docs/template-design-quality-and-components) — the audit/screenshot pass, reusable components, motion, shaders
127
127
  - [**Review, Handoff, and Full Apps**](/docs/template-design-collaboration-and-full-apps) — visual editing, review feedback, export, and fusion mode
128
128
  - [**Extending Design**](/docs/template-design-developers) — data model, actions, and editor extension points
129
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model
129
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model
130
130
  - [**Context Awareness**](/docs/context-awareness) — how the agent knows what the user is viewing
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  title: "Dispatch — architecture for developers"
3
- description: "How Dispatch's package and generated-app source are split, the orchestrator's remote agent registry, scaffolding a workspace with Dispatch, and customizing or remixing a curated workspace template."
3
+ description: "How Dispatch's package and generated-app source are split, the orchestrator's remote agent registry, scaffolding a workspace with Dispatch, and customizing a curated workspace template."
4
4
  ---
5
5
 
6
6
  # Dispatch — architecture for developers
7
7
 
8
- This page is for engineers extending Dispatch or forking the template: how the orchestrator finds other agents, how the published package and your generated app source are split, and how to add your own management screens or spin up a private remix of another template.
8
+ This page is for engineers extending Dispatch or customizing the template: how the orchestrator finds other agents, how the published package and your generated app source are split, and how to add your own management screens or create a private app from another template.
9
9
 
10
10
  ## Orchestrator agent and remote agent registry {#orchestrator}
11
11
 
@@ -104,12 +104,12 @@ For workspace-specific management screens, add local React Router pages and regi
104
104
  ]}
105
105
  />
106
106
 
107
- ## Curated workspace template remix {#remix}
107
+ ## Create an app from a curated workspace template {#remix}
108
108
 
109
- Curated workspace templates are private remix sources for spinning up an independent app from a reviewed template — mail, calendar, analytics, slides, content, clips, brain, assets, forms, or design.
109
+ Curated workspace templates are reviewed sources for creating an independent private app — mail, calendar, analytics, slides, content, clips, brain, assets, forms, or design.
110
110
 
111
111
  - **`list-curated-workspace-templates`** returns the reviewed catalog: stable metadata, the live product URL, setup guidance, and whether each source template is already installed in the current workspace.
112
- - **`remix-workspace-template`** creates a private, independent copy. In a local runtime it scaffolds the template directly; in a hosted workspace it starts a Builder app-creation branch instead. Either way, the remix defaults to a `<template>-remix` app id, and the request is required to use empty or synthetic seed data only — it must never copy the source app's records, credentials, secrets, or private configuration.
112
+ - **`remix-workspace-template`** creates a private, independent app. In a local runtime it scaffolds the template directly; in a hosted workspace it starts a Builder app-creation branch instead. The existing action and `<template>-remix` app id remain stable for compatibility, while the request is required to use empty or synthetic seed data only — it must never copy the source app's records, credentials, secrets, or private configuration.
113
113
 
114
114
  ## What's next
115
115
 
@@ -5,7 +5,7 @@ description: "The Forms template's SQL schema, its full action reference, and ho
5
5
 
6
6
  # Forms — data model and actions
7
7
 
8
- This page is for developers forking or extending the Forms template. It covers the SQL schema, every action the agent and UI call, and how to add new capabilities. For what the app does day to day, see [Forms](/docs/template-forms); for field types, publishing, and public-form protections, see [Building and publishing a form](/docs/template-forms-building-publishing); for response handling, see [Responses, insights, and destinations](/docs/template-forms-responses).
8
+ This page is for developers customizing or extending the Forms template. It covers the SQL schema, every action the agent and UI call, and how to add new capabilities. For what the app does day to day, see [Forms](/docs/template-forms); for field types, publishing, and public-form protections, see [Building and publishing a form](/docs/template-forms-building-publishing); for response handling, see [Responses, insights, and destinations](/docs/template-forms-responses).
9
9
 
10
10
  ### Quick start
11
11
 
@@ -115,6 +115,6 @@ Live demo: [forms.agent-native.com](https://forms.agent-native.com).
115
115
  - [**Building and publishing a form**](/docs/template-forms-building-publishing) — field types, conditional logic, and public-form protections
116
116
  - [**Responses, insights, and destinations**](/docs/template-forms-responses) — analyzing, exporting, and routing submissions
117
117
  - [**Forms — data model and actions**](/docs/template-forms-developers) — the SQL schema and action reference, for developers
118
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model
118
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model
119
119
  - [**Actions**](/docs/actions) — the action system powering the builder
120
120
  - [**Messaging**](/docs/messaging) — Slack and other submission destinations
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  title: "Mail: Developer Guide"
3
- description: "Actions, data model, routes, and customization points for the Mail template — everything you need to fork or extend the agent-native Gmail client."
3
+ description: "Actions, data model, routes, and customization points for the Mail template — everything you need to customize or extend the agent-native Gmail client."
4
4
  ---
5
5
 
6
6
  # Developer Guide
7
7
 
8
- This page is for anyone forking the [Mail](/docs/template-mail) template or extending it: the action inventory, data model, route map, and the places to start when you want to change how Mail works.
8
+ This page is for anyone customizing the [Mail](/docs/template-mail) template or extending it: the action inventory, data model, route map, and the places to start when you want to change how Mail works.
9
9
 
10
10
  ## Quick start
11
11
 
@@ -93,7 +93,7 @@ When you open the app, the keyboard-first inbox and thread view stay focused on
93
93
  - **Draft, schedule, and send** in your own voice, and let a teammate queue a draft for you to review before it goes out — see [Drafting, Scheduling & the Draft Queue](/docs/template-mail-drafts-and-queue).
94
94
  - **Pull CRM context onto a thread.** Look up a sender's HubSpot contact, deals, and tickets without leaving Mail.
95
95
  - **Talk to the agent directly** from a full-page Agent tab, with the same screen awareness as chat — see [Talking to the Agent](/docs/template-mail-agent).
96
- - **Extend Mail** with a custom sidebar widget, or fork the whole template — see the [Developer Guide](/docs/template-mail-developers).
96
+ - **Extend Mail** with a custom sidebar widget, or create your own app from the template — see the [Developer Guide](/docs/template-mail-developers).
97
97
 
98
98
  ## Getting started
99
99
 
@@ -120,6 +120,6 @@ Without a Google account connected, the app runs against an empty local mailbox
120
120
  - [**Drafting, Scheduling & the Draft Queue**](/docs/template-mail-drafts-and-queue) — composing, scheduled sends, and teammate-requested drafts
121
121
  - [**Talking to the Agent**](/docs/template-mail-agent) — useful prompts, screen awareness, and when to escalate to a raw provider call
122
122
  - [**Developer Guide**](/docs/template-mail-developers) — actions, data model, routes, and how to customize Mail
123
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model, and every other domain template to start from
123
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model, and every other domain template to start from
124
124
  - [**Calendar**](/docs/template-calendar) — a sibling domain template covering scheduling and booking
125
125
  - [**Getting Started**](/docs/getting-started) — the framework fundamentals: actions, application state, and live sync
@@ -1,11 +1,11 @@
1
1
  ---
2
2
  title: "Extending Plan"
3
- description: "The Plan template's data model, action surface, custom MDX block system, and route map — for anyone forking or self-hosting Agent-Native Plan."
3
+ description: "The Plan template's data model, action surface, custom MDX block system, and route map — for anyone customizing or self-hosting Agent-Native Plan."
4
4
  ---
5
5
 
6
6
  # Extending Plan
7
7
 
8
- This page is for anyone forking or self-hosting the Plan template, or writing
8
+ This page is for anyone customizing or self-hosting the Plan template, or writing
9
9
  a coding agent integration against its actions directly. Most users should
10
10
  install the skill with the CLI instead of scaffolding the app — see
11
11
  [Visual Plans](/docs/template-plan).
@@ -700,4 +700,4 @@ a separate, advanced path — not the default hosted flow.
700
700
  - [**Local-Files Mode and Desktop Sync**](/docs/template-plan-local-and-desktop) — the MDX source-sync actions in practice
701
701
  - [**Events and Automations**](/docs/template-plan-automations) — the event bus these actions write to
702
702
  - [**Extensions**](/docs/extensions) — the shared mini-app system Plan installs
703
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model
703
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model
@@ -11,7 +11,7 @@ description: "Agent-Native Plans turns your coding agent's plan into a structure
11
11
  adds the `/visual-plan`, `/visual-recap`, and `/visualize-repo` skills plus
12
12
  the hosted Plan connector to your coding agent — see
13
13
  [Plan plugin & marketplace](/docs/plan-plugin) for the plugin and marketplace
14
- routes. Forking the Plan template (covered under [Extending Plan](/docs/template-plan-developers))
14
+ routes. Customizing the Plan template (covered under [Extending Plan](/docs/template-plan-developers))
15
15
  is the secondary path, for self-hosting or building on Plan itself.
16
16
 
17
17
  </Callout>
@@ -279,9 +279,9 @@ registry to update.
279
279
  - [**Reviewing and Commenting on Plans**](/docs/template-plan-review-workflow) — comment types, resolving feedback, sharing, and deleting plans
280
280
  - [**Local-Files Mode and Desktop Sync**](/docs/template-plan-local-and-desktop) — keep plan content off the hosted database, or mirror it to a folder
281
281
  - [**Events and Automations**](/docs/template-plan-automations) — the plan event bus and automation recipes
282
- - [**Extending Plan**](/docs/template-plan-developers) — data model, actions, and custom MDX blocks for forking or self-hosting Plan
282
+ - [**Extending Plan**](/docs/template-plan-developers) — data model, actions, and custom MDX blocks for customizing or self-hosting Plan
283
283
  - [**PR Visual Recap**](/docs/pr-visual-recap) — run `/visual-recap` automatically on every pull request
284
284
  - [**Plan plugin & marketplace**](/docs/plan-plugin) — install the Plan skills as a Claude Code or Codex plugin
285
285
  - [**Skills**](/docs/skills-guide) — how Agent-Native installs skills
286
286
  - [**MCP Clients**](/docs/mcp-clients) — configuring hosted MCP connectors
287
- - [**Templates**](/docs/cloneable-saas) — the clone-and-own model
287
+ - [**Templates**](/docs/cloneable-saas) — the Cloneable SaaS model