@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,409 @@
1
+ ---
2
+ name: raybase-building
3
+ description: Build a new Raybase app from the installed template. Use for the generic Raybase implementation sequence after create-raybase; pair with the installed template-specific skill for file layout, framework, design, and security review details.
4
+ ---
5
+
6
+ # Raybase Building Skill
7
+
8
+ Follow this sequence exactly.
9
+
10
+ If the raybase skill already ran the interview, wrote the planning files, and
11
+ the human approved `dev/SPEC.md`, skip steps 1–2 and continue from step 3.
12
+
13
+ ## Why This Sequence Exists
14
+
15
+ The order protects the owner intent and the runtime boundary:
16
+
17
+ - Spec first keeps the business outcome, roles, signup mode, workflows, and
18
+ Store-app fit from being guessed after code exists.
19
+ - Schema and policies before UI prevent screens that look complete but have no
20
+ reviewed authorization model.
21
+ - Seed data makes role-specific paths testable instead of relying on empty
22
+ happy paths.
23
+ - Docs and Guide stay useful only when tied to implemented behavior, not the
24
+ original chat.
25
+ - `raybase doctor`, `raybase check`, kit doctor, browser checks, and the
26
+ security review own the deterministic checks that skill prose should not try
27
+ to reimplement.
28
+
29
+ Deviate only when the request is already fully specified or a named Store
30
+ app has been approved as-is; still write down the spec and run the same
31
+ verification owners.
32
+
33
+ Before step 1, read `dev/SPEC.md`, `.raybase/store-app.json` when present, and
34
+ the installed template skill:
35
+
36
+ - TanStack Start: `.agents/skills/raybase-tanstack-start/SKILL.md`
37
+ - Astro/EmDash (Raybase Sites): `.agents/skills/raybase-astro-emdash/SKILL.md`
38
+ - React Router: `.agents/skills/raybase-react-router/SKILL.md`
39
+ - Created from an outside starter: also read the skills the starter installed
40
+ and its section of `AGENTS.md`.
41
+
42
+ Treat a draft placeholder, starter/template content, or a spec that does not
43
+ cover users, data, permissions, workflows, and the exact signup line as
44
+ unapproved. The signup line must be exactly `Signup mode: invite-only`,
45
+ `Signup mode: public self-signup`, or `Signup mode: provider-only self-signup`, and the Access section must also contain
46
+ `Cloudflare email capability`, `Auth email features`, `Invite delivery`, and
47
+ `Password recovery` lines. Ask the interview questions and stop before schema
48
+ or screens in non-interactive contexts. If the spec's why or success criteria
49
+ are unclear, ask a targeted follow-up before making product tradeoffs, but do
50
+ not invalidate an otherwise approved spec solely because it lacks a dedicated
51
+ value heading.
52
+
53
+ ## Living Planning Docs
54
+
55
+ `dev/SPEC.md` is authoritative. Also read `dev/SPEC-OVERVIEW.md` and
56
+ `dev/CODEBASE-MAP.md` when present before substantial design, architecture,
57
+ schema, route, integration, workflow, AI/MCP, or data-model work. When to
58
+ update each doc, when to skip churn, and the feature-proposal archive rule
59
+ are in [references/planning-docs.md](references/planning-docs.md). Report in
60
+ handoff what planning docs changed, or state that no planning-doc update was
61
+ needed.
62
+
63
+ If `.raybase/store-app.json` identifies the `asset-manager` Store app,
64
+ treat its `dev/SPEC.md` as an approved canonical baseline only when the prompt or
65
+ conversation clearly approved that baseline as-is. Otherwise ask whether to
66
+ accept the canonical baseline or revise `dev/SPEC.md` with approved deltas before
67
+ changing code.
68
+
69
+ Do not silently keep starter roles such as `project-manager`, demo tables, or
70
+ placeholder policies when building a new business domain.
71
+
72
+ 1. Interview in plain language. Follow the interview script in
73
+ [references/interview-and-spec.md](references/interview-and-spec.md): it
74
+ owns the required invitation to share extra materials, the
75
+ review-materials-before-drafting rule, and the question list, including
76
+ understanding the app's why. Do not draft the spec until supplied
77
+ materials have been reviewed.
78
+
79
+ 2. Write `dev/SPEC.md` and `dev/SPEC-OVERVIEW.md` together, following the
80
+ same [references/interview-and-spec.md](references/interview-and-spec.md):
81
+ it owns the required Access-section lines, the public-signup and
82
+ transactional-email prerequisites, the SPEC-OVERVIEW voice, and the exact
83
+ approval-message format. Ask the human to approve the draft or tell you
84
+ what to change before you build.
85
+
86
+ 3. Run `raybase --help`.
87
+ - Read the current command list and template guidance before building.
88
+ - If the project did not start from a Store app, inspect the Raybase
89
+ Store app index before heavy implementation. Use the hosted index at
90
+ `https://registry.raybase.dev/store/v1/index.json`, then read plausible
91
+ listings. Store apps are online-only. If a verified Store app
92
+ covers most of the spec and would save significant reimplementation, stop
93
+ and ask whether to restart from `--from <store-id>` instead of
94
+ custom-building over the blank scaffold.
95
+ - Use Raybase Kits for technical capabilities, not domain-specific business
96
+ workflows. Good Kit searches are things like `slack`, `email`,
97
+ `data grid`, `charts`, `files`, `ai chat`, or provider integrations. Do
98
+ not search Kits expecting employee leave, approval queues, procurement,
99
+ recruiting, or other business-domain apps; implement those in app code
100
+ unless a Store app fits. For a plausible technical capability, run
101
+ `raybase kits search <capability>` and `raybase kits info <kit-id>` before
102
+ writing source from scratch. Kits are copied into the app and become
103
+ app-owned source; they are not runtime plugins.
104
+
105
+ Before screen work, turn `dev/SPEC.md` into a workflow matrix: persona, data
106
+ touched, allowed actions, required UI path, and operator-only exceptions. Use
107
+ that matrix to keep app roles, policies, and screens aligned.
108
+
109
+ 4. Model data in the template's schema file.
110
+ - Use Raybase helpers from `@raybase/core`.
111
+ - Schema changes happen in source code and migrations. Do not mutate app
112
+ schema through raw SQL, runtime DDL, app routes, MCP tools, admin
113
+ shortcuts, or model-generated SQL.
114
+ - Use the installed template skill for exact paths. For example, TanStack
115
+ Start and astro-emdash apps use `src/db/schema.ts` (the astro-emdash
116
+ spine follows the TanStack Start layout), while React Router apps use
117
+ `app/db/schema.ts`.
118
+ - Destructive migrations require human approval, rollback or backup
119
+ awareness, and verification of what data will be dropped before using
120
+ `--allow-destructive`.
121
+ - If changing auth, invites, password reset, magic links, or auth email,
122
+ read and follow `.agents/skills/raybase-auth/SKILL.md`. Keep account
123
+ creation closed to owner setup and invites unless the approved spec uses
124
+ public signup with transactional email verification.
125
+ - First, set template app config roles to the business roles from the spec
126
+ (starter roles are placeholders). Define them once with
127
+ `export const appRoles = defineRoles([...] as const)`, set
128
+ `roles: appRoles`, and use `role(appRoles, "...")` in policies/actions so
129
+ misspelled role names fail at compile time. Config roles drive role-based
130
+ policies and the invite Role dropdown in `/admin`; if the app needs no
131
+ roles beyond `user`, use `defineRoles([] as const)` and set
132
+ `roles: appRoles`.
133
+ - Also set template app config `auth.signupMode` to match `dev/SPEC.md`
134
+ before schema or screen work. Use `"invite-only"` for `Signup mode:
135
+ invite-only`, `"public"` for `Signup mode: public self-signup`, and
136
+ `"provider-only"` for `Signup mode: provider-only self-signup`.
137
+ - Every table must have `read`, `create`, `update`, and `delete` policies.
138
+ - Prefer `createdBy()`, `createdAt()`, and `updatedAt()` audit columns.
139
+ - Use `userRef()` when app data points at a signed-in Raybase user. It
140
+ stores the Raybase user id for relationships such as requester, employee,
141
+ manager, approver, owner, or assignee.
142
+ - Do not read Core auth user tables, Better Auth tables, sessions, accounts,
143
+ invites, or `operatorRole` from generated app code. If the people are not
144
+ Raybase login identities, model them as app-owned domain rows instead.
145
+ - File buckets must use Raybase storage helpers and explicit policies. Store
146
+ Raybase file IDs, not raw R2 keys or presigned URLs.
147
+ - Policies speak only about business roles. Admin access to `/admin` is not an app role.
148
+ - Non-admin create, update, delete, and state-transition permissions must
149
+ correspond to visible main-app workflows. If a role should not have a UI
150
+ path for a mutation, tighten the policy rather than relying on `/admin`.
151
+ - For workflow-sensitive tables such as approvals, reviews, requests,
152
+ cancellations, assignments, reservations, or inventory movements, prefer
153
+ generic read plus module-only writes: set table `create`, `update`, and
154
+ `delete` to `denyAll` (a frozen constant, not a function — no
155
+ parentheses), then implement validated domain routes/actions
156
+ that enforce ownership, role gates, field allowlists, and allowed state
157
+ transitions before using an audited service context for the write.
158
+ - Multi-tenancy, one app installed by many customer organizations, and SSO across apps are provided by Raybase Pro. Core is single-tenant by design; converting it yourself means re-architecting the control plane and is not a supported path.
159
+ - Keep `mcp: { enabled: true }` unless the human explicitly disables AI
160
+ client access. If adding MCP tools, resources, or MCP Apps UI, read and
161
+ follow the `raybase-mcp` skill before implementing that slice.
162
+ - Read and follow `raybase-settings` before adding runtime settings.
163
+ - Mechanics for version checks (`raybase check-updates`), `raybaseSchema`
164
+ keys, user pickers for login identities, app-owned OIDC login buttons,
165
+ MCP config variants and Operator MCP scopes, file uploads, and runtime
166
+ settings are in
167
+ [references/schema-and-config.md](references/schema-and-config.md).
168
+
169
+ 5. Add believable demo data in the template's seed file.
170
+ - Empty apps demo poorly. Seed data is mandatory.
171
+ - Seed every relationship or routing table that the workflow depends on,
172
+ such as team assignments, project memberships, approver routing, or queue
173
+ ownership. If a workflow routes work to a role-holder, the local seed must
174
+ create at least one routed item so that role-specific UI is reachable.
175
+ - If the app declares multiple business roles, configure local dev personas
176
+ with `auth.devUsers` or clearly state which roles could not be exercised.
177
+ Raybase Core owns local dev session creation, login-page persona buttons,
178
+ and the local app-page dev chrome for switching personas. When configuring
179
+ custom local personas, keep a Raybase Operator Admin persona first
180
+ (`role: "owner"` or `role: "admin"`) so local `/admin` access is always
181
+ available and clearly distinct from app business roles.
182
+ - Make seed idempotent.
183
+
184
+ 6. Build screens in app-owned files.
185
+ - Read the installed template skill before screen work. It owns the route,
186
+ component, styling-entry, local dev, and framework-specific server seams.
187
+ - Read the installed template design skill before designing screens. It owns
188
+ template-appropriate typography, color, layout, motion, states, copy, and
189
+ polish.
190
+ - Treat the auth door's copy and look as part of the design pass. Start with
191
+ the app-owned `src/auth-door.ts`, and freely replace
192
+ `src/components/auth-shell.tsx` when the product needs a different door;
193
+ Raybase config continues to own auth routes and behavior.
194
+ - Use the template's established component and styling system. Do not
195
+ introduce a parallel UI framework without an explicit reason.
196
+ - Do not edit `@raybase/core` admin UI in generated apps.
197
+ - Implement every non-admin create, update, delete, and state-transition
198
+ workflow through the main app UI with domain-specific forms, buttons, and
199
+ server-side handlers, Raybase actions, or Raybase data API calls that
200
+ respect policies.
201
+ - Do not rely on `/admin`, `/admin/data`, generated table editing, CSV
202
+ import/export, or MCP tools as the required path for ordinary human users.
203
+ - Preserve the template's account/current-user affordance when replacing
204
+ starter UI. In templates that call `/api/account/me`, it is normally
205
+ appropriate for that menu to include an `/admin` link only when the
206
+ returned summary has `isOperator: true`. Do not inspect raw
207
+ `operatorRole`, auth tables, app roles, sessions, or provider accounts to
208
+ decide this.
209
+ - Provide normal signed-in navigation: app sections, Docs when enabled, and
210
+ sign-out via `POST /api/auth/logout`. Add account/current-user
211
+ affordances only when an existing supported primitive supplies the needed
212
+ data.
213
+ - Do not add app-owned local-mode persona switchers, product-header dev
214
+ persona dropdowns, app-owned auto-session helpers, `ensureLocalSession`,
215
+ or app screen calls to `/api/dev/session` or `/api/dev/session/status`. Use
216
+ `appConfig.auth.devUser` or `appConfig.auth.devUsers`; include at least
217
+ one Raybase Operator Admin persona (`role: "owner"` or `role: "admin"`)
218
+ when customizing them. Core renders the local-only chrome and login-page
219
+ buttons.
220
+ - Use `/admin/data` for operator CSV import/export and break-glass data
221
+ repair. Do not build user-facing import screens unless the approved spec
222
+ explicitly asks for a domain-specific import workflow.
223
+ - Keep the app UI consistent with the owner’s domain.
224
+ - When users do something with business rules, implement it once as a
225
+ server-side workflow/action and call that from UI. Do not encode state
226
+ transitions only in client code or rely on raw CRUD for workflows.
227
+ - When a business mutation should be shared by UI, MCP, jobs, Guide, Agents,
228
+ or the optional API, read and follow `raybase-actions` and implement it
229
+ once as `defineAction()`. Parameterize actions that use app data as
230
+ `defineActions<RaybaseEnv, typeof schema>({ ... })`, and declare `output`
231
+ for every action exposed to Guide, generic Agents, or external API routes.
232
+ - If the requested feature includes alerts, reminders, mentions, approvals,
233
+ job completion/failure messages, support captures, external callbacks, or
234
+ operator escalation, read and follow the `raybase-notifications` skill
235
+ before implementing that slice. Use Raybase notifications instead of
236
+ bespoke outbox tables, direct provider fetches, or custom websocket feeds.
237
+ - If the requested feature includes keyword search, table search, docs/help
238
+ search, or exact search grounding for AI, read and follow the
239
+ `raybase-search` skill before implementing that slice.
240
+ - If the requested feature includes live lists, table subscriptions,
241
+ presence, feed updates, or websocket behavior, read
242
+ and follow the `raybase-realtime` skill before implementing that slice.
243
+ Do not set `appConfig.realtime.enabled` to true unless the app actually
244
+ has a live-update surface.
245
+ - If a Raybase Kit fits the requested feature, install it with
246
+ `raybase add <kit-id> --accept-risk`, review the copied source, and adapt
247
+ it in the app. Run `raybase kits doctor` after install.
248
+ - If the requested feature includes AI, Agents, chat, summaries,
249
+ classification, extraction, semantic search, or RAG, read and follow the
250
+ `raybase-ai` skill before implementing that slice.
251
+
252
+ 7. Keep Docs current when Docs are enabled.
253
+ - If `.agents/skills/raybase-docs-writing/SKILL.md` is installed, read it
254
+ and update the active docs root before declaring the app ready. Resolve
255
+ docs placement from `dev/SPEC.md`, `package.json`
256
+ `raybase.modules.docs.placement`, and `.raybase/modules.json`
257
+ `modules.docs.placement`; use `content/docs` for `spine` and
258
+ `site/content/docs` for `site`.
259
+ - Treat app-specific docs as a deliverable alongside screens, schema,
260
+ policies, seed data, and verification.
261
+ - Replace starter placeholder pages with documentation for the real user,
262
+ operator, and API workflows that now exist. Do not document future or
263
+ unimplemented behavior as fact.
264
+ - If Docs are disabled because the human requested that, say so in the
265
+ handoff instead of creating a parallel docs system.
266
+
267
+ 8. Keep public-surface docs architecture explicit in `dev/SPEC.md`.
268
+ - Infer private in-app docs for internal tools, dashboards, invite-only apps,
269
+ operational apps, back-office workflows, and internal developer tools.
270
+ - Infer public Astro/EmDash site plus public docs when the app has an
271
+ external customer/developer audience, API/SDK docs, a documentation site,
272
+ launch/marketing site, public product, template, or storefront.
273
+ - Ask only when a public-facing app/site is clear but docs audience remains
274
+ architecture-changing ambiguity.
275
+ - Keep these exact structured lines present:
276
+ `Public surface: ...`, `Documentation: ...`, and
277
+ `Docs exposure: ...`.
278
+ - `Docs exposure: public` is the default and what the starters do. Write
279
+ `signed-in only` only when the builder chooses it, and in the same change
280
+ add the sign-in check to the docs routes as the framework skill
281
+ describes.
282
+
283
+ If the approved spec requires the Core web operator panel to be absent, set
284
+ `admin: { enabled: false }` in source-owned `appConfig`, then rebuild and
285
+ redeploy. Do not implement this by hiding links or adding custom 404 routes.
286
+ The config switch owns `/admin`, admin docs, `/api/admin/*`,
287
+ `/raybase-admin/*`, and the admin-mode data/file transports. It is not a table
288
+ policy or `operatorVisible` setting. Consider Operator MCP separately and set
289
+ `mcp.operator.enabled: false` as well when the product requires that surface
290
+ removed. Note that `raybase export` remains tied to the admin data browser,
291
+ while backup/restore lifecycle commands continue through deployment routes.
292
+
293
+ For disabled deployments, verify every removed route family returns 404 and
294
+ that no `raybase-admin` JS/CSS is present in built client output. For the
295
+ default/enabled mode, keep the normal signed-in `/admin` verification below.
296
+
297
+ 9. Run:
298
+
299
+ ```bash
300
+ raybase migrate
301
+ pnpm test
302
+ raybase kits doctor
303
+ raybase doctor
304
+ raybase check
305
+ raybase dev
306
+ ```
307
+
308
+ Start `raybase dev` yourself in a long-running local session; do not present it
309
+ as a command for the owner to run. Keep the server available through browser
310
+ verification and the user-facing handoff unless the local environment makes
311
+ that impossible. If a blocker prevents local startup, report the blocker and
312
+ the exact command or human-owned step needed before the app can be reviewed.
313
+
314
+ Make every time-dependent test deterministic. Inject a clock or explicit
315
+ `now` value into domain logic and freeze it for the test; no assertion may
316
+ depend on the real wall clock. For local runtime workflow checks, set the app
317
+ clock through the Core-owned dev chrome or local-only `/api/dev/time`
318
+ endpoint, but keep test expectations fixed. Review expected strings as product
319
+ output: an expectation containing an obvious grammar, pluralization, or
320
+ formatting defect is a review blocker, not a reason to preserve the defect.
321
+
322
+ 10. Run the installed template security review.
323
+ - TanStack Start: read
324
+ `.agents/skills/raybase-tanstack-start-security-review/SKILL.md`.
325
+ - Astro/EmDash: read
326
+ `.agents/skills/raybase-astro-emdash-security-review/SKILL.md`.
327
+ - React Router: read
328
+ `.agents/skills/raybase-react-router-security-review/SKILL.md`.
329
+ - Created from an outside starter: also run the security review skill the
330
+ starter installed, if any.
331
+ - Follow the applicable review before declaring the app ready.
332
+ - Fix high-confidence findings, then rerun `raybase doctor`, `raybase check`,
333
+ and the focused review.
334
+
335
+ 11. Open the template-specific local URL from the installed template skill and verify:
336
+ - The app's main route shows the app.
337
+ - `/admin` loads without errors and shows the admin panel, including data
338
+ and users. Authenticate with the Raybase Operator Admin/local owner
339
+ persona for this check; the persona is only the prerequisite for verifying
340
+ the admin panel loads.
341
+ - `/docs` loads with current app-specific docs when Docs are enabled.
342
+ - A non-admin persona cannot perform admin actions when tested.
343
+ - Each declared business role has at least one seeded, exercisable workflow
344
+ path. For example, a manager sees at least one review item and people ops
345
+ can load the oversight view. Record any role that remains unverified and
346
+ why.
347
+ - Non-admin app users do not see generated `/admin` links or need `/admin`,
348
+ generated data editing, CSV import/export, or MCP to complete ordinary
349
+ workflows.
350
+ - Where the template exposes an account/current-user menu, the Raybase
351
+ Operator Admin/local owner persona can see the `/admin` link there. A
352
+ normal user persona cannot see that link in the same menu.
353
+ - Local app pages show the Core-owned local dev chrome when `raybase dev`
354
+ is running, and app product headers do not contain local dev persona UI.
355
+ - Every hard product gate has a documented local-development path to the UI
356
+ behind it. If a fresh local browser cannot satisfy a prerequisite such as
357
+ a device capability or external subscription, provide a deterministic
358
+ local-only fixture, config path, or bypass, verify that it is unavailable
359
+ in production, and document how QA activates it.
360
+
361
+ Before the final handoff, perform one last reachability check against the exact
362
+ local URL you will give the user. Use `curl -sS -o /dev/null -w "%{http_code}"`
363
+ or browser tooling after all edits, verification, screenshots, cleanup, and log
364
+ updates are done. If the URL is unreachable, returns an unexpected 4xx/5xx, or
365
+ the dev process appears stale, do not hand off the stale URL: stop the old dev
366
+ process if needed, start a fresh `raybase dev`, poll until the app responds,
367
+ and report that fresh URL. Do not delete or clean live runtime directories such as
368
+ `.wrangler` while their dev server is still running; stop the process first and
369
+ restart it after cleanup.
370
+
371
+ For the first presentation after the initial build, include the verified local
372
+ app URL and any relevant local persona/setup details the owner needs to click
373
+ through the app immediately. Do not hand back only a summary of files changed or
374
+ a list of commands while a local run is feasible.
375
+
376
+ End the handoff by offering to set the app live next. Do not deploy
377
+ automatically; ask for explicit confirmation and, if the human says yes, follow
378
+ `.agents/skills/raybase-deploy/SKILL.md`.
379
+
380
+ Forbidden:
381
+ - Do not skip `dev/SPEC.md`.
382
+ - Do not add custom auth.
383
+ - Do not call Better Auth APIs directly. Use Raybase helpers, the
384
+ template's provider configuration seam, and core-owned
385
+ `/api/auth/*` handlers.
386
+ - Do not expose signup by adding `/signup`, `/api/auth/signup`, `/api/auth/*`,
387
+ or broad API paths to `auth.publicRoutes`; public signup is controlled by
388
+ `appConfig.auth.signupMode`.
389
+ - Do not add `/api/raybase/session`, `/api/raybase/admin-status`, `/api/me`,
390
+ `/api/current-user`, hidden `/admin` probes, hidden `/api/admin/app` probes,
391
+ or app-facing user-directory endpoints as shortcuts for navigation or
392
+ permissions.
393
+ - Do not add app-owned local-mode persona switchers, product-header dev
394
+ persona dropdowns, app-owned auto-session helpers, `ensureLocalSession`, or
395
+ app screen calls to `/api/dev/session` or `/api/dev/session/status`.
396
+ - Do not configure only app-role local personas. Custom `auth.devUser` or
397
+ `auth.devUsers` must include a Raybase Operator Admin persona with
398
+ `role: "owner"` or `role: "admin"` for local `/admin` access.
399
+ - Do not import or use `unsafeDb`.
400
+ - Do not call `env.RAYBASE_FILES.get/put/delete/list` from app code. Raybase
401
+ file APIs keep bytes behind auth, policies, audit, and attachment-safe
402
+ downloads.
403
+ - Do not change schema through runtime endpoints or admin UI. Edit the
404
+ template's schema source file, then run `raybase migrate`.
405
+ - Do not call `env.AI.run` directly from app code. Use Raybase AI helpers so
406
+ budgets, audit, Gateway metadata, and user-scoped action policies apply.
407
+ - Do not add new top-level dependencies without flagging why.
408
+ - Do not request or create runtime "plugin packages" for app capabilities when
409
+ a Raybase Kit or app-owned source module is the right shape.
@@ -0,0 +1,87 @@
1
+ # Interview And Spec Writing
2
+
3
+ Detail for raybase-building steps 1–2. The invitation wording, the
4
+ review-materials-before-drafting rule, the exact Access-section lines, and the
5
+ approval-message format below are requirements, not suggestions. If the
6
+ raybase skill already ran the interview and the human approved `dev/SPEC.md`,
7
+ none of this file applies.
8
+
9
+ ## Interview In Plain Language
10
+
11
+ Frame questions around what you need to understand to draft an accurate spec;
12
+ do not lead with "Raybase requires..." or platform policy recitations. Make
13
+ sure you understand the app's why when it is not already clear: what problem
14
+ it solves, why that matters, and what success would look like. Tell the user
15
+ they can answer briefly or provide any extra context they want, such as
16
+ existing docs, manuals, spreadsheets, screenshots, PDFs, or links to
17
+ apps/workflows they want to resemble. The first visible spec-discovery message
18
+ must include this invitation; do not shorten it to only "You can answer
19
+ briefly." It must also say that if the user shares links or files, you will
20
+ review them and synthesize the relevant details before drafting. If the user
21
+ provides links, PDFs, screenshots, documents, spreadsheets, or other files,
22
+ gather that context before drafting `dev/SPEC.md`. Use available subagents
23
+ when helpful to visit links, inspect files, and extract relevant requirements,
24
+ terminology, workflows, roles, permissions, data fields, edge cases, and
25
+ constraints, or inspect the materials directly. Synthesize the gathered
26
+ context yourself before asking follow-up questions or writing the draft. Do
27
+ not draft the spec until those supplied materials have been reviewed.
28
+
29
+ - What does the app do?
30
+ - What problem does it solve, why does that matter, and what would success look like?
31
+ - Who uses it?
32
+ - What data does it track?
33
+ - Who can see, create, update, and delete each kind of data?
34
+ - Should the app use invite-only signup, public provider-and-password signup,
35
+ or provider-only self-signup with password signup closed?
36
+ - Does the app need auth email features such as password reset, emailed
37
+ invites, welcome email, public signup email verification, or magic links?
38
+ If yes, has the owner confirmed Workers Paid plus Cloudflare Email
39
+ Sending/domain onboarding?
40
+ - What business roles exist? Use names like `manager`, `approver`, or `operations`; do not use generic `admin` as an app role.
41
+
42
+ ## Write dev/SPEC.md And dev/SPEC-OVERVIEW.md Together
43
+
44
+ - Keep it readable by a non-technical owner.
45
+ - Include an access section with exactly `Signup mode: invite-only`, `Signup
46
+ mode: public self-signup`, or `Signup mode: provider-only self-signup`.
47
+ - Include `Cloudflare email capability`, `Auth email features`, `Invite
48
+ delivery`, and `Password recovery` lines in the same Access section.
49
+ Default to `Cloudflare email capability: free-compatible`, `Auth email
50
+ features: none`, `Invite delivery: admin-shared links`, and `Password
51
+ recovery: admin-assisted`.
52
+ - Invite-only remains the default placeholder. Public self-signup is allowed
53
+ only when explicitly approved, creates normal `user` users only, never
54
+ creates Raybase operators/admins, and leaves Raybase `/admin`
55
+ invite/operator-only. `"public"` opens provider and password signup and
56
+ requires owner-confirmed Workers Paid plus Cloudflare Email Sending/domain
57
+ onboarding, `Cloudflare email capability: transactional-email`, and public
58
+ signup email verification. `"provider-only"` opens configured providers and
59
+ closes password signup, so it needs no auth email; password sign-in remains
60
+ available to existing accounts.
61
+ - Use `Cloudflare email capability: transactional-email` only after the
62
+ owner confirms the paid transactional-email prerequisite. Cloudflare
63
+ verified destination addresses are only for operator/admin notifications
64
+ or intentional test sends, not end-user auth verification, password reset,
65
+ invite email, welcome email, magic-link auth, or public signup.
66
+ - Write `dev/SPEC-OVERVIEW.md` from the same draft facts. It should be both
67
+ useful and entertaining: a warm, witty, owner-readable product story that
68
+ explains what the app does, why it matters, who it helps, the workflow arc,
69
+ real tradeoffs, and what is deliberately out of scope. It can sound like
70
+ someone competent has seen the spreadsheet hellmouth and come back with
71
+ boundaries. It must not invent facts or scope beyond `dev/SPEC.md`. Keep
72
+ it concise enough to read comfortably in the approval message, usually
73
+ 200-400 words unless the app needs unusual nuance.
74
+ - Ask the human to approve the draft or tell you what to change before you
75
+ build. Open with owner-facing copy such as: "Here's the overview I've
76
+ drafted." Then render the contents of `dev/SPEC-OVERVIEW.md` directly in
77
+ the message as normal Markdown, not inside a code block. After the
78
+ overview, link `dev/SPEC.md` with copy such as: "Here's the full spec if
79
+ you'd like to review the details." Close with approval or feedback copy
80
+ such as: "If this looks right, reply `approved` and I'll build the app. If
81
+ anything needs changing, tell me what to adjust and I'll revise the files
82
+ before building." A quiet note that the overview is saved to
83
+ `dev/SPEC-OVERVIEW.md` is fine, but a separate overview link is optional
84
+ because the content is already in the message. If the draft is revised,
85
+ repeat the same pattern with the updated overview content.
86
+ - Do not end the spec draft with a technical implementation inventory such
87
+ as schema, seed data, workflows, screens, docs/design notes, or checks.
@@ -0,0 +1,26 @@
1
+ # Living Planning Docs
2
+
3
+ When to update `dev/SPEC.md`, `dev/SPEC-OVERVIEW.md`, and
4
+ `dev/CODEBASE-MAP.md`, and when to skip churn. `dev/SPEC.md` is
5
+ authoritative.
6
+
7
+ - Update `dev/SPEC.md` when approved product behavior, business goals, success
8
+ criteria, access mode, roles, data, permissions, workflows, integrations,
9
+ AI/MCP, docs expectations, or non-goals change.
10
+ - Update `dev/SPEC-OVERVIEW.md` when the product story, business outcome,
11
+ target user, workflow feel, important tradeoffs, or explicit exclusions
12
+ change.
13
+ - Update `dev/CODEBASE-MAP.md` when substantial route boundaries, schema/data
14
+ ownership, integrations, runtime handlers, app modules, generated files, or
15
+ architectural workflows change.
16
+ - Skip planning-doc churn for tiny bug fixes, pure styling polish, copy tweaks,
17
+ refactors that do not change boundaries, dependency bumps with no app behavior
18
+ change, or generated-file noise.
19
+ - Do not keep feature proposal docs alive forever. When implemented, archive
20
+ `dev/features/<feature-slug>/` under `dev/features/archive/` after folding
21
+ durable facts into `dev/SPEC.md`, `dev/SPEC-OVERVIEW.md`, and
22
+ `dev/CODEBASE-MAP.md`.
23
+ - Report in handoff what planning docs changed, or state that no planning-doc
24
+ update was needed.
25
+ - Tone/style customizations may affect overview voice later, but never facts,
26
+ scope, or acceptance criteria.
@@ -0,0 +1,70 @@
1
+ # Schema And App Config Mechanics
2
+
3
+ Detail for raybase-building step 4. The schema invariants and the
4
+ capability-skill routing stay in SKILL.md; read this file when actually doing
5
+ the slice.
6
+
7
+ ## Version Checks
8
+
9
+ Before serious schema work, run `raybase check-updates` and apply printed
10
+ Raybase updates when relevant. If the release index cannot be fetched, treat
11
+ the check as inconclusive rather than proof that everything is current; note
12
+ the warning in handoff and continue only when no version-sensitive fix is
13
+ needed.
14
+
15
+ ## raybaseSchema Keys
16
+
17
+ In `raybaseSchema({ ... })`, use each table's actual Raybase table name as
18
+ the object key. If the table is `raybaseTable("leave_requests", ...)`,
19
+ register it as `raybaseSchema({ leave_requests: leaveRequests })`, not
20
+ `raybaseSchema({ leaveRequests })`.
21
+
22
+ ## user pickers For Login Identities
23
+
24
+ If the app needs a picker/search for invited login identities, wrap
25
+ `listAppUsers()` in an explicit read-only `defineAction()` with a
26
+ product-specific policy and fixed `appRoles` filter, then register it with
27
+ `actionRoute()`. Use `getAppUserById()` or `getAppUserByEmail()` at
28
+ mutation time to verify the selected person still has the required app
29
+ role before storing the id in a `userRef()` column.
30
+
31
+ ## App-Owned OIDC Login Buttons
32
+
33
+ If the app needs Google, Google Workspace, Microsoft Entra, GitHub, Apple,
34
+ Okta, Auth0, Keycloak, or another OIDC login button, keep it app-owned and
35
+ invite-only: add metadata to the template's Raybase config, configure
36
+ Better Auth provider options through the template's provider seam, store
37
+ credentials in Worker secrets or local `.dev.vars`, and run
38
+ `raybase doctor`. Do not add custom Better Auth handlers, custom
39
+ user/session/account tables, broad public routes, provider tokens in audit
40
+ metadata, domain auto-provisioning, SAML/SCIM, directory groups, or
41
+ group-to-role mapping in Core.
42
+
43
+ ## MCP Configuration
44
+
45
+ Keeping `mcp: { enabled: true }` exposes app MCP at `/mcp` and Operator MCP at
46
+ `/mcp/operator` for authorized operators. Operator MCP grants are scoped:
47
+ read grants expose production evidence, while narrow write grants expose
48
+ only typed, audited app-data, app-setting, invite, and user-lifecycle
49
+ operations. Business workflow mutations should still be declared app
50
+ actions rather than generic table writes.
51
+ Disable all MCP with `mcp: { enabled: false }`; keep app MCP but disable
52
+ only Operator MCP with
53
+ `mcp: { enabled: true, operator: { enabled: false } }`.
54
+
55
+ ## File Uploads
56
+
57
+ If the app needs uploads, declare buckets in the template's storage file
58
+ with `raybaseBucket()` and `raybaseStorage()`, pass `storage` to the
59
+ Raybase runtime, and add a `RAYBASE_FILES` R2 binding. Use `/api/files` or
60
+ `createRaybaseStorage()`, never raw R2.
61
+
62
+ ## Runtime Settings
63
+
64
+ Use `defineSettings()` and `setting.*()` only for safe, non-secret
65
+ runtime values that admins may override, such as feature flags, support
66
+ email addresses, AI defaults, or user preferences. Pass the result as
67
+ `settings` to `createRaybaseApp`. Core supports `app` and `user`
68
+ scopes; `organization` scope requires Raybase Pro. Keep secrets,
69
+ Cloudflare bindings, auth route wiring, MCP endpoints, schema, and roles
70
+ in Wrangler/env vars or `RaybaseConfig`, not settings.