@raybase/create 0.0.2 → 0.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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 +2353 -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,242 @@
1
+ # Migration Inventory And Conversion Reference
2
+
3
+ Use this reference with the migration skill. Keep `SKILL.md` focused on
4
+ sequence; put working tables, mappings, and migration notes here.
5
+
6
+ ## `dev/migration/inventory.md` Template
7
+
8
+ Create this file in the generated app before content modeling starts:
9
+
10
+ ```md
11
+ # Migration Inventory
12
+
13
+ Source site: <https://example.com/>
14
+ Inventory date: YYYY-MM-DD
15
+ Migration stance: redesign | faithful reproduction approved by owner
16
+ Owner URL preference: preserve slugs | preserve where practical | rename
17
+
18
+ ## Discovery Notes
19
+
20
+ - Public discovery surfaces checked:
21
+ - Browser tooling used:
22
+ - Limitations:
23
+
24
+ ## Page Inventory
25
+
26
+ | Old URL | Title | Purpose | Content summary | Media slots | Recommendation | New URL |
27
+ | --- | --- | --- | --- | ---: | --- | --- |
28
+ | / | Home | Primary landing page | ... | 3 | keep | / |
29
+
30
+ ## Repeated Content Types
31
+
32
+ | Type | Count observed | Source URLs | Proposed EmDash collection | Public detail URL pattern | Notes |
33
+ | --- | ---: | --- | --- | --- | --- |
34
+ | Articles | 12 | /blog/... | articles | /articles/{slug} | Long-form Portable Text |
35
+
36
+ ## Media Inventory
37
+
38
+ | Slot | Used by | Current source URL | Highest-resolution URL | Destination | Alt text | Status |
39
+ | --- | --- | --- | --- | --- | --- | --- |
40
+ | Home hero | / | https://... | https://... | pages.home design data | Needs authored alt | old-site media |
41
+
42
+ Status values:
43
+
44
+ - `old-site media`: real media migrated from the source site.
45
+ - `owner-supplied`: new owner asset supplied outside the old site.
46
+ - `stock stand-in`: new stand-in, named in the handoff.
47
+ - `none`: no image should fill this slot.
48
+ - `blocked`: source inaccessible; record the limitation.
49
+
50
+ ## Navigation And Footer
51
+
52
+ Primary nav:
53
+
54
+ - Top-level count:
55
+ - Depth: flat | dropdown | mega
56
+ - CTA:
57
+ - Items:
58
+
59
+ Footer:
60
+
61
+ - Link count:
62
+ - Column groups:
63
+ - Items:
64
+
65
+ ## Old To New URL Map
66
+
67
+ | Old URL | Action | New URL | Redirect needed | Notes |
68
+ | --- | --- | --- | --- | --- |
69
+ | /about-us | keep | /about-us | no | Preserved slug |
70
+
71
+ Actions: `keep`, `merge`, `drop`, `rename`.
72
+
73
+ ## Content Conversion Notes
74
+
75
+ - Copy preserved as-is:
76
+ - Copy improvements proposed separately:
77
+ - Collections needing search:
78
+ - Pages or entries needing owner review:
79
+
80
+ ## Verification Checklist
81
+
82
+ - [ ] Every kept page resolves at its new URL.
83
+ - [ ] Collection counts match the observed counts or differences are recorded.
84
+ - [ ] First-request logs have no unresolved `$media` failures.
85
+ - [ ] No stock stand-in replaced usable old-site media without owner approval.
86
+ - [ ] Old to new URL map is honored.
87
+ - [ ] Search returns migrated entries when search is enabled.
88
+ ```
89
+
90
+ ## Browser-Only Discovery
91
+
92
+ Allowed discovery surfaces are public web surfaces you can inspect through the
93
+ browser or fetch tooling: rendered pages, nav/footer links, search pages, public
94
+ RSS/Atom feeds, public JSON that the rendered app requests, and `/sitemap.xml`
95
+ when it exists. Treat the live rendered navigation as the IA ground truth when
96
+ it disagrees with an automated list.
97
+
98
+ Do not use platform-specific migration paths: no WordPress WXR/XML exports,
99
+ Squarespace exports, Webflow exports, CMS admin APIs, database dumps, private
100
+ admin sessions, or owner credentials. If the owner offers an export anyway,
101
+ record that this skill does not depend on it and continue from the public
102
+ browser inventory unless the project gets a separate owner-approved migration
103
+ implementation plan.
104
+
105
+ For JavaScript-rendered sites, wait for hydration, inspect the rendered DOM,
106
+ and use network entries for data/media URLs when the visible page depends on
107
+ client-side JSON. Do not conclude "no content" from an app-shell HTML response.
108
+
109
+ ## HTML To Portable Text Mapping
110
+
111
+ Use this mapping for long-form content that belongs in a page-backing
112
+ collection's `content` field.
113
+
114
+ | Source HTML | Portable Text shape | Notes |
115
+ | --- | --- | --- |
116
+ | `h1`-`h6` | block with `style: "h1"` through `"h6"` | Preserve hierarchy where it is meaningful; avoid multiple `h1`s inside article bodies unless the source genuinely has them. |
117
+ | `p` | block with `style: "normal"` | Preserve inline links and marks. Drop empty spacer paragraphs. |
118
+ | `strong`, `b` | span mark `strong` | Use marks on spans, not nested block hacks. |
119
+ | `em`, `i` | span mark `em` | Preserve only meaningful emphasis. |
120
+ | `a[href]` | span with link markDef | Keep absolute external URLs; normalize internal links through the URL map. |
121
+ | `blockquote` | block with `style: "blockquote"` | Preserve quote text; model citation separately only when the collection needs it. |
122
+ | `ul`, `ol`, `li` | list blocks with `listItem` and `level` | Preserve order and nesting where supported by the renderer. |
123
+ | `img` in article body | image field, Galley block, or referenced media near the relevant text | Prefer collection image fields for featured images; avoid stuffing raw HTML into Portable Text. |
124
+ | `figure` / `figcaption` | media plus caption field or nearby caption text | Keep captions when they carry meaning or attribution. |
125
+ | `table` | bespoke data modeling or simplified prose | Portable Text table support is not assumed. If the table is important, model it deliberately. |
126
+ | `iframe`, embeds, scripts | Deviation or replacement section | Do not copy arbitrary embeds. Rebuild only approved embeds in starter-native code/templates. |
127
+ | Builder wrappers / layout divs | no output | Drop wrappers, spacer divs, animation classes, and inline style debris. |
128
+
129
+ Every block and child span needs a stable `_key`. A readable pattern is
130
+ `<slug>-<section>-<index>` for blocks and
131
+ `<slug>-<section>-<index>-span-<n>` for children. Keep keys stable across
132
+ manual edits so Galley and EmDash edit context do not churn.
133
+
134
+ Example:
135
+
136
+ ```json
137
+ {
138
+ "_type": "block",
139
+ "_key": "field-guide-intro-01",
140
+ "style": "normal",
141
+ "markDefs": [
142
+ { "_key": "field-guide-link-01", "_type": "link", "href": "https://example.com/source" }
143
+ ],
144
+ "children": [
145
+ {
146
+ "_type": "span",
147
+ "_key": "field-guide-intro-01-span-01",
148
+ "text": "Opening paragraph with a link.",
149
+ "marks": ["field-guide-link-01"]
150
+ }
151
+ ]
152
+ }
153
+ ```
154
+
155
+ ## Marketing Page Conversion
156
+
157
+ Marketing pages usually should not become one huge Portable Text blob. Convert
158
+ them into the chosen theme's page starter and Galley section vocabulary:
159
+
160
+ - Hero copy becomes page-starter data or the first hero section's Galley data.
161
+ - Feature bands become theme sections, collection-bound sections, or bespoke
162
+ Galley templates only when the theme lacks the needed pattern.
163
+ - Testimonials, team members, projects, books, products, services, and FAQs
164
+ usually become section-data collections when editors will maintain them.
165
+ - Calls to action become the shell/page sections' CTA fields and must point at
166
+ the new URL map.
167
+ - Keep old page order only when it serves the new design direction. Redesign
168
+ can improve rhythm; it cannot drop owner-approved content silently.
169
+
170
+ ## Media Harvest Notes
171
+
172
+ Record the media URL the page actually renders and the highest-resolution URL
173
+ you verified. For responsive images, inspect `srcset`, `<picture>` sources,
174
+ CSS background images, and network requests. Prefer the largest useful asset,
175
+ then resize locally before upload when performance requires it.
176
+
177
+ When stripping CDN resizing parameters, verify the stripped URL returns the
178
+ same intended asset. Some hosts require signed query params or transform path
179
+ segments; if the original cannot be fetched cleanly, keep the served URL or
180
+ download locally and upload through EmDash.
181
+
182
+ Fresh seed image example:
183
+
184
+ ```json
185
+ {
186
+ "featured_image": {
187
+ "$media": {
188
+ "url": "https://source-site.example/cdn/book-cover.jpg",
189
+ "alt": "Paperback cover of The Field Guide on a blue table",
190
+ "filename": "field-guide-cover.jpg"
191
+ }
192
+ }
193
+ }
194
+ ```
195
+
196
+ Live upload command:
197
+
198
+ ```bash
199
+ pnpm --dir site exec emdash media upload ./field-guide-cover.jpg --alt "Paperback cover of The Field Guide on a blue table" --json
200
+ ```
201
+
202
+ The upload response includes a relative
203
+ `/_emdash/api/media/file/{storageKey}` URL. For Galley URL fields, use the
204
+ site-origin-qualified URL. For collection `image` fields, store the media
205
+ object/id shape that EmDash returns or that the admin writes. In pinned EmDash
206
+ 0.23, direct CLI upload accepts `--alt`/`--caption` but may not persist them;
207
+ after upload, verify alt text in the admin or stored entry and correct it if
208
+ needed.
209
+
210
+ Keep the original external source URL in migration seeds. Do not rely on
211
+ `emdash export-seed --with-content` to reproduce remote media URLs, because
212
+ round-tripped media can point at site-local storage instead. EmDash direct
213
+ uploads reject oversized files above the starter's current route limit, observed
214
+ as `413` around 50 MB; downscale locally before upload.
215
+
216
+ For built Cloudflare/Wrangler local previews, seed `$media` can populate D1
217
+ media rows and `site/uploads` while Miniflare R2 remains empty. Always fetch
218
+ the rendered `/_emdash/api/media/file/{storageKey}` URLs. If they 404 locally,
219
+ hydrate R2 from the upload directory or upload through the API before marking
220
+ the media checklist complete.
221
+
222
+ ## Redirects
223
+
224
+ The Astro/EmDash template does not ship a redirect-map facility. The preferred
225
+ migration tactic is preserving slugs with page slugs and collection
226
+ `urlPattern`s. When the owner accepts renamed or dropped URLs, record them in
227
+ the URL map and in the handoff.
228
+
229
+ If redirects are required for launch, implement a small explicit map in
230
+ `site/src/middleware.ts`, record it as a Deviation, and browser-verify each
231
+ old URL. Keep redirect behavior narrow: static old paths to safe relative new
232
+ paths, no user-controlled destination parameter.
233
+
234
+ ## Handoff Sentence For Old-Site Imagery
235
+
236
+ Use this exact idea once, plainly:
237
+
238
+ > Imagery from the old site was republished as-is; confirm you hold the rights
239
+ > before publish.
240
+
241
+ Do not turn this into a rights audit. The agent's migration task is content
242
+ parity and technical verification; licensing remains the owner's call.
@@ -0,0 +1,68 @@
1
+ ---
2
+ name: raybase-astro-emdash-security-review
3
+ description: Security review checklist for astro-emdash apps covering handoff token signing, JWKS, EmDash auth, cookies, Server Island proxying, staged Template publishing and activation, behavior sidecars, the dev-session content door, and deployment secrets.
4
+ ---
5
+
6
+ # Raybase Astro/EmDash Security Review
7
+
8
+ Run this before handoff or deploy review for an `astro-emdash` app.
9
+
10
+ ## Handoff Tokens
11
+
12
+ - `RAYBASE_HANDOFF_PRIVATE_JWK` is an ES256 private JWK and is stored as a secret in production.
13
+ - `/.well-known/jwks.json` returns only public JWK fields and does not expose `d`.
14
+ - `/api/handoff/authorize` and `/api/handoff/token` both require a signed-in Raybase session.
15
+ - Token TTL is short, normally five minutes and never more than fifteen minutes.
16
+ - Token claims include issuer, audience, subject, app id, resource, kind, roles, expiry, and a unique id.
17
+ - Audit records `handoff.issued` metadata but never the raw token.
18
+ - A session on the far side expires rather than being revoked; the review records that lag rather than assuming instant offboarding.
19
+
20
+ ## Consume Route And Gate
21
+
22
+ - `site/src/pages/_raybase/handoff/consume.ts` mounts `consumeHandoff`, which verifies the signature, issuer, audience, and resource.
23
+ - The return URL accepts only safe relative paths.
24
+ - The handoff cookie is HttpOnly, SameSite=Lax, Secure, scoped to `/`, and expires with the token.
25
+ - `site/src/middleware.ts` mounts `requireHandoff` on `/_emdash/admin*`; a CMS reachable without it is the finding.
26
+ - The bounce is state-bound: the gate sets a `raybase_handoff_state` nonce cookie, consume requires it to match the `state` in the URL and clears it, so a consume URL is useless in another browser.
27
+ - The issuer list pins `kinds: ["sso"]` for the spine, in `site/astro.config.mjs` and in the content door's consumer config; a CMS that accepts pass kinds is the finding.
28
+ - Return paths go through the shared sanitiser: control characters are refused, not just CR/LF, because the URL parser strips TAB/CR/LF and turns them into an open redirect.
29
+ - Error responses use `cache-control: no-store` and do not leak token contents.
30
+
31
+ ## Server Island Proxy
32
+
33
+ - `allowedActions` is a fixed set.
34
+ - The proxy builds the Raybase action URL from trusted configuration and `encodeURIComponent(action)`.
35
+ - The proxy does not accept arbitrary URLs, methods, headers, or credentials from public input.
36
+ - Public Raybase actions declare `audience: "public"` and an explicit policy.
37
+
38
+ ## Site Assembly And Templates
39
+
40
+ - Staged registry content under `site/seed/templates/**` (Liquid, sample
41
+ data, page seeds, and any behavior sidecars) has been reviewed before
42
+ `pnpm --dir site run templates:apply` publishes it. Apply flips drafts to
43
+ published, and a `shell add --activate` work order also swaps the active
44
+ public shell (layout pointer and palette).
45
+ - Template provenance comes from the intended registry: `.raybase/templates.json`
46
+ and per-template `provenance.json` integrity hashes match what was staged;
47
+ no unreviewed edits rode along.
48
+ - Behavior sidecars ship JavaScript that runs on the public site under the
49
+ current permissive CSP. Review sidecar sources like app code before
50
+ publish; do not publish third-party behavior you have not read.
51
+ - The dev-session content door (`POST /_raybase/dev/session` in
52
+ `site/src/middleware.ts`) is local-dev-only. Verify it is inert or absent
53
+ in production builds and that the public site exposes no persona-switching
54
+ surface in production.
55
+ - When docs placement is `site`, the public docs and `llms.txt` surfaces
56
+ expose only content intended to be public.
57
+ - The Browser Verification recipe in
58
+ `.agents/skills/raybase-astro-emdash/SKILL.md` has been run: the signed-in
59
+ handoff, composed public shell, and Galley publish states were verified in
60
+ a real browser before sign-off.
61
+
62
+ ## Deployment
63
+
64
+ - `raybase doctor` passes.
65
+ - Production site origin in `src/raybase.config.ts` is not a localhost placeholder.
66
+ - EmDash D1 and R2 bindings exist and point at the intended account resources.
67
+ - `site/wrangler.jsonc` does not contain secrets.
68
+ - Cross-origin fetches and redirects are limited to the configured spine and site origins.
@@ -0,0 +1,216 @@
1
+ ---
2
+ name: raybase-astro-emdash-theme-selection
3
+ description: Assemble a Raybase site in two explicit steps — a theme (voice + vocabulary — palettes, sections, page starters) then a shell (the layout with its welded nav + footer, chosen by capacity), plus page seeds, activation, and verification.
4
+ ---
5
+
6
+ # Raybase Astro/EmDash Theme Selection Skill
7
+
8
+ Use this skill when a generated `astro-emdash` app needs a public site assembled from the Raybase Templates registry rather than bespoke Astro sections.
9
+
10
+ A site is assembled from two artifacts, chosen in order:
11
+
12
+ 1. **Theme** — voice and vocabulary: palettes, sections, page starters, guidance. Chosen on tone/density/scheme/starter coverage.
13
+ 2. **Shell** — the IA's frame: a layout with its nav and footer welded into its Liquid, selected by **capacity** (does the nav hold your top-level links? does the footer make your IA findable?) then ranked by voice-fit with the theme.
14
+
15
+ The theme owns how the site *sounds and looks*; the shell owns how the IA is *framed*. They are separate registry artifacts and separate commands.
16
+
17
+ ## Read Order
18
+
19
+ 1. Read `.agents/skills/raybase-astro-emdash/SKILL.md`.
20
+ 2. Read `.agents/skills/raybase-astro-emdash-galley/SKILL.md`.
21
+ 3. Read `dev/SPEC.md`, `dev/SPEC-OVERVIEW.md`, `dev/CODEBASE-MAP.md`, and any current page/content notes.
22
+ 4. Inspect the app's EmDash collections, existing pages (`design` and `content` fields), and any staged Template lock files before choosing.
23
+
24
+ ## Selection Loop
25
+
26
+ Inputs: before searching, have the approved page inventory, **named menu plan
27
+ with nav/footer counts and depth**, content-type list, and binding plan
28
+ from the `Site plan` section of `dev/SPEC.md` in hand - produced by
29
+ `.agents/skills/raybase-astro-emdash-content-model/SKILL.md` - plus the
30
+ design direction recorded in `DESIGN.md` by
31
+ `.agents/skills/raybase-astro-emdash-design/SKILL.md`. Selection consumes a
32
+ site plan and a design direction; it does not invent them.
33
+
34
+ ### Step 1 — Theme (voice + vocabulary)
35
+
36
+ - Compile the direction into a **faceted match**, don't liquify it into a vibe:
37
+ `raybase templates match "<audience tone page needs>" --tone "<voice words>" --density <low|medium|high> --scheme <light|dark> --pages <role,keys> [--anti "<anti-reference>"] --json`.
38
+ `match` pulls a semantic candidate pool then scores each theme **per facet** — tone overlap, density distance, scheme support, starter coverage, section vocabulary, and its best shell match — and returns a **tradeoff matrix**, not a bare rank ("vela — tone ✓, density ✗ airy, covers 6/7 pages, best shell vela-site-layout 0.8"). The anti-reference from `DESIGN.md` enters as a negative constraint. Read the matrix and choose with the tradeoffs named.
39
+ - Use registry-supported page roles in `--pages`, not domain nouns you wish
40
+ existed. For example, a publisher with book detail routes may still match on
41
+ `onePage`, `article`, `blog`, `visual`, or other roles that `templates info`
42
+ exposes; do not invent roles like `bookDetail` unless the registry entry
43
+ actually declares them.
44
+ - Inspect the finalists with `raybase templates info <theme-id>` for the palette metadata, required bindings, and the "Shells — best fits" list. Optionally corroborate the look with `raybase templates search "<query>" --kind theme --has-screenshots --json` (theme entries carry captures derived from their page-starter members).
45
+ - Choose explicitly. Do not let hidden heuristics pick the theme, palette, or page starters. `--palette` is **required when the theme lists more than one palette** — an ambiguous palette errors (colors get the same explicit-choice rule as layouts). Record the chosen theme, palette, and rationale in the site section of `DESIGN.md`.
46
+ - Prefer one coherent theme over mixing families for voice. Add individual sections only when the theme lacks a needed band.
47
+ - Map collection bindings with model judgement from the app schema and user goals. Do not string-scan field names as the binding engine.
48
+
49
+ ### Step 2 — Shell (the IA's frame, chosen by capacity)
50
+
51
+ The nav is the IA's priorities; the footer is the IA's completeness. Both are born from the site plan's named menus — so the shell is the first choice in the system that is **mechanically verifiable**.
52
+
53
+ - Turn the site plan's menu shapes into a capacity query and rank shells:
54
+ `raybase templates shell match --nav-items <N> --nav-depth flat|dropdown|mega --footer-links <N> --footer-columns <N> [--cta] --theme <theme-id> --json`.
55
+ `shell match` hard-filters on capacity (a shell that can't hold your nav is excluded) then ranks the survivors by voice-compat with the theme (density, type, family prior). The output is dimensional — "matches density + type; clashes on motion" — never a bare rank.
56
+ - Count `primary` top-level items for `--nav-items`; choose
57
+ `--nav-depth flat|dropdown|mega` from the `primary` menu hierarchy; count
58
+ all footer child links for `--footer-links`; count top-level `footer` items
59
+ as columns for `--footer-columns`. Social and legal menus do not inflate the
60
+ main footer column count unless the chosen shell renders them inside the
61
+ same footer grid.
62
+ - The shell need **not** be the theme's family: "same family" is a ranking prior, not a boundary. Pick the shell whose capacity fits and whose voice reads closest to the direction.
63
+ - Install and activate the chosen shell with `raybase templates shell add <layout-id> --activate --palette <name>`. The nav and footer install automatically via the requires-graph (they are welded to the layout) and should use the standard menu names (`primary`, `footer`, `social`, `legal`) by default. `--activate` is the go-live step: it stages the activation intent and publishes the theme's staged page drafts.
64
+ - If you install or adapt an individual menu-bound template outside the shell
65
+ graph, bind its menu source explicitly with `--bind alias=menu:<name>` on
66
+ `raybase templates add`. `raybase templates theme add` accepts the same
67
+ syntax for selected theme members. Rebinding a menu alias to a collection is
68
+ an error; use collection binds only for collection dataSources.
69
+ - Record the chosen shell in `DESIGN.md` (id + one line of capacity rationale: "duskwire-wide — 6 top-level links, sitemap footer for the deep resources IA").
70
+
71
+ ## Golden Command Shape
72
+
73
+ Run from the generated app root with the Astro/EmDash site available for apply:
74
+
75
+ ```bash
76
+ # 1. Theme — voice + vocabulary (faceted match, then inspect the finalist)
77
+ raybase templates match "studio services portfolio" --tone "polished direct crafted" --density medium --scheme light --pages onePage,resources --json
78
+ raybase templates info raybase/lumen-studio
79
+ raybase templates theme add raybase/lumen-studio \
80
+ --palette sage \
81
+ --page /=onePage \
82
+ --page /resources=resources \
83
+ --include-sections \
84
+ --stage-only
85
+
86
+ # 2. Shell — capacity match, then activate
87
+ raybase templates shell match --nav-items 5 --nav-depth flat --footer-links 12 --footer-columns 3 --cta --theme raybase/lumen-studio --json
88
+ raybase templates shell add lumen-site-layout --activate --stage-only
89
+
90
+ # 3. Apply + verify
91
+ pnpm --dir site run templates:apply
92
+ raybase templates doctor
93
+ ```
94
+
95
+ `shell add` defaults `--palette` to the theme's selected palette (from the lock), so you usually omit it after `theme add`. Pass `--palette <name>` to override. Use `--registry <path-or-url>` for local registry development, and `--require-remote` on search to prove the hosted semantic registry rather than accepting offline fallback.
96
+
97
+ For a non-standard menu name on a standalone nav/footer template, use the same
98
+ binding vocabulary as collection sources with the `menu:` prefix:
99
+
100
+ ```bash
101
+ raybase templates add raybase/example-nav --bind links=menu:primary --stage-only
102
+ raybase templates add raybase/example-footer --bind footerLinks=menu:footer --stage-only
103
+ ```
104
+
105
+ If no shell satisfies the capacity, `shell match` says so: loosen the nav/footer requirements, split a nav into a dropdown, or (rarely) borrow a higher-capacity shell from another family — the shell is globally selectable.
106
+
107
+ **One-page sites** are a popular shape and adjust both steps:
108
+
109
+ - Step 1: the family's one-page starter *is* the product — read its composition before anything else; `--pages onePage` puts starter coverage in the match matrix.
110
+ - Step 2: query `shell match --anchor --nav-items <promoted-anchor-count>` — often `--nav-items 0`. A brand-bar shell (`navItems.min` 0) still renders the logo/header block and CTA with zero links; one-page sites usually want that brand block even without a nav. Expect `footerGrade` micro — the footer still carries contact and legal. One page ≠ one route: stage prose pages for `/privacy`/`/terms` alongside `--page /=onePage`.
111
+ - Anchor targets are the starter's job, not the shell's — follow the galley skill's one-page anchor convention before editing the starter's `{% render %}` composition.
112
+
113
+ **Palette is a design decision, not a menu pick.** Arbitrate between two
114
+ candidates and record which won and why:
115
+
116
+ 1. **The brand's compiled palette.** Compile the direction's color-strategy line
117
+ into a candidate: `raybase palettes compile --strategy <restrained|committed|full|drenched> --hue <deg|name> --scheme <light|dark|both>`.
118
+ It emits an OKLCH shadcn-semantic-v1 palette with provenance and self-gates
119
+ on WCAG AA.
120
+ 2. **The theme's signature palettes** — the family's own opinion, listed on its
121
+ registry entry (`raybase templates info`).
122
+
123
+ Choose one, then **gate it**: after `theme add`, run `raybase palettes check`
124
+ (WCAG contrast over every token pair, APCA advisory; also run inside `raybase
125
+ doctor`). "Verify with a checker, not your eyes" is now tooling — treat a
126
+ contrast failure as a defect, not a suggestion.
127
+
128
+ `--palette` is **required whenever the theme lists more than one palette**:
129
+ colors get the same explicit-choice rule as layouts, so an ambiguous palette
130
+ errors (`has multiple palettes. Choose one with --palette …`) instead of
131
+ silently falling back to the theme's `defaultPalette`. Single-palette themes
132
+ still resolve without the flag. It accepts the keys the theme's registry entry
133
+ lists under `palettes` (shown by `raybase templates info`). Inspect the
134
+ per-palette metadata there before choosing: `standard` palettes are shared
135
+ registry artifacts, `signature` palettes belong to one theme family, a
136
+ `colorScheme` of `dark` or `light` marks a single-scheme palette that
137
+ renders that scheme unconditionally (never add a light/dark mode toggle
138
+ while one is active — gate any toggle on the generated `PALETTE_SCHEMES`
139
+ map in `site/src/lib/palettes.gen.ts`), and font
140
+ declarations determine the generated Fontsource imports and `site/package.json`
141
+ dependency updates.
142
+
143
+ If you do not run `shell add --activate` (no shell fits, or you are only
144
+ staging drafts for review), the site keeps the starter's static
145
+ `SiteLayout.astro` shell: the theme's sections and page starters stay staged as
146
+ drafts and render inside the static layout. Activation is a shell concern —
147
+ there is nothing to activate without a chosen shell.
148
+
149
+ ## Assembly Rules
150
+
151
+ - Staged templates live in `site/seed/templates/<template-id>/template.json`; staged page seeds live in `site/seed/pages/<slug>.json`; activation intent is an ephemeral `site/seed/templates/<layout-id>/activation.json` work order written by `shell add --activate`.
152
+ - `raybase templates theme add` writes `site/src/styles/palettes.gen.css`, `site/src/styles/palette-fonts.gen.css`, `site/src/lib/palettes.gen.ts`, and any needed Fontsource package entries in `site/package.json`; keep those generated artifacts with the staged templates. It stages sections and page seeds as **drafts** (`publish: false`) and never activates structure.
153
+ - If theme installation changes `site/package.json` (usually Fontsource
154
+ packages), run `pnpm install` before `site` check/build/dev. If pnpm warns
155
+ that native package build scripts were ignored and a CLI command later fails
156
+ to load a native binding, rebuild that dependency before treating the app as
157
+ broken.
158
+ - `raybase templates shell add <layout-id> --activate` installs the layout with its welded nav + footer (via the requires-graph), writes the activation intent, and flips the theme's staged page seeds to `publish: true`. On `templates:apply` this consumes (and deletes) the work order, publishes the selected templates + pages, and sets the active Galley layout pointer and palette. Without `--activate`, the shell is staged as drafts for review. The chosen shell is recorded in `.raybase/templates.json` under `shell`, beside `theme`.
159
+ - To re-activate after `templates:apply` has consumed the work order (for example after editing staged defaults), run `raybase templates shell activate` — it rewrites only `activation.json` and the page-seed publish flips. Never re-run `shell add --overwrite` just to re-stage activation: `--overwrite` re-fetches the layout and its welded nav/footer from the registry and resets any locally edited partials.
160
+ - Swapping a nav or footer *within* a shell has no CLI flag by design: install the replacement with `raybase templates add <nav-or-footer-id>`, hand-edit the layout's `{% render %}` lines, and record a Deviation. See the galley skill's shell-swap recipe.
161
+ - Page starters are real Liquid surface templates that compose the family's sections with `{% render "section-id" %}` (bare ids; resolution goes through the app's installed templates, never per-reference version pins). Staged page seeds are v2 design pointers — `{"schemaVersion": 2, "slug", "title", "publish", "design": {"templateId", "templateVersion", "data", "richText"}}` — not Portable Text block graphs.
162
+ - Adapt a starter before apply by editing its staged `template.liquid`: add, remove, or reorder `{% render %}` lines and pass app-specific data down through render arguments.
163
+ - Preserve `provenance.json`, `.raybase/templates.json`, and the generated theme files; update/fork flows and doctor checks depend on those hashes and artifact paths to avoid overwriting local adaptations.
164
+
165
+ ## Adaptation
166
+
167
+ Work homepage-first:
168
+
169
+ 1. Stage with `--stage-only`, then review the staged homepage starter's `{% render %}` composition before running `templates:apply`.
170
+ 2. Replace registry sample copy with app-specific copy in the staged files -
171
+ cheaper than editing after publish. Inspect the staged shell nav/footer too:
172
+ menu-bound templates keep local `links` defaults that seed missing menus on
173
+ `templates:apply`; make those defaults match the actual IA before apply.
174
+ Keep `_key`s stable and leave `provenance.json` untouched.
175
+ 3. Apply, place, and browser-check the homepage, then walk the secondary pages the same way.
176
+ 4. Only then consider bespoke template edits (fields, `dataSources`) per the galley skill's authoring rules.
177
+
178
+ - Edit staged Liquid, sample content, or page seeds when the registry baseline needs app-specific language, fields, or collection mapping. For page structure, edit the starter's `{% render %}` composition rather than the page seed; the seed only points at the starter through its `design` field.
179
+ - Prefer Galley templates for ordinary marketing and editorial sections. Use Astro components only for route shells, metadata, custom data fetching, Raybase Server Islands, and non-content behavior.
180
+ - When a selected template declares `galley.dataSources`, validate each
181
+ `--bind alias=collection` against the real EmDash schema when possible, and
182
+ each `--bind alias=menu:<name>` against the planned menu name/shape. After
183
+ apply, keep the planned menus reflected in `site/seed/seed.json`: the current
184
+ `raybase doctor`/`raybase templates doctor` capacity check reads those seeded
185
+ `primary`/`footer` menus for the active shell, warning when `primary`'s
186
+ top-level item count falls outside the shell's nav capacity or when `footer`
187
+ has too many top-level columns.
188
+ - When the site plan has a posts-like collection (blog, journal, news), select
189
+ the theme's **article starter** (`choices.pageStarters.article`) alongside
190
+ the blog index — an index with no detail page is half a blog. Article
191
+ starters are entry-hosted: install with `raybase templates add <starter-id>
192
+ --bind <contextKey>=<collection>` when the app's collection is not the
193
+ registry convention, and `templates:apply` gives the collection a design
194
+ field defaulting every entry to the starter. See the galley skill's
195
+ "Entry-Hosted Detail Pages".
196
+
197
+ ## Verification
198
+
199
+ - Run `pnpm --dir site run templates:apply` with the site dev server running.
200
+ - `templates:apply` uses the local setup dev-bypass route. If the scaffold is
201
+ running under Raybase auth or a production-mode Wrangler preview where that
202
+ route is blocked, use a real signed-in/admin apply path for the app or record
203
+ the local-only limitation in the migration/design notes instead of assuming
204
+ the staged templates were applied.
205
+ - Run `raybase palettes check` (WCAG contrast gate over the generated palette CSS), `raybase templates doctor`, `raybase doctor`, and `raybase check`.
206
+ - Run the Browser Verification recipe in `.agents/skills/raybase-astro-emdash/SKILL.md`: `/` and each staged secondary page must render the selected header, footer, layout, generated palette, generated font imports, any active Galley `paletteCss` overlay, and page content publicly.
207
+ - Public pages should render published templates only; if active layout rendering fails, fix the staged templates or re-run activation rather than relying on the static fallback.
208
+ - After installing an article starter, open one collection entry's public URL
209
+ and confirm the detail page renders from the entry (title, image, rails)
210
+ and that Edit mode lights up its context markers (hub skill's editability
211
+ gate).
212
+ - If `astro dev` trips Cloudflare/Vite dependency optimizer issues, verify the
213
+ built Worker with `astro build` plus `wrangler dev --config
214
+ dist/server/wrangler.json`. Seed and inspect the exact D1 state path used by
215
+ that Wrangler process, and remember that `dist/server/.wrangler` is removed
216
+ by rebuilds unless you intentionally preserve or recreate it.