@raybase/create 0.0.1 → 0.3.3

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 (644) hide show
  1. package/LICENSE +21 -0
  2. package/THIRD_PARTY_NOTICES.md +38 -0
  3. package/assets/apple-touch-icons/0.png +0 -0
  4. package/assets/apple-touch-icons/1.png +0 -0
  5. package/assets/apple-touch-icons/2.png +0 -0
  6. package/assets/apple-touch-icons/3.png +0 -0
  7. package/assets/apple-touch-icons/4.png +0 -0
  8. package/assets/apple-touch-icons/5.png +0 -0
  9. package/assets/apple-touch-icons/6.png +0 -0
  10. package/assets/apple-touch-icons/7.png +0 -0
  11. package/assets/apple-touch-icons/8.png +0 -0
  12. package/assets/apple-touch-icons/9.png +0 -0
  13. package/assets/apple-touch-icons/A.png +0 -0
  14. package/assets/apple-touch-icons/B.png +0 -0
  15. package/assets/apple-touch-icons/C.png +0 -0
  16. package/assets/apple-touch-icons/D.png +0 -0
  17. package/assets/apple-touch-icons/E.png +0 -0
  18. package/assets/apple-touch-icons/F.png +0 -0
  19. package/assets/apple-touch-icons/G.png +0 -0
  20. package/assets/apple-touch-icons/H.png +0 -0
  21. package/assets/apple-touch-icons/I.png +0 -0
  22. package/assets/apple-touch-icons/J.png +0 -0
  23. package/assets/apple-touch-icons/K.png +0 -0
  24. package/assets/apple-touch-icons/L.png +0 -0
  25. package/assets/apple-touch-icons/M.png +0 -0
  26. package/assets/apple-touch-icons/N.png +0 -0
  27. package/assets/apple-touch-icons/O.png +0 -0
  28. package/assets/apple-touch-icons/P.png +0 -0
  29. package/assets/apple-touch-icons/Q.png +0 -0
  30. package/assets/apple-touch-icons/R.png +0 -0
  31. package/assets/apple-touch-icons/S.png +0 -0
  32. package/assets/apple-touch-icons/T.png +0 -0
  33. package/assets/apple-touch-icons/U.png +0 -0
  34. package/assets/apple-touch-icons/V.png +0 -0
  35. package/assets/apple-touch-icons/W.png +0 -0
  36. package/assets/apple-touch-icons/X.png +0 -0
  37. package/assets/apple-touch-icons/Y.png +0 -0
  38. package/assets/apple-touch-icons/Z.png +0 -0
  39. package/assets/apple-touch-icons/default.png +0 -0
  40. package/dist/.source-hash +1 -0
  41. package/dist/index.d.ts +56 -0
  42. package/dist/index.d.ts.map +1 -0
  43. package/dist/index.js +2351 -0
  44. package/dist/index.js.map +1 -0
  45. package/dist/raybase-package-ranges.d.ts +11 -0
  46. package/dist/raybase-package-ranges.d.ts.map +1 -0
  47. package/dist/raybase-package-ranges.js +11 -0
  48. package/dist/raybase-package-ranges.js.map +1 -0
  49. package/dist/source-fetch.d.ts +91 -0
  50. package/dist/source-fetch.d.ts.map +1 -0
  51. package/dist/source-fetch.js +325 -0
  52. package/dist/source-fetch.js.map +1 -0
  53. package/dist/source-hash.d.ts +2 -0
  54. package/dist/source-hash.d.ts.map +1 -0
  55. package/dist/source-hash.js +23 -0
  56. package/dist/source-hash.js.map +1 -0
  57. package/dist/starter-description.d.ts +44 -0
  58. package/dist/starter-description.d.ts.map +1 -0
  59. package/dist/starter-description.js +273 -0
  60. package/dist/starter-description.js.map +1 -0
  61. package/dist/starter-source.d.ts +43 -0
  62. package/dist/starter-source.d.ts.map +1 -0
  63. package/dist/starter-source.js +156 -0
  64. package/dist/starter-source.js.map +1 -0
  65. package/dist/store-app-apply.d.ts +27 -0
  66. package/dist/store-app-apply.d.ts.map +1 -0
  67. package/dist/store-app-apply.js +100 -0
  68. package/dist/store-app-apply.js.map +1 -0
  69. package/dist/store-app-manifest.d.ts +86 -0
  70. package/dist/store-app-manifest.d.ts.map +1 -0
  71. package/dist/store-app-manifest.js +110 -0
  72. package/dist/store-app-manifest.js.map +1 -0
  73. package/dist/store-app-registry.d.ts +30 -0
  74. package/dist/store-app-registry.d.ts.map +1 -0
  75. package/dist/store-app-registry.js +232 -0
  76. package/dist/store-app-registry.js.map +1 -0
  77. package/models/recommended.json +42 -0
  78. package/modules/api/templates/react-router/app/api/operations.ts +8 -0
  79. package/modules/api/templates/tanstack-start/src/api/operations.ts +15 -0
  80. package/modules/docs/templates/astro-emdash/content/docs/getting-started.mdx +13 -0
  81. package/modules/docs/templates/astro-emdash/content/docs/index.mdx +13 -0
  82. package/modules/docs/templates/astro-emdash/content/docs/mcp.mdx +11 -0
  83. package/modules/docs/templates/astro-emdash/content/docs/meta.json +4 -0
  84. package/modules/docs/templates/astro-emdash/site/content/docs/getting-started.mdx +12 -0
  85. package/modules/docs/templates/astro-emdash/site/content/docs/index.mdx +12 -0
  86. package/modules/docs/templates/astro-emdash/site/content/docs/mcp.mdx +10 -0
  87. package/modules/docs/templates/astro-emdash/site/content/docs/meta.json +4 -0
  88. package/modules/docs/templates/astro-emdash/site/source.config.ts +10 -0
  89. package/modules/docs/templates/astro-emdash/site/src/docs/docs-assets.ts +1 -0
  90. package/modules/docs/templates/astro-emdash/site/src/docs/docs-client.tsx +22 -0
  91. package/modules/docs/templates/astro-emdash/site/src/docs/docs-data.ts +24 -0
  92. package/modules/docs/templates/astro-emdash/site/src/docs/docs-handler.tsx +105 -0
  93. package/modules/docs/templates/astro-emdash/site/src/docs/docs-layout.tsx +56 -0
  94. package/modules/docs/templates/astro-emdash/site/src/docs/docs-mdx.tsx +79 -0
  95. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page-actions.tsx +146 -0
  96. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page.tsx +70 -0
  97. package/modules/docs/templates/astro-emdash/site/src/docs/llm-text.ts +61 -0
  98. package/modules/docs/templates/astro-emdash/site/src/docs/source.ts +7 -0
  99. package/modules/docs/templates/astro-emdash/site/src/pages/docs/[...slug].ts +6 -0
  100. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/markdown.ts +4 -0
  101. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/search.ts +4 -0
  102. package/modules/docs/templates/astro-emdash/site/src/pages/llms.txt.ts +8 -0
  103. package/modules/docs/templates/astro-emdash/site/src/styles-docs.css +3 -0
  104. package/modules/docs/templates/astro-emdash/source.config.ts +10 -0
  105. package/modules/docs/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
  106. package/modules/docs/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
  107. package/modules/docs/templates/astro-emdash/src/docs/docs-data.ts +24 -0
  108. package/modules/docs/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
  109. package/modules/docs/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
  110. package/modules/docs/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
  111. package/modules/docs/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
  112. package/modules/docs/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
  113. package/modules/docs/templates/astro-emdash/src/docs/llm-text.ts +61 -0
  114. package/modules/docs/templates/astro-emdash/src/docs/source.ts +7 -0
  115. package/modules/docs/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
  116. package/modules/docs/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
  117. package/modules/docs/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
  118. package/modules/docs/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
  119. package/modules/docs/templates/astro-emdash/src/routes/docs.tsx +22 -0
  120. package/modules/docs/templates/astro-emdash/src/styles-docs.css +3 -0
  121. package/modules/docs/templates/react-router/app/components/mdx.tsx +79 -0
  122. package/modules/docs/templates/react-router/app/lib/layout.shared.tsx +54 -0
  123. package/modules/docs/templates/react-router/app/lib/source.ts +7 -0
  124. package/modules/docs/templates/react-router/app/routes/docs.$.tsx +49 -0
  125. package/modules/docs/templates/react-router/app/routes/docs.api.search.ts +10 -0
  126. package/modules/docs/templates/react-router/app/routes/docs.tsx +13 -0
  127. package/modules/docs/templates/react-router/content/docs/getting-started.mdx +8 -0
  128. package/modules/docs/templates/react-router/content/docs/index.mdx +8 -0
  129. package/modules/docs/templates/react-router/content/docs/mcp.mdx +121 -0
  130. package/modules/docs/templates/react-router/content/docs/meta.json +4 -0
  131. package/modules/docs/templates/react-router/source.config.ts +5 -0
  132. package/modules/docs/templates/tanstack-start/content/docs/getting-started.mdx +10 -0
  133. package/modules/docs/templates/tanstack-start/content/docs/index.mdx +8 -0
  134. package/modules/docs/templates/tanstack-start/content/docs/mcp.mdx +121 -0
  135. package/modules/docs/templates/tanstack-start/content/docs/meta.json +4 -0
  136. package/modules/docs/templates/tanstack-start/source.config.ts +10 -0
  137. package/modules/docs/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
  138. package/modules/docs/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
  139. package/modules/docs/templates/tanstack-start/src/docs/docs-data.ts +24 -0
  140. package/modules/docs/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
  141. package/modules/docs/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
  142. package/modules/docs/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
  143. package/modules/docs/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
  144. package/modules/docs/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
  145. package/modules/docs/templates/tanstack-start/src/docs/llm-text.ts +61 -0
  146. package/modules/docs/templates/tanstack-start/src/docs/source.ts +7 -0
  147. package/modules/docs/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
  148. package/modules/docs/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
  149. package/modules/docs/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
  150. package/modules/docs/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
  151. package/modules/docs/templates/tanstack-start/src/routes/docs.tsx +22 -0
  152. package/modules/docs/templates/tanstack-start/src/styles-docs.css +3 -0
  153. package/modules/guide/templates/astro-emdash/content/guide/capability-map.md +17 -0
  154. package/modules/guide/templates/astro-emdash/src/components/guide-widget.tsx +41 -0
  155. package/modules/guide/templates/astro-emdash/src/guide/actions.ts +8 -0
  156. package/modules/guide/templates/astro-emdash/src/guide/config.ts +21 -0
  157. package/modules/guide/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
  158. package/modules/guide/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
  159. package/modules/guide/templates/astro-emdash/src/guide/corpus.ts +4 -0
  160. package/modules/guide/templates/astro-emdash/src/guide/resources.json +4 -0
  161. package/modules/guide/templates/react-router/app/components/guide-widget.tsx +29 -0
  162. package/modules/guide/templates/react-router/app/guide/actions.ts +3 -0
  163. package/modules/guide/templates/react-router/app/guide/config.ts +21 -0
  164. package/modules/guide/templates/react-router/app/guide/corpus.gen.ts +4 -0
  165. package/modules/guide/templates/react-router/app/guide/corpus.manifest.json +22 -0
  166. package/modules/guide/templates/react-router/app/guide/corpus.ts +4 -0
  167. package/modules/guide/templates/react-router/app/guide/resources.json +4 -0
  168. package/modules/guide/templates/react-router/content/guide/capability-map.md +13 -0
  169. package/modules/guide/templates/tanstack-start/content/guide/capability-map.md +17 -0
  170. package/modules/guide/templates/tanstack-start/src/components/guide-widget.tsx +41 -0
  171. package/modules/guide/templates/tanstack-start/src/guide/actions.ts +17 -0
  172. package/modules/guide/templates/tanstack-start/src/guide/config.ts +21 -0
  173. package/modules/guide/templates/tanstack-start/src/guide/corpus.gen.ts +4 -0
  174. package/modules/guide/templates/tanstack-start/src/guide/corpus.manifest.json +22 -0
  175. package/modules/guide/templates/tanstack-start/src/guide/corpus.ts +4 -0
  176. package/modules/guide/templates/tanstack-start/src/guide/resources.json +4 -0
  177. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  178. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  179. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  180. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  181. package/modules/openai-subscription/templates/astro-emdash/src/openai-subscription.ts +11 -0
  182. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  183. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  184. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  185. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  186. package/modules/openai-subscription/templates/react-router/app/openai-subscription.ts +11 -0
  187. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  188. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  189. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  190. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  191. package/modules/openai-subscription/templates/tanstack-start/src/openai-subscription.ts +11 -0
  192. package/package.json +34 -8
  193. package/skills/README.md +122 -0
  194. package/skills/raybase-actions/SKILL.md +223 -0
  195. package/skills/raybase-actions/references/action-patterns.md +190 -0
  196. package/skills/raybase-actions/references/adapting-actions.md +93 -0
  197. package/skills/raybase-actions/references/testing-actions.md +48 -0
  198. package/skills/raybase-agent-debugging/SKILL.md +230 -0
  199. package/skills/raybase-ai/SKILL.md +1310 -0
  200. package/skills/raybase-api/SKILL.md +45 -0
  201. package/skills/raybase-astro-emdash/SKILL.md +143 -0
  202. package/skills/raybase-astro-emdash-content-model/SKILL.md +217 -0
  203. package/skills/raybase-astro-emdash-content-model/references/LICENSE-emdash +9 -0
  204. package/skills/raybase-astro-emdash-content-model/references/emdash-collections.md +265 -0
  205. package/skills/raybase-astro-emdash-design/LICENSE-impeccable +60 -0
  206. package/skills/raybase-astro-emdash-design/SKILL.md +170 -0
  207. package/skills/raybase-astro-emdash-design/reference/color.md +91 -0
  208. package/skills/raybase-astro-emdash-design/reference/copy.md +73 -0
  209. package/skills/raybase-astro-emdash-design/reference/direction.md +115 -0
  210. package/skills/raybase-astro-emdash-design/reference/imagery.md +84 -0
  211. package/skills/raybase-astro-emdash-design/reference/layout.md +69 -0
  212. package/skills/raybase-astro-emdash-design/reference/motion.md +75 -0
  213. package/skills/raybase-astro-emdash-design/reference/polish.md +75 -0
  214. package/skills/raybase-astro-emdash-design/reference/typography.md +72 -0
  215. package/skills/raybase-astro-emdash-galley/SKILL.md +265 -0
  216. package/skills/raybase-astro-emdash-migration/SKILL.md +218 -0
  217. package/skills/raybase-astro-emdash-migration/references/inventory-and-conversion.md +242 -0
  218. package/skills/raybase-astro-emdash-security-review/SKILL.md +68 -0
  219. package/skills/raybase-astro-emdash-theme-selection/SKILL.md +216 -0
  220. package/skills/raybase-auth/SKILL.md +358 -0
  221. package/skills/raybase-background-jobs/SKILL.md +774 -0
  222. package/skills/raybase-building/SKILL.md +409 -0
  223. package/skills/raybase-building/references/interview-and-spec.md +87 -0
  224. package/skills/raybase-building/references/planning-docs.md +26 -0
  225. package/skills/raybase-building/references/schema-and-config.md +70 -0
  226. package/skills/raybase-changing-a-live-app/SKILL.md +119 -0
  227. package/skills/raybase-data-and-policies/SKILL.md +377 -0
  228. package/skills/raybase-deploy/SKILL.md +136 -0
  229. package/skills/raybase-docs-writing/SKILL.md +119 -0
  230. package/skills/raybase-guide/SKILL.md +235 -0
  231. package/skills/raybase-mcp/SKILL.md +309 -0
  232. package/skills/raybase-mcp/agents/openai.yaml +4 -0
  233. package/skills/raybase-notifications/SKILL.md +138 -0
  234. package/skills/raybase-pro-migration/SKILL.md +28 -0
  235. package/skills/raybase-react-router/SKILL.md +241 -0
  236. package/skills/raybase-react-router-design/LICENSE-impeccable +60 -0
  237. package/skills/raybase-react-router-design/SKILL.md +135 -0
  238. package/skills/raybase-react-router-design/reference/color.md +87 -0
  239. package/skills/raybase-react-router-design/reference/copy.md +83 -0
  240. package/skills/raybase-react-router-design/reference/delight.md +48 -0
  241. package/skills/raybase-react-router-design/reference/interaction.md +91 -0
  242. package/skills/raybase-react-router-design/reference/layout.md +82 -0
  243. package/skills/raybase-react-router-design/reference/motion.md +86 -0
  244. package/skills/raybase-react-router-design/reference/polish.md +79 -0
  245. package/skills/raybase-react-router-design/reference/typography.md +71 -0
  246. package/skills/raybase-react-router-security-review/LICENSE +22 -0
  247. package/skills/raybase-react-router-security-review/SKILL.md +190 -0
  248. package/skills/raybase-react-router-security-review/agents/openai.yaml +4 -0
  249. package/skills/raybase-react-router-security-review/references/api-security.md +519 -0
  250. package/skills/raybase-react-router-security-review/references/authentication.md +353 -0
  251. package/skills/raybase-react-router-security-review/references/authorization.md +372 -0
  252. package/skills/raybase-react-router-security-review/references/business-logic.md +443 -0
  253. package/skills/raybase-react-router-security-review/references/cryptography.md +329 -0
  254. package/skills/raybase-react-router-security-review/references/csrf.md +398 -0
  255. package/skills/raybase-react-router-security-review/references/data-protection.md +378 -0
  256. package/skills/raybase-react-router-security-review/references/deserialization.md +410 -0
  257. package/skills/raybase-react-router-security-review/references/error-handling.md +436 -0
  258. package/skills/raybase-react-router-security-review/references/file-security.md +457 -0
  259. package/skills/raybase-react-router-security-review/references/injection.md +259 -0
  260. package/skills/raybase-react-router-security-review/references/logging.md +433 -0
  261. package/skills/raybase-react-router-security-review/references/misconfiguration.md +435 -0
  262. package/skills/raybase-react-router-security-review/references/modern-threats.md +475 -0
  263. package/skills/raybase-react-router-security-review/references/raybase-react-router-security.md +235 -0
  264. package/skills/raybase-react-router-security-review/references/ssrf.md +413 -0
  265. package/skills/raybase-react-router-security-review/references/supply-chain.md +405 -0
  266. package/skills/raybase-react-router-security-review/references/xss.md +336 -0
  267. package/skills/raybase-realtime/SKILL.md +158 -0
  268. package/skills/raybase-realtime/agents/openai.yaml +4 -0
  269. package/skills/raybase-schema/SKILL.md +209 -0
  270. package/skills/raybase-search/SKILL.md +137 -0
  271. package/skills/raybase-search/agents/openai.yaml +4 -0
  272. package/skills/raybase-settings/SKILL.md +139 -0
  273. package/skills/raybase-settings/agents/openai.yaml +4 -0
  274. package/skills/raybase-tanstack-start/SKILL.md +166 -0
  275. package/skills/raybase-tanstack-start-design/LICENSE-impeccable +60 -0
  276. package/skills/raybase-tanstack-start-design/SKILL.md +140 -0
  277. package/skills/raybase-tanstack-start-design/reference/color.md +80 -0
  278. package/skills/raybase-tanstack-start-design/reference/copy.md +83 -0
  279. package/skills/raybase-tanstack-start-design/reference/delight.md +48 -0
  280. package/skills/raybase-tanstack-start-design/reference/interaction.md +91 -0
  281. package/skills/raybase-tanstack-start-design/reference/layout.md +82 -0
  282. package/skills/raybase-tanstack-start-design/reference/motion.md +86 -0
  283. package/skills/raybase-tanstack-start-design/reference/polish.md +79 -0
  284. package/skills/raybase-tanstack-start-design/reference/typography.md +71 -0
  285. package/skills/raybase-tanstack-start-security-review/LICENSE +22 -0
  286. package/skills/raybase-tanstack-start-security-review/SKILL.md +194 -0
  287. package/skills/raybase-tanstack-start-security-review/agents/openai.yaml +4 -0
  288. package/skills/raybase-tanstack-start-security-review/references/api-security.md +519 -0
  289. package/skills/raybase-tanstack-start-security-review/references/authentication.md +353 -0
  290. package/skills/raybase-tanstack-start-security-review/references/authorization.md +372 -0
  291. package/skills/raybase-tanstack-start-security-review/references/business-logic.md +443 -0
  292. package/skills/raybase-tanstack-start-security-review/references/cryptography.md +329 -0
  293. package/skills/raybase-tanstack-start-security-review/references/csrf.md +398 -0
  294. package/skills/raybase-tanstack-start-security-review/references/data-protection.md +378 -0
  295. package/skills/raybase-tanstack-start-security-review/references/deserialization.md +410 -0
  296. package/skills/raybase-tanstack-start-security-review/references/error-handling.md +436 -0
  297. package/skills/raybase-tanstack-start-security-review/references/file-security.md +457 -0
  298. package/skills/raybase-tanstack-start-security-review/references/injection.md +259 -0
  299. package/skills/raybase-tanstack-start-security-review/references/logging.md +433 -0
  300. package/skills/raybase-tanstack-start-security-review/references/misconfiguration.md +435 -0
  301. package/skills/raybase-tanstack-start-security-review/references/modern-threats.md +475 -0
  302. package/skills/raybase-tanstack-start-security-review/references/raybase-tanstack-security.md +208 -0
  303. package/skills/raybase-tanstack-start-security-review/references/ssrf.md +413 -0
  304. package/skills/raybase-tanstack-start-security-review/references/supply-chain.md +405 -0
  305. package/skills/raybase-tanstack-start-security-review/references/xss.md +336 -0
  306. package/skills-manifest.json +41 -0
  307. package/templates/astro-emdash/.dev.vars.example +7 -0
  308. package/templates/astro-emdash/AGENTS.md +122 -0
  309. package/templates/astro-emdash/DESIGN.md +90 -0
  310. package/templates/astro-emdash/components.json +21 -0
  311. package/templates/astro-emdash/content/docs/getting-started.mdx +20 -0
  312. package/templates/astro-emdash/content/docs/index.mdx +13 -0
  313. package/templates/astro-emdash/content/docs/mcp.mdx +11 -0
  314. package/templates/astro-emdash/content/docs/meta.json +4 -0
  315. package/templates/astro-emdash/content/docs/site-templates.mdx +62 -0
  316. package/templates/astro-emdash/dev/CODEBASE-MAP.md +46 -0
  317. package/templates/astro-emdash/dev/SPEC-OVERVIEW.md +15 -0
  318. package/templates/astro-emdash/dev/SPEC.md +84 -0
  319. package/templates/astro-emdash/dev/features/archive/.gitkeep +1 -0
  320. package/templates/astro-emdash/docs/theme-previews/base.svg +24 -0
  321. package/templates/astro-emdash/docs/theme-previews/steel.svg +24 -0
  322. package/templates/astro-emdash/docs/theme-previews/zen.svg +24 -0
  323. package/templates/astro-emdash/docs/themes.md +106 -0
  324. package/templates/astro-emdash/drizzle.config.ts +5 -0
  325. package/templates/astro-emdash/gitignore +11 -0
  326. package/templates/astro-emdash/migrations/app/meta/_journal.json +5 -0
  327. package/templates/astro-emdash/package.json +79 -0
  328. package/templates/astro-emdash/pnpm-workspace.yaml +71 -0
  329. package/templates/astro-emdash/public/_headers +4 -0
  330. package/templates/astro-emdash/site/astro.config.mjs +120 -0
  331. package/templates/astro-emdash/site/demo/README.md +72 -0
  332. package/templates/astro-emdash/site/demo/content/collection.json +43 -0
  333. package/templates/astro-emdash/site/demo/content/entries.json +120 -0
  334. package/templates/astro-emdash/site/demo/templates/demo-article-card/manifest.json +51 -0
  335. package/templates/astro-emdash/site/demo/templates/demo-article-card/sample-content.json +5 -0
  336. package/templates/astro-emdash/site/demo/templates/demo-article-card/template.liquid +48 -0
  337. package/templates/astro-emdash/site/demo/templates/demo-article-page/host.json +9 -0
  338. package/templates/astro-emdash/site/demo/templates/demo-article-page/manifest.json +38 -0
  339. package/templates/astro-emdash/site/demo/templates/demo-article-page/sample-content.json +34 -0
  340. package/templates/astro-emdash/site/demo/templates/demo-article-page/template.liquid +84 -0
  341. package/templates/astro-emdash/site/demo/templates/demo-articles-index/manifest.json +64 -0
  342. package/templates/astro-emdash/site/demo/templates/demo-articles-index/page.json +7 -0
  343. package/templates/astro-emdash/site/demo/templates/demo-articles-index/sample-content.json +24 -0
  344. package/templates/astro-emdash/site/demo/templates/demo-articles-index/template.liquid +100 -0
  345. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/manifest.json +51 -0
  346. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/sample-content.json +5 -0
  347. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/template.liquid +70 -0
  348. package/templates/astro-emdash/site/gitignore +1 -0
  349. package/templates/astro-emdash/site/package.json +56 -0
  350. package/templates/astro-emdash/site/scripts/apply-site-templates.mjs +560 -0
  351. package/templates/astro-emdash/site/scripts/galley-demo.mjs +298 -0
  352. package/templates/astro-emdash/site/scripts/seed-galley-starter.mjs +360 -0
  353. package/templates/astro-emdash/site/scripts/site-origin.mjs +45 -0
  354. package/templates/astro-emdash/site/seed/seed.json +154 -0
  355. package/templates/astro-emdash/site/seed/templates/.gitkeep +1 -0
  356. package/templates/astro-emdash/site/src/components/RaybaseSignedInMenu.astro +163 -0
  357. package/templates/astro-emdash/site/src/components/blocks/RaybaseActionIsland.astro +41 -0
  358. package/templates/astro-emdash/site/src/content-door/raybase-routes.ts +738 -0
  359. package/templates/astro-emdash/site/src/content-door/resolve-page.ts +142 -0
  360. package/templates/astro-emdash/site/src/content-door/seed.ts +85 -0
  361. package/templates/astro-emdash/site/src/env.d.ts +12 -0
  362. package/templates/astro-emdash/site/src/layouts/SiteLayout.astro +68 -0
  363. package/templates/astro-emdash/site/src/lib/palettes.gen.ts +7 -0
  364. package/templates/astro-emdash/site/src/lib/site-motion.ts +169 -0
  365. package/templates/astro-emdash/site/src/lib/site-shell.ts +294 -0
  366. package/templates/astro-emdash/site/src/live.config.ts +8 -0
  367. package/templates/astro-emdash/site/src/middleware.ts +20 -0
  368. package/templates/astro-emdash/site/src/pages/[...slug].astro +113 -0
  369. package/templates/astro-emdash/site/src/pages/_raybase/handoff/consume.ts +6 -0
  370. package/templates/astro-emdash/site/src/pages/_raybase/islands/action.ts +8 -0
  371. package/templates/astro-emdash/site/src/pages/_raybase/sign-out/index.ts +6 -0
  372. package/templates/astro-emdash/site/src/styles/palette-fonts.gen.css +1 -0
  373. package/templates/astro-emdash/site/src/styles/palettes.gen.css +3 -0
  374. package/templates/astro-emdash/site/src/styles.css +607 -0
  375. package/templates/astro-emdash/site/tsconfig.json +12 -0
  376. package/templates/astro-emdash/site/wrangler.jsonc +34 -0
  377. package/templates/astro-emdash/source.config.ts +10 -0
  378. package/templates/astro-emdash/src/actions.ts +58 -0
  379. package/templates/astro-emdash/src/ai/agents.ts +20 -0
  380. package/templates/astro-emdash/src/ai/retrieval.ts +36 -0
  381. package/templates/astro-emdash/src/auth-door.ts +18 -0
  382. package/templates/astro-emdash/src/client.tsx +25 -0
  383. package/templates/astro-emdash/src/components/.gitkeep +1 -0
  384. package/templates/astro-emdash/src/components/account-menu.tsx +91 -0
  385. package/templates/astro-emdash/src/components/auth-shell.tsx +69 -0
  386. package/templates/astro-emdash/src/components/mode-toggle.tsx +32 -0
  387. package/templates/astro-emdash/src/components/search-command-palette.tsx +107 -0
  388. package/templates/astro-emdash/src/components/setup-token-page.tsx +196 -0
  389. package/templates/astro-emdash/src/components/ui/avatar.tsx +107 -0
  390. package/templates/astro-emdash/src/components/ui/badge.tsx +52 -0
  391. package/templates/astro-emdash/src/components/ui/button.tsx +69 -0
  392. package/templates/astro-emdash/src/components/ui/checkbox.tsx +29 -0
  393. package/templates/astro-emdash/src/components/ui/dialog.tsx +158 -0
  394. package/templates/astro-emdash/src/components/ui/dropdown-menu.tsx +303 -0
  395. package/templates/astro-emdash/src/components/ui/input.tsx +20 -0
  396. package/templates/astro-emdash/src/components/ui/label.tsx +20 -0
  397. package/templates/astro-emdash/src/components/ui/scroll-area.tsx +53 -0
  398. package/templates/astro-emdash/src/components/ui/select.tsx +215 -0
  399. package/templates/astro-emdash/src/components/ui/separator.tsx +23 -0
  400. package/templates/astro-emdash/src/components/ui/sheet.tsx +138 -0
  401. package/templates/astro-emdash/src/components/ui/sidebar.tsx +728 -0
  402. package/templates/astro-emdash/src/components/ui/skeleton.tsx +13 -0
  403. package/templates/astro-emdash/src/components/ui/textarea.tsx +18 -0
  404. package/templates/astro-emdash/src/components/ui/tooltip.tsx +66 -0
  405. package/templates/astro-emdash/src/db/migrations.gen.ts +6 -0
  406. package/templates/astro-emdash/src/db/schema.ts +6 -0
  407. package/templates/astro-emdash/src/db/seed.ts +16 -0
  408. package/templates/astro-emdash/src/db/storage.ts +32 -0
  409. package/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
  410. package/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
  411. package/templates/astro-emdash/src/docs/docs-data.ts +24 -0
  412. package/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
  413. package/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
  414. package/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
  415. package/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
  416. package/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
  417. package/templates/astro-emdash/src/docs/llm-text.ts +61 -0
  418. package/templates/astro-emdash/src/docs/source.ts +7 -0
  419. package/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
  420. package/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
  421. package/templates/astro-emdash/src/hooks/use-mobile.ts +19 -0
  422. package/templates/astro-emdash/src/jobs.example.ts +48 -0
  423. package/templates/astro-emdash/src/lib/account.ts +12 -0
  424. package/templates/astro-emdash/src/lib/auth-client.ts +181 -0
  425. package/templates/astro-emdash/src/lib/utils.ts +6 -0
  426. package/templates/astro-emdash/src/mcp-app.ts +57 -0
  427. package/templates/astro-emdash/src/notifications.example.ts +37 -0
  428. package/templates/astro-emdash/src/raybase.auth.ts +70 -0
  429. package/templates/astro-emdash/src/raybase.config.ts +49 -0
  430. package/templates/astro-emdash/src/raybase.server.ts +56 -0
  431. package/templates/astro-emdash/src/realtime.example.ts +18 -0
  432. package/templates/astro-emdash/src/router.tsx +19 -0
  433. package/templates/astro-emdash/src/routes/__root.tsx +56 -0
  434. package/templates/astro-emdash/src/routes/_app/admin.tsx +13 -0
  435. package/templates/astro-emdash/src/routes/_app/forgot-password.tsx +97 -0
  436. package/templates/astro-emdash/src/routes/_app/index.tsx +169 -0
  437. package/templates/astro-emdash/src/routes/_app/invite.$token.tsx +11 -0
  438. package/templates/astro-emdash/src/routes/_app/login.tsx +193 -0
  439. package/templates/astro-emdash/src/routes/_app/profile.tsx +98 -0
  440. package/templates/astro-emdash/src/routes/_app/reset-password.$token.tsx +15 -0
  441. package/templates/astro-emdash/src/routes/_app/reset-password.tsx +115 -0
  442. package/templates/astro-emdash/src/routes/_app/setup.$token.tsx +11 -0
  443. package/templates/astro-emdash/src/routes/_app/signup.tsx +141 -0
  444. package/templates/astro-emdash/src/routes/_app/verify-email.$token.tsx +15 -0
  445. package/templates/astro-emdash/src/routes/_app/verify-email.tsx +154 -0
  446. package/templates/astro-emdash/src/routes/_app.tsx +33 -0
  447. package/templates/astro-emdash/src/routes/admin/$.ts +20 -0
  448. package/templates/astro-emdash/src/routes/api/$.ts +19 -0
  449. package/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
  450. package/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
  451. package/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
  452. package/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
  453. package/templates/astro-emdash/src/routes/docs.tsx +22 -0
  454. package/templates/astro-emdash/src/search.ts +6 -0
  455. package/templates/astro-emdash/src/settings.ts +12 -0
  456. package/templates/astro-emdash/src/styles-docs.css +3 -0
  457. package/templates/astro-emdash/src/styles.css +101 -0
  458. package/templates/astro-emdash/src/themes/base.css +76 -0
  459. package/templates/astro-emdash/src/themes/carbon.css +76 -0
  460. package/templates/astro-emdash/src/themes/fonts.css +25 -0
  461. package/templates/astro-emdash/src/themes/sage.css +76 -0
  462. package/templates/astro-emdash/src/themes/sand.css +76 -0
  463. package/templates/astro-emdash/src/themes/slate.css +81 -0
  464. package/templates/astro-emdash/src/themes/ultra.css +76 -0
  465. package/templates/astro-emdash/src/themes/zen.css +76 -0
  466. package/templates/astro-emdash/src/worker-entry.ts +31 -0
  467. package/templates/astro-emdash/tests/raybase-patterns.test.ts +29 -0
  468. package/templates/astro-emdash/tsconfig.json +36 -0
  469. package/templates/astro-emdash/vite.config.ts +130 -0
  470. package/templates/astro-emdash/vitest.config.ts +8 -0
  471. package/templates/astro-emdash/wrangler.jsonc +112 -0
  472. package/templates/react-router/.dev.vars.example +5 -0
  473. package/templates/react-router/.editorconfig +15 -0
  474. package/templates/react-router/AGENTS.md +54 -0
  475. package/templates/react-router/README.md +52 -0
  476. package/templates/react-router/app/app.css +44 -0
  477. package/templates/react-router/app/components/mdx.tsx +79 -0
  478. package/templates/react-router/app/components/ui/button.tsx +45 -0
  479. package/templates/react-router/app/components/ui/card.tsx +87 -0
  480. package/templates/react-router/app/components/ui/separator.tsx +22 -0
  481. package/templates/react-router/app/db/migrations.gen.ts +6 -0
  482. package/templates/react-router/app/db/schema.ts +56 -0
  483. package/templates/react-router/app/db/seed.ts +14 -0
  484. package/templates/react-router/app/entry.server.tsx +41 -0
  485. package/templates/react-router/app/globals.d.ts +1 -0
  486. package/templates/react-router/app/lib/layout.shared.tsx +52 -0
  487. package/templates/react-router/app/lib/source.ts +7 -0
  488. package/templates/react-router/app/lib/utils.ts +6 -0
  489. package/templates/react-router/app/raybase.server.ts +65 -0
  490. package/templates/react-router/app/root.tsx +23 -0
  491. package/templates/react-router/app/routes/_index.tsx +53 -0
  492. package/templates/react-router/app/routes/docs.$.tsx +49 -0
  493. package/templates/react-router/app/routes/docs.api.search.ts +10 -0
  494. package/templates/react-router/app/routes/docs.tsx +13 -0
  495. package/templates/react-router/app/routes.ts +3 -0
  496. package/templates/react-router/components.json +22 -0
  497. package/templates/react-router/content/docs/getting-started.mdx +15 -0
  498. package/templates/react-router/content/docs/index.mdx +8 -0
  499. package/templates/react-router/content/docs/mcp.mdx +121 -0
  500. package/templates/react-router/content/docs/meta.json +4 -0
  501. package/templates/react-router/dev/CODEBASE-MAP.md +48 -0
  502. package/templates/react-router/dev/SPEC-OVERVIEW.md +35 -0
  503. package/templates/react-router/dev/SPEC.md +93 -0
  504. package/templates/react-router/dev/features/archive/.gitkeep +1 -0
  505. package/templates/react-router/drizzle.config.ts +5 -0
  506. package/templates/react-router/env.d.ts +53 -0
  507. package/templates/react-router/gitignore +23 -0
  508. package/templates/react-router/migrations/app/meta/_journal.json +1 -0
  509. package/templates/react-router/package.json +70 -0
  510. package/templates/react-router/public/_headers +4 -0
  511. package/templates/react-router/public/favicon.ico +0 -0
  512. package/templates/react-router/react-router.config.ts +9 -0
  513. package/templates/react-router/source.config.ts +5 -0
  514. package/templates/react-router/tests/raybase-patterns.test.ts +23 -0
  515. package/templates/react-router/tsconfig.json +27 -0
  516. package/templates/react-router/vite.config.ts +59 -0
  517. package/templates/react-router/vitest.config.ts +8 -0
  518. package/templates/react-router/workers/app.ts +40 -0
  519. package/templates/react-router/wrangler.jsonc +111 -0
  520. package/templates/tanstack-start/.dev.vars.example +5 -0
  521. package/templates/tanstack-start/AGENTS.md +95 -0
  522. package/templates/tanstack-start/DESIGN.md +65 -0
  523. package/templates/tanstack-start/components.json +21 -0
  524. package/templates/tanstack-start/content/docs/getting-started.mdx +65 -0
  525. package/templates/tanstack-start/content/docs/index.mdx +10 -0
  526. package/templates/tanstack-start/content/docs/mcp.mdx +122 -0
  527. package/templates/tanstack-start/content/docs/meta.json +4 -0
  528. package/templates/tanstack-start/dev/CODEBASE-MAP.md +84 -0
  529. package/templates/tanstack-start/dev/SPEC-OVERVIEW.md +46 -0
  530. package/templates/tanstack-start/dev/SPEC.md +213 -0
  531. package/templates/tanstack-start/dev/features/archive/.gitkeep +1 -0
  532. package/templates/tanstack-start/docs/theme-previews/base.svg +24 -0
  533. package/templates/tanstack-start/docs/theme-previews/steel.svg +24 -0
  534. package/templates/tanstack-start/docs/theme-previews/zen.svg +24 -0
  535. package/templates/tanstack-start/docs/themes.md +116 -0
  536. package/templates/tanstack-start/drizzle.config.ts +5 -0
  537. package/templates/tanstack-start/gitignore +11 -0
  538. package/templates/tanstack-start/migrations/app/0000_low_karen_page.sql +26 -0
  539. package/templates/tanstack-start/migrations/app/meta/0000_snapshot.json +196 -0
  540. package/templates/tanstack-start/migrations/app/meta/_journal.json +13 -0
  541. package/templates/tanstack-start/package.json +77 -0
  542. package/templates/tanstack-start/public/_headers +8 -0
  543. package/templates/tanstack-start/public/icons/app-icon-maskable.svg +1 -0
  544. package/templates/tanstack-start/public/icons/app-icon.svg +1 -0
  545. package/templates/tanstack-start/public/icons/apple-touch-icon.png +0 -0
  546. package/templates/tanstack-start/public/manifest.webmanifest +14 -0
  547. package/templates/tanstack-start/public/raybase-push-sw.js +32 -0
  548. package/templates/tanstack-start/source.config.ts +10 -0
  549. package/templates/tanstack-start/src/actions.ts +560 -0
  550. package/templates/tanstack-start/src/ai/agents.ts +78 -0
  551. package/templates/tanstack-start/src/ai/retrieval.ts +36 -0
  552. package/templates/tanstack-start/src/auth-door.ts +18 -0
  553. package/templates/tanstack-start/src/client.tsx +25 -0
  554. package/templates/tanstack-start/src/components/.gitkeep +1 -0
  555. package/templates/tanstack-start/src/components/account-menu.tsx +127 -0
  556. package/templates/tanstack-start/src/components/auth-shell.tsx +69 -0
  557. package/templates/tanstack-start/src/components/install-app.tsx +35 -0
  558. package/templates/tanstack-start/src/components/mode-toggle.tsx +32 -0
  559. package/templates/tanstack-start/src/components/search-command-palette.tsx +107 -0
  560. package/templates/tanstack-start/src/components/setup-token-page.tsx +197 -0
  561. package/templates/tanstack-start/src/components/ui/avatar.tsx +107 -0
  562. package/templates/tanstack-start/src/components/ui/badge.tsx +52 -0
  563. package/templates/tanstack-start/src/components/ui/button.tsx +69 -0
  564. package/templates/tanstack-start/src/components/ui/checkbox.tsx +29 -0
  565. package/templates/tanstack-start/src/components/ui/dialog.tsx +158 -0
  566. package/templates/tanstack-start/src/components/ui/dropdown-menu.tsx +303 -0
  567. package/templates/tanstack-start/src/components/ui/input.tsx +20 -0
  568. package/templates/tanstack-start/src/components/ui/label.tsx +20 -0
  569. package/templates/tanstack-start/src/components/ui/scroll-area.tsx +53 -0
  570. package/templates/tanstack-start/src/components/ui/select.tsx +215 -0
  571. package/templates/tanstack-start/src/components/ui/separator.tsx +23 -0
  572. package/templates/tanstack-start/src/components/ui/sheet.tsx +138 -0
  573. package/templates/tanstack-start/src/components/ui/sidebar.tsx +728 -0
  574. package/templates/tanstack-start/src/components/ui/skeleton.tsx +13 -0
  575. package/templates/tanstack-start/src/components/ui/textarea.tsx +18 -0
  576. package/templates/tanstack-start/src/components/ui/tooltip.tsx +66 -0
  577. package/templates/tanstack-start/src/db/migrations.gen.ts +6 -0
  578. package/templates/tanstack-start/src/db/schema.ts +90 -0
  579. package/templates/tanstack-start/src/db/seed.ts +106 -0
  580. package/templates/tanstack-start/src/db/storage.ts +32 -0
  581. package/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
  582. package/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
  583. package/templates/tanstack-start/src/docs/docs-data.ts +24 -0
  584. package/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
  585. package/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
  586. package/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
  587. package/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
  588. package/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
  589. package/templates/tanstack-start/src/docs/llm-text.ts +61 -0
  590. package/templates/tanstack-start/src/docs/source.ts +7 -0
  591. package/templates/tanstack-start/src/hooks/use-mobile.ts +19 -0
  592. package/templates/tanstack-start/src/hooks/use-pwa-install.ts +77 -0
  593. package/templates/tanstack-start/src/jobs.example.ts +56 -0
  594. package/templates/tanstack-start/src/lib/account.ts +13 -0
  595. package/templates/tanstack-start/src/lib/auth-client.ts +187 -0
  596. package/templates/tanstack-start/src/lib/push-client.ts +98 -0
  597. package/templates/tanstack-start/src/lib/utils.ts +6 -0
  598. package/templates/tanstack-start/src/mcp-app.ts +74 -0
  599. package/templates/tanstack-start/src/notifications.example.ts +37 -0
  600. package/templates/tanstack-start/src/raybase.auth.ts +86 -0
  601. package/templates/tanstack-start/src/raybase.config.ts +86 -0
  602. package/templates/tanstack-start/src/raybase.server.ts +155 -0
  603. package/templates/tanstack-start/src/realtime.example.ts +46 -0
  604. package/templates/tanstack-start/src/router.tsx +19 -0
  605. package/templates/tanstack-start/src/routes/__root.tsx +73 -0
  606. package/templates/tanstack-start/src/routes/_app/admin.tsx +13 -0
  607. package/templates/tanstack-start/src/routes/_app/forgot-password.tsx +97 -0
  608. package/templates/tanstack-start/src/routes/_app/index.tsx +1316 -0
  609. package/templates/tanstack-start/src/routes/_app/invite.$token.tsx +11 -0
  610. package/templates/tanstack-start/src/routes/_app/login.tsx +193 -0
  611. package/templates/tanstack-start/src/routes/_app/profile.tsx +98 -0
  612. package/templates/tanstack-start/src/routes/_app/reset-password.$token.tsx +16 -0
  613. package/templates/tanstack-start/src/routes/_app/reset-password.tsx +115 -0
  614. package/templates/tanstack-start/src/routes/_app/setup.$token.tsx +11 -0
  615. package/templates/tanstack-start/src/routes/_app/signup.tsx +141 -0
  616. package/templates/tanstack-start/src/routes/_app/verify-email.$token.tsx +15 -0
  617. package/templates/tanstack-start/src/routes/_app/verify-email.tsx +154 -0
  618. package/templates/tanstack-start/src/routes/_app.tsx +33 -0
  619. package/templates/tanstack-start/src/routes/admin/$.ts +20 -0
  620. package/templates/tanstack-start/src/routes/api/$.ts +19 -0
  621. package/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
  622. package/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
  623. package/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
  624. package/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
  625. package/templates/tanstack-start/src/routes/docs.tsx +22 -0
  626. package/templates/tanstack-start/src/search.ts +26 -0
  627. package/templates/tanstack-start/src/settings.ts +12 -0
  628. package/templates/tanstack-start/src/styles-docs.css +3 -0
  629. package/templates/tanstack-start/src/styles.css +73 -0
  630. package/templates/tanstack-start/src/themes/base.css +76 -0
  631. package/templates/tanstack-start/src/themes/carbon.css +76 -0
  632. package/templates/tanstack-start/src/themes/fonts.css +18 -0
  633. package/templates/tanstack-start/src/themes/sage.css +76 -0
  634. package/templates/tanstack-start/src/themes/sand.css +76 -0
  635. package/templates/tanstack-start/src/themes/slate.css +76 -0
  636. package/templates/tanstack-start/src/themes/ultra.css +76 -0
  637. package/templates/tanstack-start/src/themes/zen.css +76 -0
  638. package/templates/tanstack-start/src/worker-entry.ts +30 -0
  639. package/templates/tanstack-start/tests/raybase-patterns.test.ts +247 -0
  640. package/templates/tanstack-start/tsconfig.json +33 -0
  641. package/templates/tanstack-start/vite.config.ts +132 -0
  642. package/templates/tanstack-start/vitest.config.ts +8 -0
  643. package/templates/tanstack-start/wrangler.jsonc +112 -0
  644. package/README.md +0 -3
@@ -0,0 +1,8 @@
1
+ import { defineConfig } from "vitest/config";
2
+
3
+ export default defineConfig({
4
+ test: {
5
+ environment: "node",
6
+ include: ["tests/**/*.test.ts", "app/**/*.test.ts", "app/**/*.test.tsx"]
7
+ }
8
+ });
@@ -0,0 +1,40 @@
1
+ import { createRequestHandler } from "react-router";
2
+ import { withRaybaseLocalDevChrome } from "@raybase/core/worker";
3
+ import { appConfig, handleRaybaseRequest, isDisabledRaybaseAdminRequest, isRaybaseRequest, raybaseHandler } from "../app/raybase.server";
4
+
5
+ // Singleton Raybase SQLite Durable Object (bound as RAYBASE_DATA in wrangler.jsonc).
6
+ export { RaybaseDatabaseObject } from "@raybase/core/do";
7
+ export { RaybaseAIChatAgentObject } from "../app/raybase.server";
8
+
9
+ declare module "react-router" {
10
+ export interface AppLoadContext {
11
+ cloudflare: {
12
+ env: Env;
13
+ ctx: ExecutionContext;
14
+ };
15
+ }
16
+ }
17
+
18
+ const requestHandler = createRequestHandler(
19
+ () => import("virtual:react-router/server-build"),
20
+ import.meta.env.MODE,
21
+ );
22
+
23
+ export default {
24
+ async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
25
+ if (isDisabledRaybaseAdminRequest(request)) return new Response("Not Found", { status: 404 });
26
+ // Raybase (admin panel, auth pages, data API, MCP) and the React Router
27
+ // app share this worker; Raybase owns its path prefixes, React Router
28
+ // takes the rest.
29
+ const url = new URL(request.url);
30
+ if (isRaybaseRequest(url)) return handleRaybaseRequest(request, env, ctx);
31
+ const response = await requestHandler(request, { cloudflare: { env, ctx } });
32
+ // Adds Raybase's local dev chrome (persona switcher) to app pages in
33
+ // local development; a no-op everywhere else.
34
+ return withRaybaseLocalDevChrome({ request, env: env as never, config: appConfig, response });
35
+ },
36
+ queue: raybaseHandler.queue,
37
+ async scheduled(controller: unknown, env: Env, ctx: ExecutionContext): Promise<void> {
38
+ if (raybaseHandler.scheduled) await raybaseHandler.scheduled(controller as never, env as never, ctx as never);
39
+ }
40
+ };
@@ -0,0 +1,111 @@
1
+ {
2
+ "$schema": "./node_modules/wrangler/config-schema.json",
3
+ "name": "__PACKAGE_NAME__",
4
+ "main": "./workers/app.ts",
5
+ "compatibility_date": "2025-10-08",
6
+ // nodejs_compat (with a compatibility_date >= 2025-04-01) also populates
7
+ // process.env from vars/secrets, so the template's process.env reads work
8
+ // unchanged inside workerd.
9
+ "compatibility_flags": ["nodejs_compat"],
10
+ "observability": {
11
+ "enabled": true
12
+ },
13
+ "upload_source_maps": true,
14
+ // Raybase data lives in one SQLite Durable Object, including auth,
15
+ // sessions, audit, and app tables declared in app/db/schema.ts.
16
+ "durable_objects": {
17
+ "bindings": [
18
+ {
19
+ "name": "RAYBASE_DATA",
20
+ "class_name": "RaybaseDatabaseObject"
21
+ },
22
+ {
23
+ "name": "RAYBASE_AI_CHAT_AGENT",
24
+ "class_name": "RaybaseAIChatAgentObject"
25
+ }
26
+ ]
27
+ },
28
+ "migrations": [
29
+ {
30
+ "tag": "v1",
31
+ "new_sqlite_classes": ["RaybaseDatabaseObject"]
32
+ },
33
+ {
34
+ "tag": "v2_raybase_ai_chat_agent",
35
+ "new_sqlite_classes": ["RaybaseAIChatAgentObject"]
36
+ }
37
+ ],
38
+ "vars": {
39
+ "RAYBASE_ENV": "production",
40
+ "RAYBASE_BACKUPS_ENABLED": "true",
41
+ "RAYBASE_BACKUPS_RETAIN": "30"
42
+ },
43
+ "triggers": {
44
+ "crons": ["0 2 * * *"]
45
+ },
46
+ "r2_buckets": [
47
+ {
48
+ "binding": "RAYBASE_BACKUPS",
49
+ "bucket_name": "__PACKAGE_NAME__-backups"
50
+ },
51
+ {
52
+ "binding": "RAYBASE_THREAD_ARCHIVE",
53
+ "bucket_name": "__PACKAGE_NAME__-thread-archive"
54
+ }
55
+ ],
56
+ // Cloudflare Email Service auth email is opt-in. First record
57
+ // `Cloudflare email capability: transactional-email` in dev/SPEC.md, then
58
+ // onboard a sender domain in Cloudflare DNS and run
59
+ // `raybase email enable --from noreply@example.com`.
60
+ // "send_email": [
61
+ // {
62
+ // "name": "EMAIL",
63
+ // "allowed_sender_addresses": ["noreply@example.com"]
64
+ // }
65
+ // ],
66
+ "env": {
67
+ "local-dev": {
68
+ "vars": {
69
+ "RAYBASE_ENV": "local"
70
+ },
71
+ "durable_objects": {
72
+ "bindings": [
73
+ {
74
+ "name": "RAYBASE_DATA",
75
+ "class_name": "RaybaseDatabaseObject"
76
+ },
77
+ {
78
+ "name": "RAYBASE_AI_CHAT_AGENT",
79
+ "class_name": "RaybaseAIChatAgentObject"
80
+ }
81
+ ]
82
+ },
83
+ // Live local Workers AI uses a remote binding and Wrangler login.
84
+ // Add with `raybase ai enable --dev --mode live`:
85
+ // "ai": {
86
+ // "binding": "AI",
87
+ // "remote": true
88
+ // },
89
+ // For Cloudflare AI Gateway BYOK testing, put provider keys in .dev.vars
90
+ // under the secret name referenced by appConfig.ai.gateway.authorizationSecretName.
91
+ // If the Gateway is authenticated, set RAYBASE_AI_GATEWAY_AUTH to its
92
+ // Gateway token value. Store Key aliases use appConfig.ai.gateway.storeKeyName.
93
+ // Real local email sends require remote: true plus explicit
94
+ // auth.email.allowLocalSend in app/db/schema.ts.
95
+ // "send_email": [
96
+ // {
97
+ // "name": "EMAIL",
98
+ // "remote": true
99
+ // }
100
+ // ],
101
+ // Dedicated local-dev Vectorize index. Add with `raybase retrieval provision --dev`:
102
+ // "vectorize": [
103
+ // {
104
+ // "binding": "RAYBASE_VECTORIZE",
105
+ // "index_name": "__PACKAGE_NAME__-local-dev",
106
+ // "remote": true
107
+ // }
108
+ // ]
109
+ }
110
+ }
111
+ }
@@ -0,0 +1,5 @@
1
+ RAYBASE_ENV=local
2
+ RAYBASE_AI_MODE=live
3
+ RAYBASE_AI_GATEWAY_ID=
4
+ RAYBASE_AI_GATEWAY_CACHE=
5
+ RAYBASE_AI_MOCK_RESPONSE=
@@ -0,0 +1,95 @@
1
+ # Raybase conventions
2
+
3
+ Use the raybase-* skills in `.agents/skills` before changing this app. For TanStack Start route/layout/framework work, read `.agents/skills/raybase-tanstack-start/SKILL.md`. Claude Code compatibility links live in `.claude/skills`.
4
+
5
+ Commands:
6
+ - `raybase dev`
7
+ - `raybase doctor`
8
+ - `raybase check`
9
+ - `pnpm test`
10
+ - `raybase migrate`
11
+ - `raybase deploy`
12
+ - `raybase backup --url <url>`
13
+ - `raybase backups create|list|download|restore --url <url>`
14
+ - `raybase export --url <url>`
15
+ - `raybase invite --owner`
16
+ - `/docs` lives in `content/docs`; use `.agents/skills/raybase-docs-writing/SKILL.md` before changing docs.
17
+
18
+ Architecture:
19
+ - `src/worker-entry.ts` is the Cloudflare Worker entry. It re-exports the TanStack Start default handler, `RaybaseDatabaseObject`, and the generated app's `RaybaseAIChatAgentObject`.
20
+ - Raybase stores auth, sessions, invites, audit, state, app tables, and declared integration tables in one SQLite Durable Object bound as `RAYBASE_DATA`.
21
+ - Guide/Agent chat state uses the app-configured `RaybaseAIChatAgentObject` Durable Object bound as `RAYBASE_AI_CHAT_AGENT`; keep the export and binding aligned with `src/raybase.server.ts`.
22
+ - Scheduled format-2 backups use `RAYBASE_BACKUPS`, `RAYBASE_BACKUPS_ENABLED=true`, `RAYBASE_BACKUPS_RETAIN=30`, and the daily `0 2 * * *` cron. Run `raybase backups enable` to generate and upload the managed `RAYBASE_BACKUPS_KEY`; never put it in Wrangler `vars`. New archives are envelope-encrypted `.rbb` files and fail closed without a ready provider. Retain historical keys after explicit rotation. Backups include SQLite data and file metadata, not R2 file bytes or Vectorize indexes; plaintext `.sql` is restore-only compatibility input.
23
+ - File storage is opt-in. Declare buckets in `src/db/storage.ts`, pass `storage` to `createRaybaseApp`, and bind `RAYBASE_FILES` before using `/api/files`.
24
+ - Jobs are opt-in. Start from `src/jobs.example.ts`, pass `jobs` to
25
+ `createRaybaseApp`, keep the queue consumer export, and run `raybase jobs
26
+ enable`. Keep the `scheduled` Worker export only when the app declares a
27
+ platform cron; keyed schedules are alarm-driven. Runtime modules may also
28
+ contribute jobs through `modules: [...]`; they use the same queue wiring.
29
+ - Notifications are opt-in unless a real app declares them. Start from
30
+ `src/notifications.example.ts`; external channels require jobs/queues and
31
+ provider configuration before use. Runtime modules may contribute notification
32
+ adapters; provider webhooks should verify and enqueue quickly, and provider
33
+ sends should go through notification adapters rather than direct `fetch()`.
34
+ - Realtime is opt-in. Start from `src/realtime.example.ts`, set
35
+ `appConfig.realtime.enabled: true`, and keep mutations on Raybase data
36
+ clients or declared actions so changes broadcast.
37
+ - Semantic retrieval is opt-in. Start from `src/ai/retrieval.ts`, pass
38
+ `retrieval` to `createRaybaseApp`, and provision Vectorize only when fuzzy
39
+ retrieval or RAG is needed. Use SQL FTS in `src/search.ts` for exact app
40
+ search.
41
+ - Runtime settings are safe, non-secret values. The starter registers
42
+ `src/settings.ts` with a user-scoped dashboard density example; do not put
43
+ secrets, roles, schema, bindings, routes, queues, or auth config in settings.
44
+ - `raybase migrate` generates app-table migrations into `migrations/app/` and compiles them into `src/db/migrations.gen.ts`, which ships inside the worker and applies lazily on first database access. Never edit `migrations.gen.ts` by hand.
45
+ - Fumadocs is served by TanStack Start routes at `/docs`; search is served at `/docs/api/search`.
46
+ - App UI routes live under the pathless `src/routes/_app` layout. Keep app-owned UI, shadcn components, and app styling in that route graph.
47
+ - The app is installable as a PWA. `public/manifest.webmanifest` and
48
+ `public/icons/*` are static files served outside auth by Workers assets;
49
+ the account menu shows "Install app" via `src/hooks/use-pwa-install.ts`.
50
+ The scaffold stamps letter-mark placeholder icons — replace them (and the
51
+ manifest `name`/`short_name`/`theme_color`) during the design pass or a
52
+ rebrand, and keep `short_name` under ~12 characters. The only service
53
+ worker is the push-only `public/raybase-push-sw.js`; do not add an
54
+ offline/caching service worker without an explicit owner request.
55
+ - `src/routes/_app.tsx` imports `src/styles.css`. Do not import `src/styles.css` from `src/routes/__root.tsx` or docs routes.
56
+ - `/docs` route files are server forwarders that return a standalone docs document. Docs content lives in `content/docs`; docs runtime helpers live under `src/docs`.
57
+ - MCP is enabled by default. App MCP lives at `/mcp`; Operator MCP lives at `/mcp/operator` for authorized operators, with read scopes for production evidence and narrow write scopes for typed, audited app-data, app-setting, invite, and user-lifecycle operations.
58
+ - The Team Tasks workflow is implemented through declared `src/actions.ts`
59
+ app actions. UI routes, Guide, App MCP, jobs, and future agents should use
60
+ these domain actions for business behavior instead of duplicating workflow
61
+ rules in client components or writing through generic table mutations.
62
+ - Business and mutating actions need focused tests. Use `@raybase/pro/test`
63
+ for action policy, table policy, ownership, invalid input, and invalid state
64
+ cases. When replacing starter workflows or tables, replace
65
+ `tests/raybase-patterns.test.ts` instead of leaving todo references behind.
66
+ - App tables should model the business domain. Do not add tenant scoping columns to app schema.
67
+ - Multi-tenancy, many customer organizations sharing one app, and SSO across apps are Raybase Pro features. Core is single-tenant by design. A Pro upgrade should start as single-mode unless the app owner explicitly requests a multi-tenant product migration.
68
+ - `dev/SPEC.md` must contain `Signup mode`, `Cloudflare email capability`, `Auth email features`, `Invite delivery`, and `Password recovery` lines before implementation.
69
+ - Default to `Signup mode: invite-only`, `Cloudflare email capability: free-compatible`, `Auth email features: none`, `Invite delivery: admin-shared links`, and `Password recovery: admin-assisted`.
70
+ - Public signup is controlled by `appConfig.auth.signupMode`, not `auth.publicRoutes`. Use `"public"` for provider and password signup, or `"provider-only"` for provider signup with the password door closed. Both create normal `user` users only; password sign-in stays available to existing accounts, and Raybase `/admin` remains invite/operator-only.
71
+ - Password-based public signup, password reset, emailed invites, welcome email, and magic links require owner-confirmed Workers Paid plus Cloudflare Email Sending/domain onboarding and `Cloudflare email capability: transactional-email`. Provider-only signup needs no auth email because the provider verifies the email.
72
+ - Cloudflare verified destination addresses are only for operator/admin notifications or intentional test sends; do not treat them as user verification, password reset, invite email, magic-link auth, or public signup.
73
+ - Local dev personas are configured in `appConfig.auth.devUser` or `appConfig.auth.devUsers`. Raybase Core owns local session creation, login-page persona buttons, and the local dev chrome on app pages.
74
+ - Write `dev/SPEC.md` and `dev/SPEC-OVERVIEW.md` together before asking for
75
+ approval; capture why the app exists and what success looks like when that is
76
+ not already clear. Present the overview inline in the approval message and
77
+ link `dev/SPEC.md` as the full spec. Read `dev/SPEC.md`,
78
+ `dev/SPEC-OVERVIEW.md`, and `dev/CODEBASE-MAP.md` before substantial product
79
+ or architecture work, update them when the product story, business value, or
80
+ architecture changes, and skip churn for tiny fixes.
81
+ - Temporary feature proposals live in `dev/features/<feature-slug>/`; archive them under `dev/features/archive/` after durable facts are folded into the canonical planning docs.
82
+ - `DESIGN.md` records the starter's palette, type, spacing, and canonical
83
+ layouts. Update it when making durable design-system changes.
84
+
85
+ Prohibitions:
86
+ - Do not add custom auth.
87
+ - Do not expose signup by adding `/signup`, `/api/auth/signup`, or `/api/auth/*` to `auth.publicRoutes`.
88
+ - Do not add app-owned local-mode persona switchers, product-header dev persona dropdowns, `src/dev/auto-session`, `ensureLocalSession`, or app-screen calls to `/api/dev/session` or `/api/dev/session/status`.
89
+ - Do not import or use `unsafeDb`.
90
+ - Do not call `env.RAYBASE_FILES.get/put/delete/list` from app code. Use Raybase file APIs so auth, policies, audit, and attachment-safe headers apply.
91
+ - Do not import `src/styles.css`, `src/themes/*`, or `src/components/ui/*` from docs routes or docs helper modules.
92
+ - Do not deploy without `raybase doctor` passing. Run `raybase check` before
93
+ handoff or deploy review when action correctness or workflow behavior
94
+ changed.
95
+ - Do not change schema outside `src/db/schema.ts` plus `raybase migrate`.
@@ -0,0 +1,65 @@
1
+ # Design Baseline
2
+
3
+ ## Palette
4
+
5
+ - `background`: `oklch(0.985 0.003 247)` for the app canvas.
6
+ - `card`: `oklch(1 0 0)` for contained panels and repeated items.
7
+ - `foreground`: `oklch(0.19 0.012 248)` for primary text.
8
+ - `muted`: `oklch(0.955 0.006 247)` and `muted-foreground`: `oklch(0.48 0.017 248)` for quiet surfaces and secondary copy.
9
+ - `primary`: `oklch(0.25 0.025 248)` for primary actions and active states.
10
+ - `accent`: `oklch(0.92 0.018 246)` for low-emphasis highlights.
11
+ - `destructive`: `oklch(0.58 0.21 25)` for errors and destructive actions.
12
+ - Semantic chart colors live in `src/themes/base.css`; alternate palette snippets live under `src/themes/`.
13
+
14
+ ## Typography
15
+
16
+ - The starter uses the system sans stack through `--app-font-sans` in `src/themes/base.css`.
17
+ - Use fixed rem sizes from Tailwind's scale: `text-sm` for compact labels and rows, `text-base` for body text, `text-lg` or `text-xl` for panel headings, and `text-3xl`/`text-4xl` only for page-level headings.
18
+ - Use `font-semibold` for labels/actions and `font-bold` for major headings. Keep letter spacing at `0em`.
19
+
20
+ ## Spacing and Shape
21
+
22
+ - Use Tailwind spacing in 1x increments, with tight gaps inside controls and larger `gap-6`/`gap-8` between page regions.
23
+ - The base radius is `0.625rem`; cards and panels should use `rounded-lg`, controls should use `rounded-md`, and full pills are reserved for badges.
24
+ - Prefer hairline borders for structure and small shadows only for overlays such as command palettes.
25
+
26
+ ## Canonical Layouts
27
+
28
+ - App shell: a `shadcn/ui` sidebar (`SidebarProvider` + `Sidebar` + `SidebarInset`)
29
+ with an off-canvas drawer on mobile. The sidebar holds the app mark, a primary
30
+ "New task" action, the `Overview` nav item, the `Projects` list (status dot +
31
+ open-task count badge), and a footer with Docs and the account menu. The inset
32
+ has a sticky 14-unit header (sidebar trigger, current view title, search,
33
+ archived toggle) over a `max-w-5xl` content column.
34
+ - Overview view: page heading, a 4-up metric row (`grid-cols-2 lg:grid-cols-4`),
35
+ then a two-column band — a bordered "Due next" list with divided rows beside a
36
+ "Team visibility" summary card.
37
+ - Project view: project header (title + status badge + actions menu) with a thin
38
+ progress bar, an open-task list of compact rows, and a collapsed "Completed"
39
+ `<details>` group.
40
+ - Task rows: read-first. One line shows checkbox, title, assignee, due date, and
41
+ priority/status badges; a chevron expands an inline editor (full fields +
42
+ Save / Mark done / Archive). Create flows (new task, new/edit project) use a
43
+ `Dialog`.
44
+ - Repeated records: bordered containers with a compact header and divided rows.
45
+ - Docs: `/docs` route files are TanStack server forwarders that return a
46
+ standalone Fumadocs document from `src/docs/docs-handler.tsx`. App pages use
47
+ `src/styles.css` through the pathless `_app` route; docs inline
48
+ `src/styles-docs.css` in their own document.
49
+ - Overlays: command palette (search), dialogs, and dropdown menus over a dimmed
50
+ backdrop with keyboard dismissal.
51
+
52
+ ## Framework notes
53
+
54
+ - `shadcn/ui` components live in `src/components/ui/` and import via the `@/`
55
+ alias. That alias is mapped in both `tsconfig.json` and `vite.config.ts`
56
+ (`resolve.alias`); keep them in sync or dev import resolution breaks.
57
+ - App and docs styles are document-local. App pages inherit `src/styles.css`
58
+ from the pathless `_app` route. Docs pages are served as a separate document
59
+ by `src/docs/docs-handler.tsx`, which inlines `src/styles-docs.css` with
60
+ `fumadocs-ui/css/neutral.css` + `fumadocs-ui/css/preset.css`, not app theme
61
+ files.
62
+ - Theme presets: `base.css` owns the default `:root` palette. The other files
63
+ under `src/themes/` are CSS snippets for implementation work; use one as a
64
+ starting point to update the app CSS, not as a runtime-switchable option (see
65
+ `docs/themes.md`).
@@ -0,0 +1,21 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema.json",
3
+ "style": "base-nova",
4
+ "rsc": false,
5
+ "tsx": true,
6
+ "tailwind": {
7
+ "config": "",
8
+ "css": "src/styles.css",
9
+ "baseColor": "neutral",
10
+ "cssVariables": true,
11
+ "prefix": ""
12
+ },
13
+ "aliases": {
14
+ "components": "@/components",
15
+ "utils": "@/lib/utils",
16
+ "ui": "@/components/ui",
17
+ "lib": "@/lib",
18
+ "hooks": "@/hooks"
19
+ },
20
+ "iconLibrary": "lucide"
21
+ }
@@ -0,0 +1,65 @@
1
+ ---
2
+ title: Getting started
3
+ description: What the Team Tasks starter demonstrates before a real app spec replaces it.
4
+ ---
5
+
6
+ Team Tasks is the default generated-app demo. It is small enough to inspect, but complete enough to exercise the app surfaces that matter before you replace it with the owner's real workflow.
7
+
8
+ ## Local personas
9
+
10
+ Local development includes four personas:
11
+
12
+ - Dana is the local operator owner and can reach `/admin`.
13
+ - Maya is a manager and can view and manage team work.
14
+ - Riley and Quinn are users and see tasks they created or that are assigned to them.
15
+
16
+ Operator access and app roles are separate. A manager can manage Team Tasks records, but that does not make the manager a Raybase operator.
17
+
18
+ ## Projects and tasks
19
+
20
+ Signed-in users can create projects and tasks. Managers can see team work; users see their own or assigned tasks. Tasks can be assigned, reprioritized, given due dates, moved through `todo`, `doing`, and `done`, archived, and deleted when the table policy allows it.
21
+
22
+ Done tasks can be reopened from the dashboard. Tasks cannot be moved between projects after creation; that rule is enforced by the table invariant and declared action layer.
23
+
24
+ ## Archive and delete
25
+
26
+ Archive is the normal way to hide finished work from active views. Hard delete is intentionally narrower:
27
+
28
+ - Tasks can be deleted only by managers or the creator.
29
+ - Projects can be deleted only by managers, only after archive, and only when no tasks remain in the project.
30
+
31
+ ## Guide
32
+
33
+ Guide is enabled for help and workflow assistance. It can summarize visible work, list visible projects and tasks, create projects and tasks, update tasks, mark tasks done, archive tasks or projects, and list assignable users through declared app actions. Guide does not administer the app, change account settings, edit raw data, or permanently delete work.
34
+
35
+ Guide's runtime toggle and prompt override are available in `/admin/agents` through the standard Raybase Agents controls.
36
+
37
+ ## Install as an app
38
+
39
+ You can install this app so it opens in its own window with its own icon:
40
+
41
+ - In Chrome or Edge, open the account menu and choose **Install app**, or use
42
+ the install icon in the address bar.
43
+ - On iPhone or iPad, open the browser share menu and choose **Add to Home
44
+ Screen**.
45
+ - In Safari on a Mac, choose **File → Add to Dock**.
46
+
47
+ Installing changes nothing about your account or data — it is the same app in
48
+ an app-shaped window.
49
+
50
+ ## AI clients and MCP
51
+
52
+ The MCP server exposes read-only generated table tools for projects and tasks. Mutations are exposed through declared actions so assignment rules, table policies, invariants, and audit stay together.
53
+
54
+ See [Connecting to this app with AI](/docs/mcp) for the current AI access boundary.
55
+
56
+ ## Replacing the starter
57
+
58
+ This workflow is a starter demonstration, not the owner's approved product spec. Before building a real app, replace the placeholder planning docs with an approved `dev/SPEC.md` and update these docs to match the app's actual users, records, permissions, workflows, Guide behavior, and MCP tools.
59
+ ## Local time travel
60
+
61
+ In local development, use the fixed dev chrome or `POST /api/dev/time` with `{"now":"2030-08-12T09:00:00.000Z"}` to move the application clock. `GET /api/dev/time` reports virtual and real time; `{"reset":true}` returns to wall time. Forward jumps start bounded catch-up for Jobs, Agent schedules, wakes, and follow-ups. Repeating schedules coalesce to one run, while one-shot work drains without waiting for the HTTP response. Auth, leases, retries, tokens, provider calls, and diagnostics remain on real time. Moving backward or resetting does not rewrite future-dated rows; reset and reseed when a QA scenario crosses that edge.
62
+
63
+ Local tools can restore the base demo world with `POST /api/dev/seed` and `{"reset":true}`, restore and apply one named demo variant with `{"reset":true,"variant":"busy-week"}`, or layer that variant onto the current world with `{"variant":"busy-week"}`. Reset is destructive for app tables. Apply multiple variants with sequential calls. This is the clean recovery path after time travel leaves future-dated demo rows behind.
64
+
65
+ `GET /api/dev/manifest` serves the same validated `manifestVersion: 1` checkpoint written to `.raybase/app.manifest.json` when `raybase dev` starts. Route sources are project-relative POSIX paths. Restart the dev command after route, schema, policy, persona, or runtime declaration changes; the endpoint is local-only.
@@ -0,0 +1,10 @@
1
+ ---
2
+ title: Team Tasks starter
3
+ description: Starter documentation for the generated Raybase app.
4
+ ---
5
+
6
+ The generated app starts as Team Tasks: a compact project and task workspace with local personas, user and manager permissions, Guide, search, MCP, private docs, and Raybase admin surfaces wired together.
7
+
8
+ Start with [Getting started](/docs/getting-started) for the app workflows and [Connecting to this app with AI](/docs/mcp) for the MCP boundary.
9
+
10
+ When this starter becomes a real app, replace the demo behavior with an owner-approved `dev/SPEC.md` and keep product, operator, and AI-access documentation in `content/docs`.
@@ -0,0 +1,122 @@
1
+ ---
2
+ title: Connecting to this app with AI
3
+ description: Add this app's MCP server to ChatGPT, Claude, Codex CLI, Claude Code, or another AI agent.
4
+ ---
5
+
6
+ Use this page when you want an AI Agent to work with this app through its MCP server.
7
+
8
+ Server URL:
9
+
10
+ <McpServerUrlBlock />
11
+
12
+ Use the deployed HTTPS URL for ChatGPT and Claude web/desktop connectors. If you are testing from Codex CLI or Claude Code on your own machine, `http://localhost:3000/mcp` can work. For ChatGPT, Claude web, and Claude Desktop remote connectors, expose local development through a secure HTTPS tunnel or deploy first; those products connect from provider infrastructure, not from your laptop.
13
+
14
+ ## ChatGPT web
15
+
16
+ ChatGPT custom MCP apps are configured from ChatGPT web.
17
+
18
+ 1. Open ChatGPT web and go to **Settings -> Apps & Connectors** or **Settings -> Apps**, depending on the current UI.
19
+ 2. Open **Advanced settings** and turn on **Developer mode** if it is available for your account or workspace.
20
+ 3. Return to **Apps & Connectors** or **Apps** and click **Create**.
21
+ 4. Enter an app name, a short description, and the server URL above.
22
+ 5. Choose the authentication option this app uses. For OAuth, complete the authorization prompt when ChatGPT scans tools.
23
+ 6. Click **Create** after the tool scan succeeds and the expected tools appear.
24
+ 7. In a new chat, click **+** by the composer, choose **More**, select this app, and ask ChatGPT to use it.
25
+
26
+ For Business, Enterprise, or Edu workspaces, an admin or owner may need to create, enable, publish, or allow this app from **Workspace settings -> Apps** before other users can connect it.
27
+
28
+ ChatGPT may ask for confirmation before actions that change data, depending on your workspace settings and the action being requested.
29
+
30
+ ## ChatGPT desktop
31
+
32
+ Create and manage the custom MCP app in ChatGPT web first. There is no separate documented desktop creation flow for custom MCP apps. If this app appears in the desktop app's composer tools menu after web setup, select it there; otherwise use ChatGPT web for MCP conversations with this app.
33
+
34
+ ## Claude web and desktop
35
+
36
+ Claude custom connectors are remote MCP connectors. The setup is the same in Claude web and Claude Desktop, and the connection to this app comes from Anthropic's cloud. Use the deployed HTTPS URL or an internet-reachable tunnel; `localhost` is only for separate local Claude Desktop or Claude Code configuration.
37
+
38
+ For individual plans, including Free, Pro, and Max:
39
+
40
+ 1. Open **Customize -> Connectors**.
41
+ 2. Click **+**, then **Add custom connector**.
42
+ 3. Enter a name and the server URL above.
43
+ 4. Open **Advanced settings** only if this app requires a fixed OAuth Client ID or Client Secret.
44
+ 5. Click **Add**, then **Connect** and complete authentication.
45
+ 6. In a chat, click **+**, choose **Connectors**, and toggle this connector on for the conversation.
46
+
47
+ For Team or Enterprise plans:
48
+
49
+ 1. An Owner opens **Organization settings -> Connectors**.
50
+ 2. Clicks **Add**, hovers **Custom**, selects **Web**, enters the server URL, and clicks **Add**.
51
+ 3. Each user opens **Customize -> Connectors**, finds the custom connector, clicks **Connect**, and authenticates before enabling it in a conversation.
52
+
53
+ ## Codex CLI
54
+
55
+ Codex supports streamable HTTP MCP servers. Add this app:
56
+
57
+ <CodexMcpAddCommand />
58
+
59
+ For local development:
60
+
61
+ ```bash
62
+ codex mcp add this-app-local --url http://localhost:3000/mcp
63
+ ```
64
+
65
+ If the server requires OAuth, authenticate after adding it:
66
+
67
+ ```bash
68
+ codex mcp login this-app
69
+ ```
70
+
71
+ Start `codex`, then type `/mcp` at the Codex prompt to confirm the server and tools loaded. Codex CLI and the Codex IDE extension share the same MCP configuration.
72
+
73
+ ## Claude Code CLI
74
+
75
+ Claude Code's CLI supports remote HTTP MCP servers. Add this app:
76
+
77
+ <ClaudeMcpAddCommand />
78
+
79
+ For local development:
80
+
81
+ ```bash
82
+ claude mcp add --transport http this-app-local http://localhost:3000/mcp
83
+ ```
84
+
85
+ Add `--scope user` if every Claude Code project should see the server. Otherwise Claude Code stores it in the current local scope. Then start Claude Code and type `/mcp` at the Claude Code prompt; if the server needs OAuth, select it there and complete the browser authorization flow. Use `claude mcp list`, `claude mcp get this-app`, or `claude mcp remove this-app` to manage the configuration.
86
+
87
+ ## Connect from another AI agent
88
+
89
+ 1. Choose **Add MCP server** or the closest equivalent in your agent.
90
+ 2. Use **HTTP** or **Streamable HTTP** transport.
91
+ 3. Name the server after this app.
92
+ 4. Enter the server URL above.
93
+ 5. Complete the sign-in and authorization flow.
94
+ 6. Ask the agent to list available tools so you can confirm what it can access.
95
+
96
+ ## What the AI can do
97
+
98
+ Team Tasks exposes the same bounded work surface to AI clients that signed-in users see in the app.
99
+
100
+ - **Read access** (`mcp:read`): read visible projects and tasks, get individual visible project or task rows, list visible tasks, and load a Team Tasks dashboard snapshot.
101
+ - **Write access** (`mcp:write`): create projects, update projects, archive projects, create tasks, update task fields, mark tasks done, archive tasks, delete tasks when policy allows it, and list assignable users.
102
+ - **Manager-specific access**: managers can assign tasks to any active app user, see team-level work, and hard-delete empty archived projects.
103
+ - **User-specific access**: users can create work, assign tasks to themselves, and update tasks they created or are assigned to.
104
+ - **Not available through AI**: account management, invites, `/admin`, billing, deployments, raw SQL, schema changes, backups, settings, prompt overrides, and broad generated table mutations are not exposed as Team Tasks MCP workflows.
105
+
106
+ The detailed tool names and input fields are discoverable by the AI client after connection, so keep this page focused on the scope of access and the workflows a person should expect.
107
+
108
+ ## Headless use: CLIs, CI, and agents without a browser
109
+
110
+ When the client cannot complete the browser sign-in above, sign in to this app yourself and register a machine credential for it:
111
+
112
+ ```bash
113
+ curl -X POST https://your-app.example/api/auth/oauth/register \
114
+ -H "content-type: application/json" -b "<your session cookie>" \
115
+ -d '{"client_name":"CI runner","grant_types":["client_credentials"],"scope":"mcp:read"}'
116
+ ```
117
+
118
+ The response includes a `client_id` and a one-time `client_secret`. Give both to the client; it requests access tokens with `grant_type=client_credentials` and HTTP Basic authentication, and the tokens act as you with only the scope you registered. Revoke the credential at any time with `DELETE /api/auth/oauth/clients/<client_id>` while signed in.
119
+
120
+ ## Disconnect access
121
+
122
+ Disconnect the app from your AI client when you no longer want it to use these tools. If this app includes a connected AI clients page or integrations settings page, revoke access there as well. Otherwise, contact the app owner to revoke the connection.
@@ -0,0 +1,4 @@
1
+ {
2
+ "title": "Docs",
3
+ "pages": ["index", "getting-started", "mcp"]
4
+ }
@@ -0,0 +1,84 @@
1
+ # Codebase Map
2
+
3
+ This is a curated orientation map for agents working on this generated
4
+ TanStack Start app. Keep it useful, not exhaustive. Update it when route
5
+ boundaries, schema ownership, integrations, runtime handlers, app modules, or
6
+ generated-file rules change in a way future work needs to know.
7
+
8
+ ## Product And Planning
9
+
10
+ - `dev/SPEC.md` - authoritative app contract.
11
+ - `dev/SPEC-OVERVIEW.md` - readable product story and tradeoffs.
12
+ - `dev/features/<feature-slug>/` - temporary proposal specs for substantial
13
+ in-flight work.
14
+ - `dev/features/archive/` - completed feature proposals after durable facts
15
+ have been folded back into the canonical planning docs.
16
+
17
+ ## Runtime And Data
18
+
19
+ - `src/raybase.config.ts` - app name, auth/signup mode, modules, AI/MCP, and
20
+ Raybase runtime config.
21
+ - `src/raybase.server.ts` - creates the Raybase app and exports the
22
+ app-configured `RaybaseAIChatAgentObject`.
23
+ - `src/worker-entry.ts` - Cloudflare Worker entry. Keep the
24
+ `RaybaseDatabaseObject` and `RaybaseAIChatAgentObject` exports aligned with
25
+ `wrangler.jsonc`.
26
+ - `src/db/schema.ts` - app-owned tables and policies.
27
+ - `src/db/seed.ts` - local seed data.
28
+ - `src/actions.ts` - declared app actions. The Team Tasks starter exposes
29
+ `workspace.snapshot`, `todos.list_visible`, project create/update/archive/delete,
30
+ `projects.list_visible`, task create/update/complete/archive/delete, and
31
+ `users.list_assignable`.
32
+ UI, Guide, and MCP mutations should go through these actions rather than
33
+ generic table writes.
34
+ - `src/search.ts` - SQL FTS search declarations for projects and todos.
35
+ - `src/settings.ts` - safe runtime settings declarations. The starter includes
36
+ a user-scoped dashboard density preference example.
37
+ - `src/jobs.example.ts`, `src/notifications.example.ts`, and
38
+ `src/realtime.example.ts` - disabled recipes for opt-in systems. Do not
39
+ import them until the app intentionally enables those capabilities.
40
+ - `src/db/storage.ts` and `src/ai/retrieval.ts` - disabled recipes for file
41
+ storage and semantic retrieval.
42
+ - `src/db/migrations.gen.ts` - generated by `raybase migrate`; do not hand
43
+ edit.
44
+ - `migrations/app/` - generated app-table migration files; do not hand edit
45
+ unless you are deliberately repairing a migration history.
46
+
47
+ ## App Surfaces
48
+
49
+ - `src/routes/` - TanStack Start routes for app pages, docs routes, and API
50
+ route handlers.
51
+ - `src/components/` - app UI components.
52
+ - `src/components/auth-shell.tsx`, `src/components/setup-token-page.tsx`, and
53
+ `src/components/account-menu.tsx` - app-owned account/auth UI. These call
54
+ Core auth/account endpoints; they must not read auth tables or raw operator
55
+ roles.
56
+ - `src/components/search-command-palette.tsx` - app search UI backed by
57
+ `createRaybaseSearchClient()` and `/api/search`.
58
+ - `src/guide/` - Guide configuration, corpus adapter, manifest, and resource
59
+ list.
60
+ - `content/docs/` - app user documentation served at `/docs`.
61
+ - `content/guide/` - private Guide capability context. The default Guide
62
+ allow-list can create/update/complete/archive work and list assignable
63
+ users, but intentionally does not expose hard delete.
64
+ - `DESIGN.md` - lightweight app design baseline for future screen work.
65
+ - `.source/` and generated docs outputs - generated by Fumadocs; do not hand
66
+ edit.
67
+
68
+ ## Request Flow
69
+
70
+ ```mermaid
71
+ flowchart LR
72
+ Browser["Browser"] --> Worker["src/worker-entry.ts"]
73
+ Worker --> Routes["src/routes"]
74
+ Worker --> Raybase["src/raybase.server.ts"]
75
+ Routes --> Schema["src/db/schema.ts"]
76
+ Raybase --> Data["RAYBASE_DATA Durable Object"]
77
+ Raybase --> Agent["RAYBASE_AI_CHAT_AGENT Durable Object"]
78
+ Raybase --> Actions["Declared app actions"]
79
+ Actions --> Policies["Table policies and invariants"]
80
+ Routes --> Search["/api/search"]
81
+ Routes --> Account["/api/account/me"]
82
+ Routes --> Auth["/api/auth/* Core auth APIs"]
83
+ Routes --> Docs["content/docs via /docs"]
84
+ ```