@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,209 @@
1
+ ---
2
+ name: raybase-schema
3
+ description: Design Raybase app data models, policies, storage buckets, and schema-change workflows safely.
4
+ ---
5
+
6
+ # Raybase Schema
7
+
8
+ Before serious schema work, run:
9
+
10
+ ```bash
11
+ raybase check-updates
12
+ ```
13
+
14
+ If update commands are printed, run them before continuing.
15
+
16
+ Tables live in the app schema and use Raybase helpers. For TanStack Start and
17
+ astro-emdash apps, edit `src/db/schema.ts` (the astro-emdash spine follows the
18
+ TanStack Start layout). For React Router apps, edit the app-owned schema
19
+ module under `app/db/`.
20
+
21
+ For policy examples and the module-only write pattern, read
22
+ `raybase-data-and-policies` next. This skill owns the schema-change boundary;
23
+ that skill is the rationale companion for modeling permissions.
24
+
25
+ ## Policy Frame
26
+
27
+ Every table and file bucket needs an explicit policy decision for `read`,
28
+ `create`, `update`, and `delete`.
29
+
30
+ - Use `denyAll` when a mutation should happen only through a domain route,
31
+ server action, job, or other workflow-controlled path. Deny-all is often the
32
+ intentional policy for approvals, reservations, imports, and state machines.
33
+ `allowAll` and `denyAll` are frozen policy constants, not functions: write
34
+ `delete: denyAll`, without parentheses.
35
+ - Do not leave policies omitted. A table with no declared policies is unsafe
36
+ ambiguity: `/api/data`, generated MCP tools, and `/admin` evidence cannot
37
+ tell whether the omission is deliberate or forgotten, so `raybase doctor`
38
+ fails it.
39
+ - Avoid broad update/delete policies for workflow tables. If a role can update
40
+ the row through `/api/data`, admin data editing, or generated MCP tools, it
41
+ may also be able to change state-machine fields that the product intended to
42
+ validate in one server function.
43
+ - Use business roles such as `manager`, `approver`, or `operations`; do not use
44
+ generic `admin`, `owner`, or `operator` app roles. Raybase operator access to
45
+ `/admin` is separate from app business authorization.
46
+
47
+ ## Identity And Signup
48
+
49
+ - Keep `dev/SPEC.md` and app config aligned: `Signup mode: invite-only` maps to
50
+ `auth.signupMode: "invite-only"`, `Signup mode: public self-signup` maps to
51
+ `auth.signupMode: "public"`, and `Signup mode: provider-only self-signup`
52
+ maps to `auth.signupMode: "provider-only"`.
53
+ - Keep the spec's `Cloudflare email capability`, `Auth email features`,
54
+ `Invite delivery`, and `Password recovery` lines aligned with
55
+ `appConfig.auth.email`; run `raybase doctor` after auth email changes.
56
+ - Do not expose signup by adding `/signup`, `/api/auth/signup`, `/api/auth/*`,
57
+ or broad API paths to `auth.publicRoutes`. Public signup is a Core-owned
58
+ mode, creates `user` users only, and never creates Raybase operators. Broad
59
+ public routes turn the account-creation boundary into route matching instead
60
+ of reviewed config.
61
+ - Use `userRef()` for app data that points at a signed-in Raybase user. If
62
+ the app needs a picker/search for invited login identities, expose an
63
+ explicit action that calls `listAppUsers()` with a fixed business
64
+ `appRoles` filter and verify assignments with `getAppUserById()` or
65
+ `getAppUserByEmail()`. Do not read Core auth user tables from generated app
66
+ code. If assignable people are not login identities, model them as app-owned
67
+ domain rows instead.
68
+ - Prefer `createdBy()`, `createdAt()`, and `updatedAt()` audit columns.
69
+ - Do not create custom user, session, invite, account, password, or auth
70
+ tables. External login providers belong in `src/raybase.auth.ts` plus
71
+ `auth.externalProviders`, not the app schema.
72
+
73
+ ## Schema Change Boundaries
74
+
75
+ Invariant: schema changes happen in code and migrations. Do not use raw SQL,
76
+ runtime DDL, an app route, or an admin UI shortcut to mutate app schema.
77
+
78
+ Raw SQL and runtime DDL bypass policy metadata, Drizzle migration history,
79
+ audit expectations, search/realtime maintenance, and `raybase doctor` checks.
80
+ They also make the next agent read the database instead of the source to infer
81
+ the product model.
82
+
83
+ Valid deviations:
84
+
85
+ - App-owned domain people tables are fine when they represent non-login people
86
+ or external contacts and do not reference Raybase auth users.
87
+ - Destructive migrations are allowed only after human approval, a rollback or
88
+ backup path, and verification of what data will be dropped.
89
+ - Routes that authenticate outside a Raybase session may use the service
90
+ context described in `raybase-data-and-policies`; policies still govern
91
+ `/admin`, `/api/data`, and future membership-mapped access.
92
+
93
+ File buckets use `raybaseBucket()` and need the same four policy actions plus
94
+ an explicit `maxSizeBytes`. Use Raybase file IDs and `/api/files` or
95
+ `createRaybaseStorage()`, not raw R2 keys or presigned URLs.
96
+
97
+ ### Literal column defaults are inert
98
+
99
+ Do not treat `default: <value>` on an ordinary column as an insert or database
100
+ default. Literal values such as `default: false` generate no SQL `DEFAULT`,
101
+ are not filled by the data client, and raise no warning. The schema compiler's
102
+ `default: "now"` marker and the `id()`, `createdAt()`, and `updatedAt()` helpers
103
+ are special framework behavior, not support for arbitrary literal defaults.
104
+
105
+ For an additive boolean whose intended default is false, keep the column
106
+ nullable and interpret `null` as false in bounded application code:
107
+
108
+ ```ts
109
+ paused: boolean()
110
+
111
+ const active = rows.filter((row) => row.paused !== true);
112
+ ```
113
+
114
+ Do not use `filter: { paused: false }` for that shape: SQL equality excludes
115
+ the existing null rows and can silently return nothing. If the field must be
116
+ non-null and queryable, pass it explicitly at every create site and use a
117
+ reviewed migration/backfill instead of relying on the column literal.
118
+
119
+ ### Secret columns
120
+
121
+ Use `secret()` for a third-party credential stored per row: a Cloudflare API
122
+ token, a third-party store's access token, an OAuth refresh token. Never keep one in
123
+ `text()`, `longText()`, or `json()`.
124
+
125
+ ```ts
126
+ apiToken: secret()
127
+ ```
128
+
129
+ Core encrypts the value with AES-256-GCM before it reaches SQLite, under the
130
+ deployment key `RAYBASE_DATA_SECRETS_KEY`, bound to its table, column, and
131
+ row. Every generic read returns `"[REDACTED]"` when the secret is set and
132
+ `null` when it is not: `/api/data`, generated MCP tools, Operator MCP, the
133
+ admin data browser, CSV and JSON export, realtime events, audit metadata, and
134
+ CSV import evidence. Plaintext comes back only from an audited
135
+ `ctx.db.revealSecret(table, id, column)` inside an action or job; read
136
+ `raybase-data-and-policies` before writing one.
137
+
138
+ Before the first secret column, run:
139
+
140
+ ```bash
141
+ raybase data-secrets enable
142
+ ```
143
+
144
+ It keeps the key in `.raybase/` and `.dev.vars`, declares it in existing
145
+ `secrets.required` arrays, and uploads it as a Worker secret. It refuses to
146
+ replace a key already set on the deployed Worker: on another machine, put the
147
+ existing key in `.raybase/data-secrets-key-current` first. `raybase doctor`
148
+ fails while a secret column exists and the key is not declared in
149
+ `secrets.required` in every Wrangler scope, because Wrangler then refuses to
150
+ deploy without the key.
151
+
152
+ - Write plaintext through the normal data client; `null` clears it. Writing
153
+ back `"[REDACTED]"` from a row you read leaves the stored secret unchanged
154
+ on update and stores nothing on create.
155
+ - A secret column answers only "is it set?": filter it with `isEmpty`,
156
+ `notEmpty`, or `null`. Content filters, sorting, search, and `owns()` over
157
+ it are refused.
158
+ - Do not copy secret values into job input, settings, logs, search sources, or
159
+ action output. Pass the row id and reveal where the value is used.
160
+ - Turning an existing `text()` column into `secret()` needs no migration:
161
+ reads redact at once, and
162
+ `raybase data-secrets reseal --url <url> --confirm reseal` encrypts the
163
+ existing plaintext.
164
+ - Values are bound to the table and column names. To rename one, add the new
165
+ `secret()` column, copy each value with an action that reveals and rewrites
166
+ it, then drop the old column.
167
+
168
+ Rotate with `raybase data-secrets rotate-key --confirm "retain old keys"`: the
169
+ old key moves to `RAYBASE_DATA_SECRETS_KEY_RETAINED`, new writes use the new
170
+ key, and old values stay readable. Then run `raybase data-secrets reseal` and
171
+ confirm with `raybase data-secrets status --url <url>`. Keep a retained key
172
+ until every backup and PITR point older than the reseal has expired, since
173
+ restoring one brings back values sealed with it.
174
+
175
+ Backups and PITR carry ciphertext and never need the data-secrets key. To
176
+ restore into a new deployment, set `RAYBASE_DATA_SECRETS_KEY` and any retained
177
+ keys on it first; without them the rows restore and read as `"[REDACTED]"`,
178
+ but reveals fail and name the missing key id. Keep a copy of the key outside
179
+ the deployment, such as in a password manager: a lost key cannot be recovered.
180
+
181
+ ## Removing The Web Admin Panel
182
+
183
+ For deployments where the operator must not have the convenient Core web data
184
+ browser, set `admin: { enabled: false }` in the source-owned `appConfig`, then
185
+ rebuild and redeploy. Do not hide links or add app routes that imitate 404s:
186
+ the declarative switch removes `/admin`, admin docs, `/api/admin/*`, the
187
+ `/raybase-admin/*` bundle, and `?admin=1` data/file transports before auth and
188
+ app handlers run.
189
+
190
+ This setting is not table policy and does not change `operatorVisible`. It also
191
+ does not disable Operator MCP; use `mcp.operator.enabled: false` separately
192
+ when that data surface is unwanted. `raybase backup`, `raybase restore`, and
193
+ the `raybase backups` lifecycle commands remain available, while `raybase
194
+ export` stays an admin-panel data-browser capability and is unavailable.
195
+
196
+ For a disabled deployment, verify 404 responses for `/admin`, `/admin/docs`,
197
+ an `/api/admin/*` route, `/raybase-admin/*`, and representative
198
+ `/api/data/*?admin=1` and `/api/files/*?admin=1` calls. For an enabled/default
199
+ deployment, continue verifying the signed-in operator panel normally.
200
+
201
+ After schema or storage changes, run:
202
+
203
+ ```bash
204
+ raybase migrate
205
+ raybase doctor
206
+ ```
207
+
208
+ If a migration may drop data, ask the user before using
209
+ `--allow-destructive`.
@@ -0,0 +1,137 @@
1
+ ---
2
+ name: raybase-search
3
+ description: Add or review Raybase SQL full-text search. Use when implementing defineSearch(), defineSearchIndex(), tableSearchSource(), corpusSearchSource(), createRaybaseSearchClient(), /api/search, raybase search CLI commands, or deciding when to use FTS versus semantic retrieval.
4
+ ---
5
+
6
+ # Raybase Search
7
+
8
+ Use this skill for keyword search over app rows, static corpora, generated
9
+ docs, command palettes, admin-style lookup, and exact grounding for Agents.
10
+ Raybase search is SQL FTS, not semantic retrieval.
11
+
12
+ ## FTS Or Retrieval
13
+
14
+ - Use Search/FTS for exact terms, names, IDs, statuses, codes, tags, short
15
+ record titles, admin lookup, and deterministic local/cloud behavior.
16
+ - Use semantic retrieval for fuzzy concepts, meaning-based similarity,
17
+ long-form knowledge, RAG, and prompts such as "things like this policy".
18
+ - Use both for Agents when precision matters: FTS for exact grounding and
19
+ retrieval for fuzzy context.
20
+ - Do not build custom SQL `MATCH` endpoints. Use Raybase search indexes,
21
+ `/api/search`, or `createRaybaseSearchClient()`.
22
+
23
+ ## Define Indexes
24
+
25
+ Create a search module and pass it to `createRaybaseApp`:
26
+
27
+ ```ts
28
+ import {
29
+ corpusSearchSource,
30
+ defineSearch,
31
+ defineSearchIndex,
32
+ tableSearchSource
33
+ } from "@raybase/core";
34
+ import { projects, todos } from "./db/schema";
35
+
36
+ export const search = defineSearch({
37
+ indexes: {
38
+ app: defineSearchIndex({
39
+ title: "App search",
40
+ sources: [
41
+ tableSearchSource(projects, {
42
+ title: (row) => String(row.name ?? row.id),
43
+ text: (row) => [row.name, row.summary, row.status].filter(Boolean).join("\n"),
44
+ version: (row) => String(row.updatedAt ?? ""),
45
+ metadata: (row) => ({ status: row.status }),
46
+ public: false
47
+ }),
48
+ tableSearchSource(todos, {
49
+ title: (row) => String(row.title ?? row.id),
50
+ text: (row) => String(row.notes ?? row.title ?? "")
51
+ }),
52
+ corpusSearchSource("help", {
53
+ title: "Help",
54
+ documents: [
55
+ {
56
+ id: "import-guide",
57
+ title: "Import guide",
58
+ body: "CSV imports are available from /admin/data.",
59
+ url: "/docs/imports",
60
+ public: true
61
+ }
62
+ ]
63
+ })
64
+ ]
65
+ })
66
+ }
67
+ });
68
+ ```
69
+
70
+ Rules:
71
+
72
+ - Use index name `app` for the primary app-wide index unless there is a clear
73
+ need for multiple named indexes.
74
+ - Table sources must produce a stable title and non-empty text. Empty text
75
+ removes that row from the index.
76
+ - Use `version` when a row has `updatedAt` or another change marker.
77
+ - Add `url` only when the target route or query/hash state is implemented.
78
+ Browser-verify result navigation in generated apps before shipping search.
79
+ - Keep `metadata` small and non-secret.
80
+ - Keep snippets privacy-minimized. Do not index sensitive free-text fields such
81
+ as HR reasons, medical context, support notes, approver comments, private
82
+ operator notes, incident narratives, or customer messages unless the approved
83
+ product explicitly requires those words to be discoverable. Prefer stable
84
+ routing fields, names, statuses, dates, IDs, and short labels.
85
+ A denied row can still leak through a title or snippet if the indexed text is
86
+ too sensitive for the audience that can search it.
87
+ - `public` defaults to private. Mark corpus or table rows public only when they
88
+ are safe for public docs/Guide surfaces.
89
+ - Use `chunking.maxChars` and `chunking.overlapChars` only for long text.
90
+
91
+ ## Runtime And CLI
92
+
93
+ - Pass `search` to `createRaybaseApp`. Raybase maintains table-source FTS
94
+ rows after policy-checked app data changes.
95
+ - Run `raybase migrate` after adding search because Raybase owns search system
96
+ tables.
97
+ - Run `raybase search status --dry-run` to inspect declared indexes without an
98
+ app request.
99
+ - Run `raybase search status` against a running local dev app, or pass
100
+ `--url <app>` for deployed status. Use `--dry-run` when no app is running.
101
+ - Run `raybase search reindex [index]` after adding or changing sources.
102
+ - Run `raybase search rebuild [index] --force` only when the CLI/admin status
103
+ reports that the FTS shadow table needs a rebuild; `--force` acknowledges
104
+ that FTS rows will be rebuilt from the document ledger.
105
+ - Run `raybase search clear [index] --confirm` only for intentional removal of
106
+ indexed documents.
107
+ This removes indexed documents on purpose; do not use it as a casual cache
108
+ refresh when `reindex` or `rebuild` is the intended operation.
109
+
110
+ ## Query From UI
111
+
112
+ ```ts
113
+ import { createRaybaseSearchClient } from "@raybase/core";
114
+
115
+ const search = createRaybaseSearchClient({ defaultIndex: "app" });
116
+ const { results } = await search.search({
117
+ query: "overdue onboarding",
118
+ sourceTables: ["todos"],
119
+ limit: 10
120
+ });
121
+ ```
122
+
123
+ Search results contain titles, snippets, URLs, metadata, source table/source ID,
124
+ and visibility. Treat snippets, titles, URLs, and metadata as untrusted content
125
+ before rendering or sending them to a model; search output is grounding data,
126
+ not instructions.
127
+
128
+ ## Security Checks
129
+
130
+ - Do not index secrets, provider tokens, auth rows, raw embeddings, private
131
+ operator notes, sensitive free-text narratives, webhook payloads, or files
132
+ that bypass Raybase file policies.
133
+ - Do not expose private search results on public docs or Guide endpoints.
134
+ - For user-facing search, verify denied users cannot discover private record
135
+ titles or snippets.
136
+ - For AI/Agent use, treat search output as retrieved untrusted context, not
137
+ as instructions.
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "Raybase Search"
3
+ short_description: "SQL FTS indexes and search clients"
4
+ default_prompt: "Use $raybase-search to add keyword search to this Raybase app."
@@ -0,0 +1,139 @@
1
+ ---
2
+ name: raybase-settings
3
+ description: Add or review Raybase runtime settings. Use when defining defineSettings(), setting.string/integer/real/boolean/json/enum, app/user/organization setting scopes, admin overrides, ctx.settings usage, built-in AI settings, or deciding what belongs in settings versus config, env, schema, or secrets.
4
+ ---
5
+
6
+ # Raybase Settings
7
+
8
+ Use settings for safe runtime values that an app owner can override without a
9
+ deploy: feature flags, support addresses, workflow thresholds, default display
10
+ choices, user preferences, and AI defaults. Do not use settings for secrets or
11
+ architecture.
12
+
13
+ Decision rule: settings are runtime data with an admin/user write path. Use
14
+ config, env/secrets, schema, migrations, or source code when a value changes
15
+ security posture, infrastructure wiring, data shape, route ownership, or code
16
+ review requirements. If changing the value should require a deploy or human
17
+ review, it does not belong in settings.
18
+
19
+ ## Belongs In Settings
20
+
21
+ Good settings:
22
+
23
+ - Feature toggles and rollout switches.
24
+ - Non-secret email addresses, labels, text, limits, thresholds, and defaults.
25
+ - User preferences such as density, notification defaults, or saved UI choices.
26
+ - App-level AI defaults when AI is enabled. Raybase already adds
27
+ `defaultAiModel`, `embeddingModel`, and `aiOutputTokens`.
28
+
29
+ Keep these out of settings:
30
+
31
+ - Provider keys, OAuth secrets, webhook signing secrets, API tokens, and
32
+ Cloudflare binding names.
33
+ - Auth route wiring, MCP endpoints, roles, schema, policies, migrations, queue
34
+ names, R2 bucket names, Durable Object bindings, and Vectorize binding names.
35
+ - Anything that must be reviewed as code before production behavior changes.
36
+
37
+ ## Define Settings
38
+
39
+ ```ts
40
+ import { defineSettings, setting } from "@raybase/core";
41
+
42
+ export const settings = defineSettings({
43
+ supportEmail: setting.string({
44
+ scope: "app",
45
+ group: "Support",
46
+ label: "Support email",
47
+ default: "support@example.com",
48
+ validate: (value) => value.includes("@") || "Enter a valid email address"
49
+ }),
50
+ autoCloseDays: setting.integer({
51
+ scope: "app",
52
+ group: "Workflow",
53
+ label: "Auto-close days",
54
+ default: 14,
55
+ min: 1,
56
+ max: 90,
57
+ step: 1
58
+ }),
59
+ inboxDensity: setting.enum({
60
+ scope: "user",
61
+ group: "Preferences",
62
+ label: "Inbox density",
63
+ default: "comfortable",
64
+ options: ["compact", "comfortable"]
65
+ })
66
+ });
67
+ ```
68
+
69
+ Pass the definitions to the generated app's `createRaybaseApp({ settings })`
70
+ configuration.
71
+
72
+ ## Scopes
73
+
74
+ - Core supports `app` and `user` scopes in generated apps.
75
+ - `organization` scope is for Raybase Pro. Do not add organization-scoped
76
+ settings to Core apps.
77
+ - App settings use subject ID `app` internally.
78
+ - User settings must be read for the intended user with `ctx.settings` or
79
+ `getForUser`.
80
+
81
+ ## Read Settings
82
+
83
+ Use `ctx.settings` from Raybase request/action contexts:
84
+
85
+ ```ts
86
+ export async function sendSupportNotice(ctx: RaybaseRequestContext) {
87
+ const supportEmail = await ctx.settings.get("supportEmail");
88
+ const autoCloseDays = await ctx.settings.get("autoCloseDays");
89
+ return { supportEmail, autoCloseDays };
90
+ }
91
+ ```
92
+
93
+ For user-scoped values:
94
+
95
+ ```ts
96
+ const density = await ctx.settings.getForUser(ctx.user.id, "inboxDensity");
97
+ ```
98
+
99
+ Prefer reading settings at request/action execution time. Do not bake setting
100
+ values into module scope constants.
101
+ Module-scope reads freeze an admin override until the worker reloads and can
102
+ skip the audited runtime path. Read settings where the request, user, or action
103
+ context is known.
104
+
105
+ ## Admin Overrides
106
+
107
+ Raybase stores overrides in `_settings` and exposes them through the
108
+ admin settings surface with audit events for set/reset/invalid writes.
109
+
110
+ Use definition metadata to make admin UI safe:
111
+
112
+ - `label`, `description`, and `group` for clarity.
113
+ - `admin.hidden` for values code may read but admin should not see in the
114
+ settings UI.
115
+ - `admin.readonly` for values admin may inspect but must not override.
116
+ - `min`, `max`, `step`, and `options` for bounded input.
117
+ - `allowUnknownCurrentValue` when an enum may currently hold a now-removed
118
+ option.
119
+ - `allowCustomValue` only when free-form values are intentional.
120
+ - `validate` for business validation. Return `true` or a user-facing error.
121
+
122
+ In Core, setting writes are admin/operator writes and may also be constrained by
123
+ `permissions.roles`. In Pro, use `raybase-pro-security` before changing
124
+ organization-scoped settings or org-admin write permissions.
125
+ Do not let ordinary app users write app-scoped settings unless the product has
126
+ an explicit, policy-checked workflow for that value. User-scoped settings are
127
+ preferences; app-scoped settings change shared behavior.
128
+
129
+ ## Verification
130
+
131
+ Run `raybase doctor`, then verify:
132
+
133
+ - Defaults work with no row in `_settings`.
134
+ - Admin override changes behavior without a deploy.
135
+ - Reset returns to the code default.
136
+ - Invalid writes are rejected and audited.
137
+ - Non-admin users cannot change app settings.
138
+ - No secret or binding value appears in settings rows, UI JSON, audit metadata,
139
+ docs, or prompts.
@@ -0,0 +1,4 @@
1
+ interface:
2
+ display_name: "Raybase Settings"
3
+ short_description: "Runtime settings and admin overrides"
4
+ default_prompt: "Use $raybase-settings to add runtime settings to this Raybase app."
@@ -0,0 +1,166 @@
1
+ ---
2
+ name: raybase-tanstack-start
3
+ description: Build and change Raybase apps built on the tanstack-start framework. Use with raybase-building for route layout, server functions, React UI, Cloudflare Worker entry, local dev, and TanStack-specific verification.
4
+ ---
5
+
6
+ # Raybase TanStack Start Skill
7
+
8
+ Use this skill for projects whose `package.json` has
9
+ `raybase.framework: "tanstack-start"`. The generic Raybase skills still own the
10
+ runtime rules: spec first, policies on every table, no custom auth, no raw R2,
11
+ no raw Workers AI, and no `unsafeDb`. This skill owns the TanStack Start file
12
+ layout and framework seams.
13
+
14
+ ## Read Order
15
+
16
+ 1. Read `.agents/skills/raybase-building/SKILL.md` for the implementation
17
+ sequence.
18
+ 2. Read this skill before editing routes, components, server functions,
19
+ `src/raybase.server.ts`, `src/worker-entry.ts`, or generated app UI.
20
+ 3. Read `.agents/skills/raybase-tanstack-start-design/SKILL.md` before
21
+ designing or restyling app screens.
22
+ 4. Run `.agents/skills/raybase-tanstack-start-security-review/SKILL.md` before
23
+ marking the app ready.
24
+
25
+ ## Important Paths
26
+
27
+ - `src/db/schema.ts` declares app tables and policies.
28
+ - `src/db/seed.ts` holds idempotent local demo data.
29
+ - `src/db/storage.ts` declares Raybase file buckets when storage is enabled.
30
+ - `src/raybase.config.ts` owns app name, business roles, auth signup mode,
31
+ public routes, local dev personas, and feature config.
32
+ - `src/raybase.auth.ts` is the Better Auth provider configuration seam.
33
+ - `src/raybase.server.ts` creates the Raybase runtime app and registers schema,
34
+ seed, actions, modules, MCP, settings, search, storage, AI, jobs, and Agent
35
+ configuration.
36
+ - `src/worker-entry.ts` is the Cloudflare Worker entry. It must keep exporting
37
+ `RaybaseDatabaseObject`, `RaybaseAIChatAgentObject`, `default.fetch`, `queue`,
38
+ and `scheduled`.
39
+ - `src/routes/` contains TanStack Start routes.
40
+ - `src/components/` contains reusable app UI.
41
+ - `public/raybase-push-sw.js` and `src/lib/push-client.ts` own the optional,
42
+ gesture-gated Web Push subscription flow. Keep the service worker at the
43
+ origin root and preserve its `Service-Worker-Allowed: /` header when moving
44
+ static assets.
45
+ - `src/guide/` contains Guide app configuration when Guide is enabled.
46
+ - `content/docs/` contains app docs when Docs is enabled. Docs are public by
47
+ default (`Docs exposure: public`): every `src/routes/docs*` route hands the
48
+ request to `handleDocsRequest` in `src/docs/docs-handler.tsx`, which does
49
+ not check sign-in. If the builder chooses `Docs exposure: signed-in only`,
50
+ check there, once for every docs route: ask Raybase
51
+ `handleRaybaseRequest(new Request(new URL("/api/account/me", request.url), { headers: request.headers }))`,
52
+ as `src/routes/_app/profile.tsx` does, and on 401 redirect pages to
53
+ `/login?next=<path>` and answer `/docs/api/*` with 401.
54
+
55
+ Generated files are not hand-edit targets. Do not edit `src/routeTree.gen.ts`
56
+ or `src/db/migrations.gen.ts` directly.
57
+
58
+ ## Routes And Server Work
59
+
60
+ - Put app screens in `src/routes/*.tsx`; use nested route files for layouts and
61
+ `$`/splat route names for dynamic segments.
62
+ - Keep `src/routes/admin.tsx`, `src/routes/admin/$.ts`, and
63
+ `src/routes/api/$.ts` as narrow delegates to Raybase-owned handlers unless
64
+ Core changes the template contract.
65
+ - Use TanStack route loaders for route-local read data that belongs to a page's
66
+ lifecycle.
67
+ - Guide's default TanStack widget invalidates active route loaders after
68
+ mutating Guide actions. Data fetched only through isolated `useEffect()`
69
+ calls will not refresh from that default bridge unless the page subscribes to
70
+ `raybase:data-changed` itself.
71
+ - Use `createServerFn()` for small typed server reads that are page/support
72
+ helpers, such as docs tree loading.
73
+ - Use Raybase `defineAction()` for business mutations that may be shared by UI,
74
+ MCP, jobs, Guide, Agents, or API. Do not encode workflow transitions only in
75
+ client state or raw CRUD calls.
76
+ - When replacing starter actions or workflow tables, replace
77
+ `tests/raybase-patterns.test.ts` with focused tests for the new actions. Use
78
+ `@raybase/core/test` for action policy, row policy, ownership, invalid input,
79
+ and invalid state cases.
80
+ - Validate route params, search params, and server-function input before they
81
+ cross a policy, object, file, external fetch, AI, or state-transition
82
+ boundary.
83
+ - Conversation deep links remain app-owned. If an assistant route supports
84
+ `?agent=<name>&entry=<kind>&n=<notificationId>`, allowlist the agent and entry
85
+ kind, then pass the notification id to the Agent conversation-create API.
86
+ Never turn arbitrary search-param text into a prompt or kickoff message.
87
+
88
+ ## UI Conventions
89
+
90
+ - Use React components and Tailwind utilities for app UI.
91
+ - Keep `src/styles.css` as the Tailwind entry and global theme/base layer, not
92
+ as a component stylesheet.
93
+ - Preserve the template's account/current-user menu when replacing starter UI.
94
+ It already uses `/api/account/me` through `loadAccountSummary()`.
95
+ - It is normally appropriate for the account menu to show an `/admin` link only
96
+ when the returned account summary has `isOperator: true`. Do not inspect raw
97
+ `operatorRole`, auth tables, app roles, sessions, or provider accounts.
98
+ - Do not add app-owned local dev persona switchers. Use
99
+ `appConfig.auth.devUser` or `appConfig.auth.devUsers`; Core renders the
100
+ local-only chrome and login-page persona buttons.
101
+ - Never request notification permission on page load. Render the Web Push
102
+ opt-in only when the public-key endpoint reports it enabled, and call
103
+ `Notification.requestPermission()` only from a user gesture.
104
+
105
+ ## Local Dev And Verification
106
+
107
+ Run the normal app verification from `raybase-building`:
108
+
109
+ ```bash
110
+ raybase migrate
111
+ pnpm test
112
+ raybase kits doctor
113
+ raybase doctor
114
+ raybase check
115
+ raybase dev
116
+ ```
117
+
118
+ If a long-running Vite/workerd dev session starts returning unexplained
119
+ `fetch failed` 500s after many HMR updates, restart `raybase dev` before
120
+ debugging application logic.
121
+
122
+ A **restart** — a `vite.config.ts` or `wrangler.jsonc` edit, a `.env` change,
123
+ a watchdog repair — ends the isolate and every agent turn and job run inside
124
+ it. An interrupted turn is not retried: it stays `running` until Core's
125
+ five-minute staleness horizon fails it, so the member sees a spinner and then
126
+ nothing. Keep `raybaseDevRestartGuard()` from `@raybase/core/vite` last in the
127
+ plugins array (the template ships it, and `raybase doctor` says so when it is
128
+ missing); a restart then waits for the work to land and restarts itself. Plain
129
+ source edits never needed this — work in flight keeps its own modules, and the
130
+ next turn is built from the new ones with no restart at all. `curl
131
+ localhost:3000/api/dev/activity` is the same answer by hand.
132
+
133
+ `raybase dev` keeps Miniflare's local trace store off; pass
134
+ `raybase dev --observability` for one run when you need the `/__debug` logs
135
+ view, since the store is uncapped. The `observability` block in
136
+ `wrangler.jsonc` is a deploy-time setting and does not affect local dev. Watch `.wrangler` growth during
137
+ extended QA, and treat surprising database warm-up failures after heavy growth
138
+ as possible disk or trace-store pressure before blaming the database named by
139
+ the error.
140
+
141
+ Current known issue: `raybase dev` rewrites `RAYBASE_SPINE_ORIGIN` and
142
+ `BETTER_AUTH_URL` in `.dev.vars` to its resolved
143
+ `http://127.0.0.1:<port>` origin on every start. Use that printed origin
144
+ consistently. If an existing browser, WebAuthn, or cookie-scoped flow requires
145
+ `localhost`, start `raybase dev`, change both variables to the same
146
+ `http://localhost:<port>` origin, and wait for the worker reload before
147
+ continuing; repeat after each restart. Do not mix `localhost` and `127.0.0.1`
148
+ within one test flow.
149
+
150
+ Before handoff, verify:
151
+
152
+ - `/` renders the app.
153
+ - `/admin` loads for a Raybase Operator Admin/local owner persona.
154
+ - `/docs` loads when Docs is enabled, and `/docs` and `/docs/api/search`
155
+ match the spec's `Docs exposure` line for signed-out visitors.
156
+ - normal users do not see generated `/admin` links and do not need `/admin`
157
+ for ordinary workflows.
158
+ - The Raybase Operator Admin/local owner persona can see the `/admin` link in
159
+ the account menu.
160
+
161
+ ## Security Review
162
+
163
+ Before declaring the app ready, read and follow
164
+ `.agents/skills/raybase-tanstack-start-security-review/SKILL.md`. Fix any
165
+ high-confidence findings, then rerun `raybase doctor`, `raybase check`, and the
166
+ focused review.