@raybase/create 0.0.2 → 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,265 @@
1
+ ---
2
+ name: raybase-astro-emdash-galley
3
+ description: Build runtime-editable public Astro/EmDash page sections with Galley templates, Portable Text Galley blocks, shared blocks, and designed fields in raybase astro-emdash apps.
4
+ ---
5
+
6
+ # Raybase Astro/EmDash Galley Skill
7
+
8
+ Use this skill when changing public content sections in an `astro-emdash` app.
9
+ Galley is the default page-section authoring layer: templates live in EmDash
10
+ plugin storage, instances live in EmDash content fields, and the Astro route
11
+ renders them at request time.
12
+
13
+ ## Read Order
14
+
15
+ 1. Read `.agents/skills/raybase-astro-emdash/SKILL.md`.
16
+ 2. Read `dev/SPEC.md`, `dev/SPEC-OVERVIEW.md`, and `dev/CODEBASE-MAP.md`.
17
+ 3. Inspect `site/src/pages/[...slug].astro`, `site/seed/seed.json`, and any existing Galley templates or blocks in EmDash before changing page sections.
18
+
19
+ ## Default Pattern
20
+
21
+ - Use the pages collection `design` field (a `galley:block` designed field) when a page's structure comes from a page-starter template; the public route renders `design.templateId` when set and falls back to `pages.content` Portable Text.
22
+ - Use `pages.content` Portable Text for editable prose. `galley.block` (page-local) and `galley.shared` (reusable) embeds live inline in that prose; they are not page structure.
23
+ - Prefer Raybase Templates for reusable runtime-editable sections, layouts (shells), page starters, and guided theme families when registry content fits. For full-site assembly, read `.agents/skills/raybase-astro-emdash-theme-selection/SKILL.md` and select a theme (voice + vocabulary — palette, sections, page starters) then a shell (the layout with its welded nav + footer, chosen by capacity) before activation.
24
+ - Installed Templates are staged under `site/seed/templates/`; page starters also stage v2 page seeds (`design` pointers) under `site/seed/pages/`. Apply them locally with `pnpm --dir site run templates:apply`, then review drafts; apply activates structure only when an `activation.json` work order staged by `templates shell add --activate` is present, and deletes it once consumed.
25
+ - Use `raybase templates add <id> --bind <alias=collection>` or `raybase templates theme add <theme-id> --bind <alias=collection>` when a selected template needs an EmDash collection data source override. For menu-bound nav/footer templates, use `--bind <alias>=menu:<name>` (usually `links=menu:primary`, `footerLinks=menu:footer`, `socialLinks=menu:social`, or `legalLinks=menu:legal`).
26
+ - This skill assumes the bound EmDash collections already exist. To model collections, fields, bindings, and seed content (`site/seed/seed.json`), read `.agents/skills/raybase-astro-emdash-content-model/SKILL.md` first.
27
+ - Use `widget: "galley:block"` JSON fields plus `<DynamicField />` only when a collection entry needs a designed field outside a Portable Text body.
28
+ - Publish Galley templates before relying on them on the public site.
29
+ - Keep every Portable Text block node keyed with `_key`; Galley edit context depends on stable block keys.
30
+
31
+ ## What Stays In Astro
32
+
33
+ Use Astro source for route shells, metadata/layout, `raybase.actionIsland`, allow-listed Raybase Server Island proxies, custom data fetching, and non-content app behavior. Do not create new Astro components for ordinary marketing, editorial, hero, feature, CTA, media, testimonial, pricing, FAQ, or landing-page sections unless the approved spec explicitly requires non-content runtime behavior. The same rule covers `site/src/pages/[...slug].astro` itself: never replace its designed/Portable-Text render paths with hard-coded page markup — a page rendered outside those paths emits no edit annotations and silently disconnects the EmDash visual editor. If a spec truly requires custom entry markup (record it as a Deviation), it must spread EmDash edit annotations (`{...entry.edit.<field>}` → `data-emdash-ref`) on every content-derived element, and the Deviation is only complete when edit mode still lights the page up.
34
+
35
+ ## Template Authoring
36
+
37
+ - Create or update templates through EmDash admin, Operator/MCP tools, or the Galley plugin API at `/_emdash/api/plugins/galley/templates/save`.
38
+ - Keep template ids lowercase dash-case and stable once content references them.
39
+ - Define `fields` for every editable value. Prefer explicit scalar fields, `portableText` fields for rich body copy, `list` fields for repeated cards, and `group` fields for structured clusters.
40
+ - Mark inline-editable Liquid output with Galley attributes such as `data-dynamic-text`, `data-dynamic-href`, `data-dynamic-src`, `data-dynamic-alt`, `data-dynamic-title`, `data-dynamic-aria-label`, `data-dynamic-list`, and `data-dynamic-list-item`.
41
+ - Content facts from CMS entries come through **typed template context** (see the next section), never through field bindings — the old ambient `entry.*` binding vocabulary was removed in galley 0.6 and now fails validation with "uses removed entry.* context; declare template.context". `fields` are local surface settings only (accent, CTA label, layout toggles).
42
+ - Use `dataSources` for collection/list data instead of ad hoc Liquid queries. A `where` value may be a context path (`"author": "post.author"`) — it resolves against the declared context entry at render time.
43
+ - Use `dataSources` for menus instead of local nav/footer copies. Menu data
44
+ source aliases intentionally shadow local fields of the same name, so a
45
+ template can keep `fields.links.default` for install seeding and previews
46
+ while production render reads `dataSources.links = { "kind": "menu",
47
+ "menu": "primary" }`.
48
+ - Keep Liquid local and deterministic. Do not fetch external data from Liquid templates.
49
+
50
+ Compose templates with `{% render "template-id" %}`. The tag accepts section (surface-role) and partial targets; layout-role targets are forbidden. Use bare template ids only — resolution goes through the app's installed templates, with no per-reference version pinning. A failed render degrades to an HTML comment in production and a visible error card in editing/preview, so a broken reference never breaks the page. Page starters and layouts are themselves such compositions: a page starter renders its sections, a layout renders its nav/footer and declares only a `content` slot. Render arguments pass values into the child's fields (`{% render "cta", label: heading %}`) and entries into its declared context (`{% render "post-header", post: post %}`).
51
+
52
+ ## Typed Template Context
53
+
54
+ A template declares the CMS entries its Liquid reads as named, typed context
55
+ (galley 0.6+). Context is how content facts reach templates; `fields` carry
56
+ only local presentation settings.
57
+
58
+ ```json
59
+ "context": {
60
+ "post": { "kind": "entry", "collection": "posts", "source": "host" }
61
+ }
62
+ ```
63
+
64
+ - `source: "host"` resolves the entry from the render surface — the entry
65
+ whose designed field is being rendered. `source: "argument"` receives the
66
+ entry from a `{% render %}` argument (sections composed by a starter).
67
+ `source: { "from": "post.author" }` chases a reference field on another
68
+ context entry.
69
+ - Liquid reads typed objects: `{{ post.title }}`, `{{ post.image.src }}`.
70
+ Mark entry-owned output with context-path markers so the visual editor
71
+ routes edits to the entry: `data-dynamic-text="post.title"`,
72
+ `data-dynamic-src="post.image"`, and
73
+ `<div data-dynamic-portable-text="post.content">{{ post.content | portable_text }}</div>`
74
+ for long-form Portable Text bodies. Context media fields open the media
75
+ picker; `json` context fields are read-only.
76
+ - Data-source loops over entries support per-item editing: wrap each iteration
77
+ in `data-dynamic-item="<dataSourceKey>" data-dynamic-item-id="{{ item.id }}"`.
78
+ Galley annotates resolvable scopes with the entry identity (hover affordance
79
+ plus "Edit in admin"), and `data-dynamic-*` markers inside the scope route
80
+ to that entry. Unresolvable scopes are neutralized with a preview warning.
81
+
82
+ ## Menu Data Sources
83
+
84
+ Use EmDash menus for nav and footer link rows. The standard menu names are
85
+ `primary`, `footer`, `social`, and `legal`; record any deliberate non-standard
86
+ name in the site plan and bind it explicitly with `--bind alias=menu:name`.
87
+
88
+ Menu-bound templates keep the local list field and bind a menu with the same
89
+ alias:
90
+
91
+ ```json
92
+ {
93
+ "fields": {
94
+ "links": {
95
+ "label": "Links",
96
+ "kind": "list",
97
+ "fields": {
98
+ "label": { "kind": "string", "label": "Label" },
99
+ "url": { "kind": "url", "label": "URL" },
100
+ "target": { "kind": "string", "label": "Target" }
101
+ },
102
+ "default": [
103
+ { "label": "Home", "url": "/" },
104
+ { "label": "Work", "url": "/work" },
105
+ { "label": "Contact", "url": "/contact" }
106
+ ]
107
+ }
108
+ },
109
+ "dataSources": {
110
+ "links": { "kind": "menu", "menu": "primary" }
111
+ }
112
+ }
113
+ ```
114
+
115
+ The local default is not duplicate production state: it seeds a missing menu on
116
+ `templates:apply`, keeps the lab preview useful, and keeps old CLI installs
117
+ from rendering an empty nav. The menu wins at runtime whenever the source
118
+ resolves.
119
+
120
+ Wrap the loop with a list marker and mark editable item fields by alias path:
121
+
122
+ ```liquid
123
+ <nav data-dynamic-list="links" aria-label="Primary">
124
+ {% for link in links %}
125
+ <a
126
+ href="{{ link.url | default: '#' }}"
127
+ {% if link.target %}target="{{ link.target | escape }}"{% endif %}
128
+ data-dynamic-list-item="links.{{ forloop.index0 }}"
129
+ data-dynamic-href="links.{{ forloop.index0 }}.url"
130
+ data-dynamic-text="links.{{ forloop.index0 }}.label"
131
+ >{{ link.label | escape }}</a>
132
+ {% endfor %}
133
+ </nav>
134
+ ```
135
+
136
+ `link.children` is available for dropdown navs and column footers. For sitemap
137
+ or standard column footers, bind one `footer` menu: top-level items are column
138
+ headings, each heading's `children` are the column links. Social and legal rows
139
+ stay separate flat menus.
140
+
141
+ Menu edit semantics are live: visual-editor add, reorder, duplicate, remove,
142
+ label, URL, and target edits write directly through EmDash menus, with no draft
143
+ or revision layer. The visual editor edits top-level menu items only today;
144
+ nested dropdown children and footer column contents are edited through
145
+ `/_emdash/admin/menus/<name>`, reachable from the toolbar's "Open in EmDash"
146
+ deep link. Reference-type menu item URLs are read-only in the popover because
147
+ they follow the referenced entry's URL.
148
+
149
+ ## Entry-Hosted Detail Pages
150
+
151
+ A collection's detail page (a post, article, book, product page) is a shared
152
+ **entry-hosted page starter**, not a per-entry composition and never bespoke
153
+ Astro markup. The starter declares `context.post` with `source: "host"`, its
154
+ manifest carries a `host` block (`{ "collection": "articles", "contextKey":
155
+ "post" }`), and installation ships a `host.json` staging artifact that gives
156
+ the bound collection a `galley:block` design field whose options default every
157
+ entry to the starter — galley's value-less render then makes it the page for
158
+ every entry, with no per-entry seeding. Editors change the entry; the page
159
+ follows.
160
+
161
+ - Editability rule: every collection whose entries get public detail pages
162
+ must have a `galley:block` design field bound to an entry-hosted page
163
+ starter this way. Never hand-write Astro/HTML section markup for content
164
+ pages — hand-written markup renders fine but is invisible to the visual
165
+ editor (no `data-dynamic-*` annotations, nothing editable). If no fitting
166
+ registry starter exists, adapt one rather than writing raw markup.
167
+ - Install with `raybase templates add <starter-id> --bind <contextKey>=<collection>`
168
+ when the app's collection differs from the registry convention
169
+ (`--bind post=posts`); the binding retargets the host collection, every
170
+ context declaration in the install graph, and the starter's rails that
171
+ queried the convention collection. Then `pnpm --dir site run templates:apply`
172
+ publishes the templates and creates the design field.
173
+ - The public catch-all renders the designed page automatically: it resolves
174
+ the collection's design field from the EmDash schema and renders
175
+ `value ?? null` (schema default template) with the entry as host context.
176
+ - Adapting a detail starter to a bespoke collection (books, case studies) is
177
+ normal: install the nearest starter, then edit the installed Liquid/context
178
+ declarations to the collection's field slugs. Keep the context declarations
179
+ and markers intact — they are what keep the page editable.
180
+
181
+ ## App Setup
182
+
183
+ - `site/astro.config.mjs` must register `plugins: [galley()]` inside `emdash(...)`.
184
+ - `site/src/pages/[...slug].astro` must render `PortableText` with `@raybase/galley/astro` `blockComponents` and attach `getEditMeta()` context to `galley.block` and `galley.shared` nodes.
185
+ - Portable Text-embedded Galley blocks need a real EmDash edit-mode session
186
+ (`emdash-edit-mode=true` cookie) for SSR source maps. In standalone
187
+ `?dynamicBlocksEditor=1` sessions, linked-source editing for PT-embedded
188
+ blocks may classify bindings only after the first live re-render; use the
189
+ EmDash edit-mode toolbar when verifying menu or entry-bound source editing
190
+ inside Portable Text.
191
+ - Local starter bootstrap: with the site dev server running, `pnpm --dir site run seed:galley` installs a sample published Galley template and updates the home page to use it. Prefer the Template bootstrap below when registry content fits; `seed:galley` is the no-registry fallback.
192
+ - Template bootstrap: `raybase templates add <id> --stage-only`, `raybase templates theme add <theme-id> --stage-only`, and `raybase templates shell add <layout-id> --stage-only` write draft template payloads and provenance, and `pnpm --dir site run templates:apply` pushes them to the local Galley API. `shell add --activate` stages an ephemeral `site/seed/templates/<layout-id>/activation.json` work order; apply consumes and deletes it, publishing the selected public templates and setting the active Galley layout pointer and palette.
193
+ - For production or existing content databases, create templates and content through EmDash admin or MCP/operator tools instead of relying on the local dev bootstrap.
194
+
195
+ ## Demo Starter Set
196
+
197
+ `site/demo/` is a worked example of every wiring pattern in this skill, in the
198
+ standard file-installable Template format. Read it before authoring your first
199
+ template — reading needs no dev server and is the intended use:
200
+
201
+ - `templates/demo-article-page/` — entry-hosted page starter: `context.post`
202
+ with `source: "host"`, the manifest `host` block, `host.json` (the design
203
+ field seed), `data-dynamic-text`/`data-dynamic-portable-text` markers, and a
204
+ local presentation field (`backLabel`) beside entry-owned facts.
205
+ - `templates/demo-articles-index/` — a `dataSources` collection query looped
206
+ with `data-dynamic-item`/`data-dynamic-item-id` per-entry edit markers,
207
+ `{% render "demo-article-card", article: article %}` composition, a staged
208
+ v2 `page.json`, and the list-default idiom: the `notes` list carries its
209
+ content in the field's `default`, because list data declared only in sample
210
+ content renders empty once a page composes the template.
211
+ - `templates/demo-article-card/` — a partial fed by render arguments through
212
+ a `group` field with a standalone-preview default.
213
+ - `templates/demo-menu-nav/` — a menu-bound nav partial: local `links`
214
+ defaults beside `dataSources.links = { "kind": "menu", "menu": "primary" }`,
215
+ `data-dynamic-list` ownership markers, per-item label/URL markers, a target
216
+ control through the menu-item popover, and the seed-on-apply fallback pattern
217
+ used by real nav/footer templates. It is inspect-first and not installed by
218
+ `demo:load`, because `primary` is live owner data rather than draft demo
219
+ content.
220
+ - `content/collection.json` and `content/entries.json` — the collection schema
221
+ (its `urlPattern` routes entries to the entry-hosted page) and draft entries
222
+ whose Portable Text bodies explain the wiring from the reader's side.
223
+
224
+ Optionally load it live: `pnpm --dir site run demo:load` (site dev server
225
+ running) creates the draft `demoarticles` collection and entries, installs
226
+ the three templates through the real `raybase templates add file://…` path,
227
+ and applies them. Everything stays draft — nothing renders publicly. It writes
228
+ `.raybase/galley-demo.json`, and `raybase doctor` warns until
229
+ `pnpm --dir site run demo:unload` removes the collection, entries, page,
230
+ staged seeds, and lock entries. The demo is teaching material: copy its wiring
231
+ (typed context, field defaults, collection dataSources, menu dataSources),
232
+ never its look — real pages come from registry Templates via the
233
+ theme-selection skill. Never deploy with the demo loaded.
234
+
235
+ ## Shell Nav/Footer Swap Recipe
236
+
237
+ A shell welds one nav and one footer into its layout Liquid — that is intentional (the pair are the bookends of every page and the layout owns their physics). Selecting a *different* shell is the normal move. But swapping just the nav or footer *within* a shell has **no CLI flag by design**; composition edits are Liquid's job everywhere else in the system, and the shell is no exception. Divorce is available — you just file the paperwork:
238
+
239
+ 1. Install the replacement partial: `raybase templates add <other-nav-or-footer-id> --stage-only`.
240
+ 2. Hand-edit the shell layout's staged `template.liquid` (`site/seed/templates/<layout-id>/template.json` → `liquidSource`): rewrite the `{% render "old-nav" %}` / `{% render "old-footer" %}` line to render the replacement id. Match the layout's container/height contract so the handoff from last band to footer still holds.
241
+ 3. Update the layout manifest's `relations.requires` to include the replacement (so the dependency graph and doctor stay honest). Leave the `shell.*` provenance block untouched — it records what the shell *shipped* with; the swap is a local deviation, not a new shell.
242
+ 4. Record a **Deviation** in `DESIGN.md`: "swapped `<layout>`'s footer to `<other-footer>` — needed a sitemap-grade footer the family didn't ship." Recurring swaps like this are exactly the signal the registry uses to author a missing shell.
243
+
244
+ ## One-Page Anchor Targets
245
+
246
+ Anchor-tuned shells (`shell.capacity.anchorNav`) point their nav links at same-page anchors (`#work`, `#pricing`). The anchor targets belong to the **page starter**, not the shell and not the section templates:
247
+
248
+ - Wrap each anchored band in the starter's Liquid: `<div id="work" class="scroll-mt-24">{% render "family-work-band" %}</div>`. Ids are stable kebab-case names matching the nav's anchor hrefs; `scroll-mt-*` keeps a sticky nav from overlapping the scrolled-to band — size it to the shell's header height.
249
+ - Do not put ids inside section templates: sections repeat across pages and would duplicate ids. Do not gate anchored bands behind scroll-triggered visibility — a nav jump to a hidden band lands on nothing.
250
+ - An anchor-tuned nav with zero links still renders the brand block (and CTA when declared) — a brand bar, never an empty strip.
251
+
252
+ ## Behavior And Motion
253
+
254
+ - Templates that declare `data-rb-motion` use `site/src/lib/site-motion.ts`.
255
+ - Do not treat `motion.strategy: "site-helper-v1"` as a missing JavaScript sidecar.
256
+ - Basecoat and future behavior sidecars are Galley/template-host concerns. Do not hand-roll them in React app UI.
257
+
258
+ ## Verification
259
+
260
+ Run relevant checks before handoff:
261
+
262
+ - `pnpm --dir site run check`
263
+ - `raybase doctor`
264
+ - `raybase check`
265
+ - Browser smoke test `/`, `/_emdash/admin/plugins/galley/templates`, and any edited page while signed in through the Raybase handoff.
@@ -0,0 +1,218 @@
1
+ ---
2
+ name: raybase-astro-emdash-migration
3
+ description: Inventory and migrate an existing public site into a Raybase Astro/EmDash content site, preserving meaning, owner-approved URLs, media references, and content parity while redesigning through the normal site-planning, theme, and Galley skills.
4
+ ---
5
+
6
+ # Raybase Astro/EmDash Migration Skill
7
+
8
+ Use this skill when `dev/SPEC.md` says an `astro-emdash` app is migrating
9
+ content from an existing public site. This skill runs after spec approval and
10
+ before the content-model skill: it produces the inventory, URL map, media list,
11
+ and conversion decisions that the site plan consumes.
12
+
13
+ Default: migrate the existing site's meaning and content into a new Raybase
14
+ Sites design system. Faithful visual reproduction is an explicit owner-approved
15
+ exception, and even then stays inside the starter's token contract, Galley
16
+ templates, and editor-owned content model.
17
+
18
+ ## Read Order
19
+
20
+ 1. Read `.agents/skills/raybase-astro-emdash/SKILL.md` for the site/spine
21
+ ownership boundaries.
22
+ 2. Read `dev/SPEC.md`, `dev/SPEC-OVERVIEW.md`, and `dev/CODEBASE-MAP.md`.
23
+ 3. Read
24
+ [references/inventory-and-conversion.md](references/inventory-and-conversion.md).
25
+ 4. Produce or update `dev/migration/inventory.md`.
26
+ 5. Continue into `.agents/skills/raybase-astro-emdash-content-model/SKILL.md`
27
+ using the inventory as an input to the Site plan.
28
+
29
+ ## Migration Stance
30
+
31
+ Agree the stance with the owner before collecting or converting content:
32
+
33
+ - **Redesign is the default.** Preserve content, IA intent, editorial voice,
34
+ media, and URLs where useful; express the site through a registry theme,
35
+ page starters, Galley sections, and EmDash collections.
36
+ - **Faithful reproduction is exceptional.** It requires explicit approval and
37
+ must still fit the starter. Do not promise pixel-matching another builder,
38
+ recreating proprietary widgets, or bypassing Galley/editor boundaries.
39
+ - **URLs are a product decision.** Preserve slugs for kept pages whenever
40
+ possible with page slugs or collection `urlPattern`s. Record renames and
41
+ drops in the URL map.
42
+ - **Copy improvements are separate.** Migrate owner copy as written unless the
43
+ owner approves an edit. Record proposed rewrites as recommendations, not as
44
+ silent conversion changes.
45
+
46
+ ## Inventory Rules
47
+
48
+ Inventory comes from browser investigation only. Use whatever browser, fetch,
49
+ or Playwright tooling the harness provides to inspect the live public site:
50
+ start with public discovery surfaces such as `/sitemap.xml` when available,
51
+ then treat the rendered live navigation and footer as the IA ground truth, and
52
+ walk every discoverable page. Do not ask for or depend on CMS exports,
53
+ WordPress XML/WXR, database dumps, platform APIs, or private admin access.
54
+
55
+ Create `dev/migration/inventory.md` from the reference template. It must
56
+ include:
57
+
58
+ - Page inventory: old URL, title, purpose, observed content, and keep/merge/drop
59
+ recommendation.
60
+ - Repeated content types with real counts: articles, products, books, team,
61
+ events, testimonials, FAQs, resources, or whatever the site actually has.
62
+ - Media inventory: each image/file slot, the page or entry using it, current
63
+ source URL, intended destination, alt text status, and whether it came from
64
+ the old site or is a new stock stand-in.
65
+ - Nav and footer link sets with counts and depth. These feed shell capacity
66
+ selection later.
67
+ - Old to new URL map, including preserved slugs, renames, drops, and any
68
+ redirect requirement.
69
+
70
+ If the site is a JavaScript app, inspect the rendered DOM and network results
71
+ rather than treating the initial HTML shell as the content. Broken or shell-like
72
+ discovery surfaces (`/sitemap.xml`, `/robots.txt`, source HTML) are not proof
73
+ that detail pages are empty; follow rendered nav, bundles, links, and hydrated
74
+ routes before dropping anything. If a page is gated, unreachable, or
75
+ intentionally excluded, record that limitation in the inventory instead of
76
+ inventing content.
77
+
78
+ ## IA And URL Map
79
+
80
+ Before modeling content, confirm the IA map with the owner:
81
+
82
+ - `keep`: the page or entry survives, ideally at the same slug.
83
+ - `merge`: content moves into another page or collection entry.
84
+ - `drop`: content is intentionally left out.
85
+ - `rename`: content survives at a new URL.
86
+
87
+ The current template has no built-in redirect map. Prefer preserved slugs for
88
+ surviving pages. If redirects are required, implement them in
89
+ `site/src/middleware.ts` as a recorded Deviation in `DESIGN.md`/`dev/SPEC.md`,
90
+ then verify each mapped old URL. Do not imply redirect support exists until
91
+ the app contains it.
92
+
93
+ ## Content Modeling And Conversion
94
+
95
+ Let the content-model skill own the EmDash schema and site plan. This skill
96
+ owns the conversion discipline:
97
+
98
+ - Page-backing collections are for repeated items with detail pages:
99
+ articles, books, projects, products, events, resources.
100
+ - Section-data collections are for reusable rails: testimonials, team, logos,
101
+ FAQs, featured items.
102
+ - One-off marketing pages become page starters and Galley section data, not a
103
+ verbatim translation of page-builder markup.
104
+ - Long-form articles and resources convert to Portable Text `content` using
105
+ the mapping table in the reference.
106
+ - Stable `_key`s are required for every Portable Text block and span.
107
+
108
+ Migrate meaning, not markup. Remove builder wrappers, spacer divs, animation
109
+ classes, and inline style debris. Preserve headings, paragraphs, lists,
110
+ quotes, links, media relationships, captions, and the editorial order that
111
+ matters to readers.
112
+
113
+ ## Fresh App Vs Live Database
114
+
115
+ Choose the vehicle from database state:
116
+
117
+ - **Fresh app with an empty EmDash database:** author the migration in
118
+ `site/seed/seed.json`. Use `$media` values for already-hosted media URLs so
119
+ EmDash downloads the assets on first apply. This path is declarative,
120
+ reviewable, and re-runnable on a clean DB.
121
+ - **Live database with real content:** use EmDash CLI/admin operations:
122
+ `pnpm --dir site exec emdash content create`, `content update`,
123
+ `content publish`, and `media upload`. Do not rewrite already-applied seed
124
+ content and expect it to mutate the live database.
125
+
126
+ For CLI media uploads, authenticate with a real EmDash API token created from
127
+ the signed-in admin/settings flow for that app. If a local Raybase-authenticated
128
+ preview blocks `/_emdash/api/setup/dev-bypass`, do not present dev-bypass or a
129
+ hand-inserted D1 token as the normal path. For a local-only dry run, you may
130
+ record a temporary D1 token workaround in the migration ledger, but the owner
131
+ handoff must say the production path still needs a real admin-issued token or
132
+ admin UI upload.
133
+
134
+ For seed `$media`, first-request apply can warn and skip media that cannot be
135
+ downloaded, leaving the image field empty while continuing the rest of the
136
+ seed. Check first-request logs and fall back to downloading the asset locally
137
+ and uploading it with the CLI.
138
+
139
+ Astro's live content helpers also require `site/src/live.config.ts` to define
140
+ the `_emdash` live collection with `emdashLoader()` from `emdash/runtime`.
141
+ Without it, `getEmDashEntry`, `getEmDashCollection`, and search can return
142
+ empty results even when D1 has seeded rows.
143
+
144
+ ## Media Migration
145
+
146
+ Harvest the highest-resolution media URL the public page actually serves.
147
+ When a CDN URL carries resizing parameters and the host permits a cleaner
148
+ original URL, strip the resizing query params and verify the resulting URL
149
+ before using it. Never guess image URLs.
150
+
151
+ Destination rule:
152
+
153
+ - EmDash collection `image` fields get media objects, usually via seed
154
+ `$media` for fresh apps or CLI-uploaded media for live databases.
155
+ - Galley `data-dynamic-src` fields get URL strings. For CLI-uploaded media,
156
+ use the site-origin-qualified `/_emdash/api/media/file/{storageKey}` URL.
157
+ - Alt text is authored in the site's voice. Do not derive alt text from
158
+ filenames.
159
+
160
+ When verifying a built Cloudflare/Wrangler preview locally, distinguish D1 media
161
+ metadata from R2 file bytes. Seed `$media` downloads files to the CLI
162
+ `--uploads-dir`; the Worker serves `/_emdash/api/media/file/{storageKey}` from
163
+ the configured R2 binding. Verify the rendered media URLs return 200. If they
164
+ 404 in local preview while media rows exist, hydrate local R2 from the upload
165
+ directory or upload the assets through the API before declaring parity.
166
+
167
+ In pinned EmDash 0.23, direct CLI media upload can accept `--alt`/`--caption`
168
+ without persisting them to the media row. Treat the upload result as the source
169
+ of truth and set final alt text on the consuming collection entry or Galley
170
+ field until the upload endpoint persists those fields.
171
+
172
+ Image licensing is the owner's responsibility. Do not audit rights or identify
173
+ stock provenance as a migration task. The handoff message must include one
174
+ sentence: imagery from the old site was republished as-is; confirm you hold the
175
+ rights before publish.
176
+
177
+ ## Redesign Through Existing Skills
178
+
179
+ After the inventory and owner-approved IA map exist:
180
+
181
+ 1. Run the content-model skill to turn the inventory into the `## Site plan`,
182
+ EmDash collections, bindings, and seed/live content path.
183
+ 2. Run the design skill. Record the old site as a reference or anti-reference
184
+ in `DESIGN.md` using the direction fields defined by the design skill; do
185
+ not let the old builder dictate the new theme.
186
+ 3. Run theme selection and Galley adaptation using the migration-derived page
187
+ inventory, link counts, collection counts, and media inventory.
188
+ 4. Keep old-site content parity separate from design polish. Design may
189
+ improve presentation; it must not make migrated content disappear.
190
+
191
+ ## Verification
192
+
193
+ In addition to the hub Browser Verification recipe:
194
+
195
+ - Every kept page in `dev/migration/inventory.md` resolves at its intended new
196
+ URL and renders migrated content.
197
+ - Per-collection counts match the inventory, or every intentional difference
198
+ is recorded.
199
+ - First-request logs have no unresolved `$media` failures.
200
+ - Every rendered `/_emdash/api/media/file/{storageKey}` URL for migrated media
201
+ returns 200 in the verification environment.
202
+ - No stock stand-in appears where the old site had usable real media, unless
203
+ the owner explicitly chose the replacement.
204
+ - The old to new URL map is honored. Preserved old slugs resolve; implemented
205
+ redirects return the intended destination.
206
+ - Site search, when enabled for migrated collections, returns migrated entries.
207
+ - **The migrated site stays runtime-editable.** Every kept page passes the hub
208
+ skill's editability gate (Edit mode lights up designed blocks, Portable
209
+ Text, or context markers). Content parity achieved through hard-coded
210
+ markup is a failed migration: operators must be able to change the content
211
+ through EmDash without code changes, as the spec promises.
212
+
213
+ ## Handoff
214
+
215
+ The handoff should name the inventory file, summarize kept/merged/dropped
216
+ content, call out redirect limitations or middleware deviations, and include
217
+ the image-rights sentence above. Do not ask the owner to verify basic parity
218
+ instead of doing the browser check yourself.