@raybase/create 0.0.1 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (644) hide show
  1. package/LICENSE +21 -0
  2. package/THIRD_PARTY_NOTICES.md +38 -0
  3. package/assets/apple-touch-icons/0.png +0 -0
  4. package/assets/apple-touch-icons/1.png +0 -0
  5. package/assets/apple-touch-icons/2.png +0 -0
  6. package/assets/apple-touch-icons/3.png +0 -0
  7. package/assets/apple-touch-icons/4.png +0 -0
  8. package/assets/apple-touch-icons/5.png +0 -0
  9. package/assets/apple-touch-icons/6.png +0 -0
  10. package/assets/apple-touch-icons/7.png +0 -0
  11. package/assets/apple-touch-icons/8.png +0 -0
  12. package/assets/apple-touch-icons/9.png +0 -0
  13. package/assets/apple-touch-icons/A.png +0 -0
  14. package/assets/apple-touch-icons/B.png +0 -0
  15. package/assets/apple-touch-icons/C.png +0 -0
  16. package/assets/apple-touch-icons/D.png +0 -0
  17. package/assets/apple-touch-icons/E.png +0 -0
  18. package/assets/apple-touch-icons/F.png +0 -0
  19. package/assets/apple-touch-icons/G.png +0 -0
  20. package/assets/apple-touch-icons/H.png +0 -0
  21. package/assets/apple-touch-icons/I.png +0 -0
  22. package/assets/apple-touch-icons/J.png +0 -0
  23. package/assets/apple-touch-icons/K.png +0 -0
  24. package/assets/apple-touch-icons/L.png +0 -0
  25. package/assets/apple-touch-icons/M.png +0 -0
  26. package/assets/apple-touch-icons/N.png +0 -0
  27. package/assets/apple-touch-icons/O.png +0 -0
  28. package/assets/apple-touch-icons/P.png +0 -0
  29. package/assets/apple-touch-icons/Q.png +0 -0
  30. package/assets/apple-touch-icons/R.png +0 -0
  31. package/assets/apple-touch-icons/S.png +0 -0
  32. package/assets/apple-touch-icons/T.png +0 -0
  33. package/assets/apple-touch-icons/U.png +0 -0
  34. package/assets/apple-touch-icons/V.png +0 -0
  35. package/assets/apple-touch-icons/W.png +0 -0
  36. package/assets/apple-touch-icons/X.png +0 -0
  37. package/assets/apple-touch-icons/Y.png +0 -0
  38. package/assets/apple-touch-icons/Z.png +0 -0
  39. package/assets/apple-touch-icons/default.png +0 -0
  40. package/dist/.source-hash +1 -0
  41. package/dist/index.d.ts +56 -0
  42. package/dist/index.d.ts.map +1 -0
  43. package/dist/index.js +2351 -0
  44. package/dist/index.js.map +1 -0
  45. package/dist/raybase-package-ranges.d.ts +11 -0
  46. package/dist/raybase-package-ranges.d.ts.map +1 -0
  47. package/dist/raybase-package-ranges.js +11 -0
  48. package/dist/raybase-package-ranges.js.map +1 -0
  49. package/dist/source-fetch.d.ts +91 -0
  50. package/dist/source-fetch.d.ts.map +1 -0
  51. package/dist/source-fetch.js +325 -0
  52. package/dist/source-fetch.js.map +1 -0
  53. package/dist/source-hash.d.ts +2 -0
  54. package/dist/source-hash.d.ts.map +1 -0
  55. package/dist/source-hash.js +23 -0
  56. package/dist/source-hash.js.map +1 -0
  57. package/dist/starter-description.d.ts +44 -0
  58. package/dist/starter-description.d.ts.map +1 -0
  59. package/dist/starter-description.js +273 -0
  60. package/dist/starter-description.js.map +1 -0
  61. package/dist/starter-source.d.ts +43 -0
  62. package/dist/starter-source.d.ts.map +1 -0
  63. package/dist/starter-source.js +156 -0
  64. package/dist/starter-source.js.map +1 -0
  65. package/dist/store-app-apply.d.ts +27 -0
  66. package/dist/store-app-apply.d.ts.map +1 -0
  67. package/dist/store-app-apply.js +100 -0
  68. package/dist/store-app-apply.js.map +1 -0
  69. package/dist/store-app-manifest.d.ts +86 -0
  70. package/dist/store-app-manifest.d.ts.map +1 -0
  71. package/dist/store-app-manifest.js +110 -0
  72. package/dist/store-app-manifest.js.map +1 -0
  73. package/dist/store-app-registry.d.ts +30 -0
  74. package/dist/store-app-registry.d.ts.map +1 -0
  75. package/dist/store-app-registry.js +232 -0
  76. package/dist/store-app-registry.js.map +1 -0
  77. package/models/recommended.json +42 -0
  78. package/modules/api/templates/react-router/app/api/operations.ts +8 -0
  79. package/modules/api/templates/tanstack-start/src/api/operations.ts +15 -0
  80. package/modules/docs/templates/astro-emdash/content/docs/getting-started.mdx +13 -0
  81. package/modules/docs/templates/astro-emdash/content/docs/index.mdx +13 -0
  82. package/modules/docs/templates/astro-emdash/content/docs/mcp.mdx +11 -0
  83. package/modules/docs/templates/astro-emdash/content/docs/meta.json +4 -0
  84. package/modules/docs/templates/astro-emdash/site/content/docs/getting-started.mdx +12 -0
  85. package/modules/docs/templates/astro-emdash/site/content/docs/index.mdx +12 -0
  86. package/modules/docs/templates/astro-emdash/site/content/docs/mcp.mdx +10 -0
  87. package/modules/docs/templates/astro-emdash/site/content/docs/meta.json +4 -0
  88. package/modules/docs/templates/astro-emdash/site/source.config.ts +10 -0
  89. package/modules/docs/templates/astro-emdash/site/src/docs/docs-assets.ts +1 -0
  90. package/modules/docs/templates/astro-emdash/site/src/docs/docs-client.tsx +22 -0
  91. package/modules/docs/templates/astro-emdash/site/src/docs/docs-data.ts +24 -0
  92. package/modules/docs/templates/astro-emdash/site/src/docs/docs-handler.tsx +105 -0
  93. package/modules/docs/templates/astro-emdash/site/src/docs/docs-layout.tsx +56 -0
  94. package/modules/docs/templates/astro-emdash/site/src/docs/docs-mdx.tsx +79 -0
  95. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page-actions.tsx +146 -0
  96. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page.tsx +70 -0
  97. package/modules/docs/templates/astro-emdash/site/src/docs/llm-text.ts +61 -0
  98. package/modules/docs/templates/astro-emdash/site/src/docs/source.ts +7 -0
  99. package/modules/docs/templates/astro-emdash/site/src/pages/docs/[...slug].ts +6 -0
  100. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/markdown.ts +4 -0
  101. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/search.ts +4 -0
  102. package/modules/docs/templates/astro-emdash/site/src/pages/llms.txt.ts +8 -0
  103. package/modules/docs/templates/astro-emdash/site/src/styles-docs.css +3 -0
  104. package/modules/docs/templates/astro-emdash/source.config.ts +10 -0
  105. package/modules/docs/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
  106. package/modules/docs/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
  107. package/modules/docs/templates/astro-emdash/src/docs/docs-data.ts +24 -0
  108. package/modules/docs/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
  109. package/modules/docs/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
  110. package/modules/docs/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
  111. package/modules/docs/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
  112. package/modules/docs/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
  113. package/modules/docs/templates/astro-emdash/src/docs/llm-text.ts +61 -0
  114. package/modules/docs/templates/astro-emdash/src/docs/source.ts +7 -0
  115. package/modules/docs/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
  116. package/modules/docs/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
  117. package/modules/docs/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
  118. package/modules/docs/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
  119. package/modules/docs/templates/astro-emdash/src/routes/docs.tsx +22 -0
  120. package/modules/docs/templates/astro-emdash/src/styles-docs.css +3 -0
  121. package/modules/docs/templates/react-router/app/components/mdx.tsx +79 -0
  122. package/modules/docs/templates/react-router/app/lib/layout.shared.tsx +54 -0
  123. package/modules/docs/templates/react-router/app/lib/source.ts +7 -0
  124. package/modules/docs/templates/react-router/app/routes/docs.$.tsx +49 -0
  125. package/modules/docs/templates/react-router/app/routes/docs.api.search.ts +10 -0
  126. package/modules/docs/templates/react-router/app/routes/docs.tsx +13 -0
  127. package/modules/docs/templates/react-router/content/docs/getting-started.mdx +8 -0
  128. package/modules/docs/templates/react-router/content/docs/index.mdx +8 -0
  129. package/modules/docs/templates/react-router/content/docs/mcp.mdx +121 -0
  130. package/modules/docs/templates/react-router/content/docs/meta.json +4 -0
  131. package/modules/docs/templates/react-router/source.config.ts +5 -0
  132. package/modules/docs/templates/tanstack-start/content/docs/getting-started.mdx +10 -0
  133. package/modules/docs/templates/tanstack-start/content/docs/index.mdx +8 -0
  134. package/modules/docs/templates/tanstack-start/content/docs/mcp.mdx +121 -0
  135. package/modules/docs/templates/tanstack-start/content/docs/meta.json +4 -0
  136. package/modules/docs/templates/tanstack-start/source.config.ts +10 -0
  137. package/modules/docs/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
  138. package/modules/docs/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
  139. package/modules/docs/templates/tanstack-start/src/docs/docs-data.ts +24 -0
  140. package/modules/docs/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
  141. package/modules/docs/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
  142. package/modules/docs/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
  143. package/modules/docs/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
  144. package/modules/docs/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
  145. package/modules/docs/templates/tanstack-start/src/docs/llm-text.ts +61 -0
  146. package/modules/docs/templates/tanstack-start/src/docs/source.ts +7 -0
  147. package/modules/docs/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
  148. package/modules/docs/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
  149. package/modules/docs/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
  150. package/modules/docs/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
  151. package/modules/docs/templates/tanstack-start/src/routes/docs.tsx +22 -0
  152. package/modules/docs/templates/tanstack-start/src/styles-docs.css +3 -0
  153. package/modules/guide/templates/astro-emdash/content/guide/capability-map.md +17 -0
  154. package/modules/guide/templates/astro-emdash/src/components/guide-widget.tsx +41 -0
  155. package/modules/guide/templates/astro-emdash/src/guide/actions.ts +8 -0
  156. package/modules/guide/templates/astro-emdash/src/guide/config.ts +21 -0
  157. package/modules/guide/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
  158. package/modules/guide/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
  159. package/modules/guide/templates/astro-emdash/src/guide/corpus.ts +4 -0
  160. package/modules/guide/templates/astro-emdash/src/guide/resources.json +4 -0
  161. package/modules/guide/templates/react-router/app/components/guide-widget.tsx +29 -0
  162. package/modules/guide/templates/react-router/app/guide/actions.ts +3 -0
  163. package/modules/guide/templates/react-router/app/guide/config.ts +21 -0
  164. package/modules/guide/templates/react-router/app/guide/corpus.gen.ts +4 -0
  165. package/modules/guide/templates/react-router/app/guide/corpus.manifest.json +22 -0
  166. package/modules/guide/templates/react-router/app/guide/corpus.ts +4 -0
  167. package/modules/guide/templates/react-router/app/guide/resources.json +4 -0
  168. package/modules/guide/templates/react-router/content/guide/capability-map.md +13 -0
  169. package/modules/guide/templates/tanstack-start/content/guide/capability-map.md +17 -0
  170. package/modules/guide/templates/tanstack-start/src/components/guide-widget.tsx +41 -0
  171. package/modules/guide/templates/tanstack-start/src/guide/actions.ts +17 -0
  172. package/modules/guide/templates/tanstack-start/src/guide/config.ts +21 -0
  173. package/modules/guide/templates/tanstack-start/src/guide/corpus.gen.ts +4 -0
  174. package/modules/guide/templates/tanstack-start/src/guide/corpus.manifest.json +22 -0
  175. package/modules/guide/templates/tanstack-start/src/guide/corpus.ts +4 -0
  176. package/modules/guide/templates/tanstack-start/src/guide/resources.json +4 -0
  177. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  178. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  179. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  180. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  181. package/modules/openai-subscription/templates/astro-emdash/src/openai-subscription.ts +11 -0
  182. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  183. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  184. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  185. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  186. package/modules/openai-subscription/templates/react-router/app/openai-subscription.ts +11 -0
  187. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  188. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  189. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  190. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  191. package/modules/openai-subscription/templates/tanstack-start/src/openai-subscription.ts +11 -0
  192. package/package.json +34 -8
  193. package/skills/README.md +122 -0
  194. package/skills/raybase-actions/SKILL.md +223 -0
  195. package/skills/raybase-actions/references/action-patterns.md +190 -0
  196. package/skills/raybase-actions/references/adapting-actions.md +93 -0
  197. package/skills/raybase-actions/references/testing-actions.md +48 -0
  198. package/skills/raybase-agent-debugging/SKILL.md +230 -0
  199. package/skills/raybase-ai/SKILL.md +1310 -0
  200. package/skills/raybase-api/SKILL.md +45 -0
  201. package/skills/raybase-astro-emdash/SKILL.md +143 -0
  202. package/skills/raybase-astro-emdash-content-model/SKILL.md +217 -0
  203. package/skills/raybase-astro-emdash-content-model/references/LICENSE-emdash +9 -0
  204. package/skills/raybase-astro-emdash-content-model/references/emdash-collections.md +265 -0
  205. package/skills/raybase-astro-emdash-design/LICENSE-impeccable +60 -0
  206. package/skills/raybase-astro-emdash-design/SKILL.md +170 -0
  207. package/skills/raybase-astro-emdash-design/reference/color.md +91 -0
  208. package/skills/raybase-astro-emdash-design/reference/copy.md +73 -0
  209. package/skills/raybase-astro-emdash-design/reference/direction.md +115 -0
  210. package/skills/raybase-astro-emdash-design/reference/imagery.md +84 -0
  211. package/skills/raybase-astro-emdash-design/reference/layout.md +69 -0
  212. package/skills/raybase-astro-emdash-design/reference/motion.md +75 -0
  213. package/skills/raybase-astro-emdash-design/reference/polish.md +75 -0
  214. package/skills/raybase-astro-emdash-design/reference/typography.md +72 -0
  215. package/skills/raybase-astro-emdash-galley/SKILL.md +265 -0
  216. package/skills/raybase-astro-emdash-migration/SKILL.md +218 -0
  217. package/skills/raybase-astro-emdash-migration/references/inventory-and-conversion.md +242 -0
  218. package/skills/raybase-astro-emdash-security-review/SKILL.md +68 -0
  219. package/skills/raybase-astro-emdash-theme-selection/SKILL.md +216 -0
  220. package/skills/raybase-auth/SKILL.md +358 -0
  221. package/skills/raybase-background-jobs/SKILL.md +774 -0
  222. package/skills/raybase-building/SKILL.md +409 -0
  223. package/skills/raybase-building/references/interview-and-spec.md +87 -0
  224. package/skills/raybase-building/references/planning-docs.md +26 -0
  225. package/skills/raybase-building/references/schema-and-config.md +70 -0
  226. package/skills/raybase-changing-a-live-app/SKILL.md +119 -0
  227. package/skills/raybase-data-and-policies/SKILL.md +377 -0
  228. package/skills/raybase-deploy/SKILL.md +136 -0
  229. package/skills/raybase-docs-writing/SKILL.md +119 -0
  230. package/skills/raybase-guide/SKILL.md +235 -0
  231. package/skills/raybase-mcp/SKILL.md +309 -0
  232. package/skills/raybase-mcp/agents/openai.yaml +4 -0
  233. package/skills/raybase-notifications/SKILL.md +138 -0
  234. package/skills/raybase-pro-migration/SKILL.md +28 -0
  235. package/skills/raybase-react-router/SKILL.md +241 -0
  236. package/skills/raybase-react-router-design/LICENSE-impeccable +60 -0
  237. package/skills/raybase-react-router-design/SKILL.md +135 -0
  238. package/skills/raybase-react-router-design/reference/color.md +87 -0
  239. package/skills/raybase-react-router-design/reference/copy.md +83 -0
  240. package/skills/raybase-react-router-design/reference/delight.md +48 -0
  241. package/skills/raybase-react-router-design/reference/interaction.md +91 -0
  242. package/skills/raybase-react-router-design/reference/layout.md +82 -0
  243. package/skills/raybase-react-router-design/reference/motion.md +86 -0
  244. package/skills/raybase-react-router-design/reference/polish.md +79 -0
  245. package/skills/raybase-react-router-design/reference/typography.md +71 -0
  246. package/skills/raybase-react-router-security-review/LICENSE +22 -0
  247. package/skills/raybase-react-router-security-review/SKILL.md +190 -0
  248. package/skills/raybase-react-router-security-review/agents/openai.yaml +4 -0
  249. package/skills/raybase-react-router-security-review/references/api-security.md +519 -0
  250. package/skills/raybase-react-router-security-review/references/authentication.md +353 -0
  251. package/skills/raybase-react-router-security-review/references/authorization.md +372 -0
  252. package/skills/raybase-react-router-security-review/references/business-logic.md +443 -0
  253. package/skills/raybase-react-router-security-review/references/cryptography.md +329 -0
  254. package/skills/raybase-react-router-security-review/references/csrf.md +398 -0
  255. package/skills/raybase-react-router-security-review/references/data-protection.md +378 -0
  256. package/skills/raybase-react-router-security-review/references/deserialization.md +410 -0
  257. package/skills/raybase-react-router-security-review/references/error-handling.md +436 -0
  258. package/skills/raybase-react-router-security-review/references/file-security.md +457 -0
  259. package/skills/raybase-react-router-security-review/references/injection.md +259 -0
  260. package/skills/raybase-react-router-security-review/references/logging.md +433 -0
  261. package/skills/raybase-react-router-security-review/references/misconfiguration.md +435 -0
  262. package/skills/raybase-react-router-security-review/references/modern-threats.md +475 -0
  263. package/skills/raybase-react-router-security-review/references/raybase-react-router-security.md +235 -0
  264. package/skills/raybase-react-router-security-review/references/ssrf.md +413 -0
  265. package/skills/raybase-react-router-security-review/references/supply-chain.md +405 -0
  266. package/skills/raybase-react-router-security-review/references/xss.md +336 -0
  267. package/skills/raybase-realtime/SKILL.md +158 -0
  268. package/skills/raybase-realtime/agents/openai.yaml +4 -0
  269. package/skills/raybase-schema/SKILL.md +209 -0
  270. package/skills/raybase-search/SKILL.md +137 -0
  271. package/skills/raybase-search/agents/openai.yaml +4 -0
  272. package/skills/raybase-settings/SKILL.md +139 -0
  273. package/skills/raybase-settings/agents/openai.yaml +4 -0
  274. package/skills/raybase-tanstack-start/SKILL.md +166 -0
  275. package/skills/raybase-tanstack-start-design/LICENSE-impeccable +60 -0
  276. package/skills/raybase-tanstack-start-design/SKILL.md +140 -0
  277. package/skills/raybase-tanstack-start-design/reference/color.md +80 -0
  278. package/skills/raybase-tanstack-start-design/reference/copy.md +83 -0
  279. package/skills/raybase-tanstack-start-design/reference/delight.md +48 -0
  280. package/skills/raybase-tanstack-start-design/reference/interaction.md +91 -0
  281. package/skills/raybase-tanstack-start-design/reference/layout.md +82 -0
  282. package/skills/raybase-tanstack-start-design/reference/motion.md +86 -0
  283. package/skills/raybase-tanstack-start-design/reference/polish.md +79 -0
  284. package/skills/raybase-tanstack-start-design/reference/typography.md +71 -0
  285. package/skills/raybase-tanstack-start-security-review/LICENSE +22 -0
  286. package/skills/raybase-tanstack-start-security-review/SKILL.md +194 -0
  287. package/skills/raybase-tanstack-start-security-review/agents/openai.yaml +4 -0
  288. package/skills/raybase-tanstack-start-security-review/references/api-security.md +519 -0
  289. package/skills/raybase-tanstack-start-security-review/references/authentication.md +353 -0
  290. package/skills/raybase-tanstack-start-security-review/references/authorization.md +372 -0
  291. package/skills/raybase-tanstack-start-security-review/references/business-logic.md +443 -0
  292. package/skills/raybase-tanstack-start-security-review/references/cryptography.md +329 -0
  293. package/skills/raybase-tanstack-start-security-review/references/csrf.md +398 -0
  294. package/skills/raybase-tanstack-start-security-review/references/data-protection.md +378 -0
  295. package/skills/raybase-tanstack-start-security-review/references/deserialization.md +410 -0
  296. package/skills/raybase-tanstack-start-security-review/references/error-handling.md +436 -0
  297. package/skills/raybase-tanstack-start-security-review/references/file-security.md +457 -0
  298. package/skills/raybase-tanstack-start-security-review/references/injection.md +259 -0
  299. package/skills/raybase-tanstack-start-security-review/references/logging.md +433 -0
  300. package/skills/raybase-tanstack-start-security-review/references/misconfiguration.md +435 -0
  301. package/skills/raybase-tanstack-start-security-review/references/modern-threats.md +475 -0
  302. package/skills/raybase-tanstack-start-security-review/references/raybase-tanstack-security.md +208 -0
  303. package/skills/raybase-tanstack-start-security-review/references/ssrf.md +413 -0
  304. package/skills/raybase-tanstack-start-security-review/references/supply-chain.md +405 -0
  305. package/skills/raybase-tanstack-start-security-review/references/xss.md +336 -0
  306. package/skills-manifest.json +41 -0
  307. package/templates/astro-emdash/.dev.vars.example +7 -0
  308. package/templates/astro-emdash/AGENTS.md +122 -0
  309. package/templates/astro-emdash/DESIGN.md +90 -0
  310. package/templates/astro-emdash/components.json +21 -0
  311. package/templates/astro-emdash/content/docs/getting-started.mdx +20 -0
  312. package/templates/astro-emdash/content/docs/index.mdx +13 -0
  313. package/templates/astro-emdash/content/docs/mcp.mdx +11 -0
  314. package/templates/astro-emdash/content/docs/meta.json +4 -0
  315. package/templates/astro-emdash/content/docs/site-templates.mdx +62 -0
  316. package/templates/astro-emdash/dev/CODEBASE-MAP.md +46 -0
  317. package/templates/astro-emdash/dev/SPEC-OVERVIEW.md +15 -0
  318. package/templates/astro-emdash/dev/SPEC.md +84 -0
  319. package/templates/astro-emdash/dev/features/archive/.gitkeep +1 -0
  320. package/templates/astro-emdash/docs/theme-previews/base.svg +24 -0
  321. package/templates/astro-emdash/docs/theme-previews/steel.svg +24 -0
  322. package/templates/astro-emdash/docs/theme-previews/zen.svg +24 -0
  323. package/templates/astro-emdash/docs/themes.md +106 -0
  324. package/templates/astro-emdash/drizzle.config.ts +5 -0
  325. package/templates/astro-emdash/gitignore +11 -0
  326. package/templates/astro-emdash/migrations/app/meta/_journal.json +5 -0
  327. package/templates/astro-emdash/package.json +79 -0
  328. package/templates/astro-emdash/pnpm-workspace.yaml +71 -0
  329. package/templates/astro-emdash/public/_headers +4 -0
  330. package/templates/astro-emdash/site/astro.config.mjs +120 -0
  331. package/templates/astro-emdash/site/demo/README.md +72 -0
  332. package/templates/astro-emdash/site/demo/content/collection.json +43 -0
  333. package/templates/astro-emdash/site/demo/content/entries.json +120 -0
  334. package/templates/astro-emdash/site/demo/templates/demo-article-card/manifest.json +51 -0
  335. package/templates/astro-emdash/site/demo/templates/demo-article-card/sample-content.json +5 -0
  336. package/templates/astro-emdash/site/demo/templates/demo-article-card/template.liquid +48 -0
  337. package/templates/astro-emdash/site/demo/templates/demo-article-page/host.json +9 -0
  338. package/templates/astro-emdash/site/demo/templates/demo-article-page/manifest.json +38 -0
  339. package/templates/astro-emdash/site/demo/templates/demo-article-page/sample-content.json +34 -0
  340. package/templates/astro-emdash/site/demo/templates/demo-article-page/template.liquid +84 -0
  341. package/templates/astro-emdash/site/demo/templates/demo-articles-index/manifest.json +64 -0
  342. package/templates/astro-emdash/site/demo/templates/demo-articles-index/page.json +7 -0
  343. package/templates/astro-emdash/site/demo/templates/demo-articles-index/sample-content.json +24 -0
  344. package/templates/astro-emdash/site/demo/templates/demo-articles-index/template.liquid +100 -0
  345. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/manifest.json +51 -0
  346. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/sample-content.json +5 -0
  347. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/template.liquid +70 -0
  348. package/templates/astro-emdash/site/gitignore +1 -0
  349. package/templates/astro-emdash/site/package.json +56 -0
  350. package/templates/astro-emdash/site/scripts/apply-site-templates.mjs +560 -0
  351. package/templates/astro-emdash/site/scripts/galley-demo.mjs +298 -0
  352. package/templates/astro-emdash/site/scripts/seed-galley-starter.mjs +360 -0
  353. package/templates/astro-emdash/site/scripts/site-origin.mjs +45 -0
  354. package/templates/astro-emdash/site/seed/seed.json +154 -0
  355. package/templates/astro-emdash/site/seed/templates/.gitkeep +1 -0
  356. package/templates/astro-emdash/site/src/components/RaybaseSignedInMenu.astro +163 -0
  357. package/templates/astro-emdash/site/src/components/blocks/RaybaseActionIsland.astro +41 -0
  358. package/templates/astro-emdash/site/src/content-door/raybase-routes.ts +738 -0
  359. package/templates/astro-emdash/site/src/content-door/resolve-page.ts +142 -0
  360. package/templates/astro-emdash/site/src/content-door/seed.ts +85 -0
  361. package/templates/astro-emdash/site/src/env.d.ts +12 -0
  362. package/templates/astro-emdash/site/src/layouts/SiteLayout.astro +68 -0
  363. package/templates/astro-emdash/site/src/lib/palettes.gen.ts +7 -0
  364. package/templates/astro-emdash/site/src/lib/site-motion.ts +169 -0
  365. package/templates/astro-emdash/site/src/lib/site-shell.ts +294 -0
  366. package/templates/astro-emdash/site/src/live.config.ts +8 -0
  367. package/templates/astro-emdash/site/src/middleware.ts +20 -0
  368. package/templates/astro-emdash/site/src/pages/[...slug].astro +113 -0
  369. package/templates/astro-emdash/site/src/pages/_raybase/handoff/consume.ts +6 -0
  370. package/templates/astro-emdash/site/src/pages/_raybase/islands/action.ts +8 -0
  371. package/templates/astro-emdash/site/src/pages/_raybase/sign-out/index.ts +6 -0
  372. package/templates/astro-emdash/site/src/styles/palette-fonts.gen.css +1 -0
  373. package/templates/astro-emdash/site/src/styles/palettes.gen.css +3 -0
  374. package/templates/astro-emdash/site/src/styles.css +607 -0
  375. package/templates/astro-emdash/site/tsconfig.json +12 -0
  376. package/templates/astro-emdash/site/wrangler.jsonc +34 -0
  377. package/templates/astro-emdash/source.config.ts +10 -0
  378. package/templates/astro-emdash/src/actions.ts +58 -0
  379. package/templates/astro-emdash/src/ai/agents.ts +20 -0
  380. package/templates/astro-emdash/src/ai/retrieval.ts +36 -0
  381. package/templates/astro-emdash/src/auth-door.ts +18 -0
  382. package/templates/astro-emdash/src/client.tsx +25 -0
  383. package/templates/astro-emdash/src/components/.gitkeep +1 -0
  384. package/templates/astro-emdash/src/components/account-menu.tsx +91 -0
  385. package/templates/astro-emdash/src/components/auth-shell.tsx +69 -0
  386. package/templates/astro-emdash/src/components/mode-toggle.tsx +32 -0
  387. package/templates/astro-emdash/src/components/search-command-palette.tsx +107 -0
  388. package/templates/astro-emdash/src/components/setup-token-page.tsx +196 -0
  389. package/templates/astro-emdash/src/components/ui/avatar.tsx +107 -0
  390. package/templates/astro-emdash/src/components/ui/badge.tsx +52 -0
  391. package/templates/astro-emdash/src/components/ui/button.tsx +69 -0
  392. package/templates/astro-emdash/src/components/ui/checkbox.tsx +29 -0
  393. package/templates/astro-emdash/src/components/ui/dialog.tsx +158 -0
  394. package/templates/astro-emdash/src/components/ui/dropdown-menu.tsx +303 -0
  395. package/templates/astro-emdash/src/components/ui/input.tsx +20 -0
  396. package/templates/astro-emdash/src/components/ui/label.tsx +20 -0
  397. package/templates/astro-emdash/src/components/ui/scroll-area.tsx +53 -0
  398. package/templates/astro-emdash/src/components/ui/select.tsx +215 -0
  399. package/templates/astro-emdash/src/components/ui/separator.tsx +23 -0
  400. package/templates/astro-emdash/src/components/ui/sheet.tsx +138 -0
  401. package/templates/astro-emdash/src/components/ui/sidebar.tsx +728 -0
  402. package/templates/astro-emdash/src/components/ui/skeleton.tsx +13 -0
  403. package/templates/astro-emdash/src/components/ui/textarea.tsx +18 -0
  404. package/templates/astro-emdash/src/components/ui/tooltip.tsx +66 -0
  405. package/templates/astro-emdash/src/db/migrations.gen.ts +6 -0
  406. package/templates/astro-emdash/src/db/schema.ts +6 -0
  407. package/templates/astro-emdash/src/db/seed.ts +16 -0
  408. package/templates/astro-emdash/src/db/storage.ts +32 -0
  409. package/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
  410. package/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
  411. package/templates/astro-emdash/src/docs/docs-data.ts +24 -0
  412. package/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
  413. package/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
  414. package/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
  415. package/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
  416. package/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
  417. package/templates/astro-emdash/src/docs/llm-text.ts +61 -0
  418. package/templates/astro-emdash/src/docs/source.ts +7 -0
  419. package/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
  420. package/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
  421. package/templates/astro-emdash/src/hooks/use-mobile.ts +19 -0
  422. package/templates/astro-emdash/src/jobs.example.ts +48 -0
  423. package/templates/astro-emdash/src/lib/account.ts +12 -0
  424. package/templates/astro-emdash/src/lib/auth-client.ts +181 -0
  425. package/templates/astro-emdash/src/lib/utils.ts +6 -0
  426. package/templates/astro-emdash/src/mcp-app.ts +57 -0
  427. package/templates/astro-emdash/src/notifications.example.ts +37 -0
  428. package/templates/astro-emdash/src/raybase.auth.ts +70 -0
  429. package/templates/astro-emdash/src/raybase.config.ts +49 -0
  430. package/templates/astro-emdash/src/raybase.server.ts +56 -0
  431. package/templates/astro-emdash/src/realtime.example.ts +18 -0
  432. package/templates/astro-emdash/src/router.tsx +19 -0
  433. package/templates/astro-emdash/src/routes/__root.tsx +56 -0
  434. package/templates/astro-emdash/src/routes/_app/admin.tsx +13 -0
  435. package/templates/astro-emdash/src/routes/_app/forgot-password.tsx +97 -0
  436. package/templates/astro-emdash/src/routes/_app/index.tsx +169 -0
  437. package/templates/astro-emdash/src/routes/_app/invite.$token.tsx +11 -0
  438. package/templates/astro-emdash/src/routes/_app/login.tsx +193 -0
  439. package/templates/astro-emdash/src/routes/_app/profile.tsx +98 -0
  440. package/templates/astro-emdash/src/routes/_app/reset-password.$token.tsx +15 -0
  441. package/templates/astro-emdash/src/routes/_app/reset-password.tsx +115 -0
  442. package/templates/astro-emdash/src/routes/_app/setup.$token.tsx +11 -0
  443. package/templates/astro-emdash/src/routes/_app/signup.tsx +141 -0
  444. package/templates/astro-emdash/src/routes/_app/verify-email.$token.tsx +15 -0
  445. package/templates/astro-emdash/src/routes/_app/verify-email.tsx +154 -0
  446. package/templates/astro-emdash/src/routes/_app.tsx +33 -0
  447. package/templates/astro-emdash/src/routes/admin/$.ts +20 -0
  448. package/templates/astro-emdash/src/routes/api/$.ts +19 -0
  449. package/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
  450. package/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
  451. package/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
  452. package/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
  453. package/templates/astro-emdash/src/routes/docs.tsx +22 -0
  454. package/templates/astro-emdash/src/search.ts +6 -0
  455. package/templates/astro-emdash/src/settings.ts +12 -0
  456. package/templates/astro-emdash/src/styles-docs.css +3 -0
  457. package/templates/astro-emdash/src/styles.css +101 -0
  458. package/templates/astro-emdash/src/themes/base.css +76 -0
  459. package/templates/astro-emdash/src/themes/carbon.css +76 -0
  460. package/templates/astro-emdash/src/themes/fonts.css +25 -0
  461. package/templates/astro-emdash/src/themes/sage.css +76 -0
  462. package/templates/astro-emdash/src/themes/sand.css +76 -0
  463. package/templates/astro-emdash/src/themes/slate.css +81 -0
  464. package/templates/astro-emdash/src/themes/ultra.css +76 -0
  465. package/templates/astro-emdash/src/themes/zen.css +76 -0
  466. package/templates/astro-emdash/src/worker-entry.ts +31 -0
  467. package/templates/astro-emdash/tests/raybase-patterns.test.ts +29 -0
  468. package/templates/astro-emdash/tsconfig.json +36 -0
  469. package/templates/astro-emdash/vite.config.ts +130 -0
  470. package/templates/astro-emdash/vitest.config.ts +8 -0
  471. package/templates/astro-emdash/wrangler.jsonc +112 -0
  472. package/templates/react-router/.dev.vars.example +5 -0
  473. package/templates/react-router/.editorconfig +15 -0
  474. package/templates/react-router/AGENTS.md +54 -0
  475. package/templates/react-router/README.md +52 -0
  476. package/templates/react-router/app/app.css +44 -0
  477. package/templates/react-router/app/components/mdx.tsx +79 -0
  478. package/templates/react-router/app/components/ui/button.tsx +45 -0
  479. package/templates/react-router/app/components/ui/card.tsx +87 -0
  480. package/templates/react-router/app/components/ui/separator.tsx +22 -0
  481. package/templates/react-router/app/db/migrations.gen.ts +6 -0
  482. package/templates/react-router/app/db/schema.ts +56 -0
  483. package/templates/react-router/app/db/seed.ts +14 -0
  484. package/templates/react-router/app/entry.server.tsx +41 -0
  485. package/templates/react-router/app/globals.d.ts +1 -0
  486. package/templates/react-router/app/lib/layout.shared.tsx +52 -0
  487. package/templates/react-router/app/lib/source.ts +7 -0
  488. package/templates/react-router/app/lib/utils.ts +6 -0
  489. package/templates/react-router/app/raybase.server.ts +65 -0
  490. package/templates/react-router/app/root.tsx +23 -0
  491. package/templates/react-router/app/routes/_index.tsx +53 -0
  492. package/templates/react-router/app/routes/docs.$.tsx +49 -0
  493. package/templates/react-router/app/routes/docs.api.search.ts +10 -0
  494. package/templates/react-router/app/routes/docs.tsx +13 -0
  495. package/templates/react-router/app/routes.ts +3 -0
  496. package/templates/react-router/components.json +22 -0
  497. package/templates/react-router/content/docs/getting-started.mdx +15 -0
  498. package/templates/react-router/content/docs/index.mdx +8 -0
  499. package/templates/react-router/content/docs/mcp.mdx +121 -0
  500. package/templates/react-router/content/docs/meta.json +4 -0
  501. package/templates/react-router/dev/CODEBASE-MAP.md +48 -0
  502. package/templates/react-router/dev/SPEC-OVERVIEW.md +35 -0
  503. package/templates/react-router/dev/SPEC.md +93 -0
  504. package/templates/react-router/dev/features/archive/.gitkeep +1 -0
  505. package/templates/react-router/drizzle.config.ts +5 -0
  506. package/templates/react-router/env.d.ts +53 -0
  507. package/templates/react-router/gitignore +23 -0
  508. package/templates/react-router/migrations/app/meta/_journal.json +1 -0
  509. package/templates/react-router/package.json +70 -0
  510. package/templates/react-router/public/_headers +4 -0
  511. package/templates/react-router/public/favicon.ico +0 -0
  512. package/templates/react-router/react-router.config.ts +9 -0
  513. package/templates/react-router/source.config.ts +5 -0
  514. package/templates/react-router/tests/raybase-patterns.test.ts +23 -0
  515. package/templates/react-router/tsconfig.json +27 -0
  516. package/templates/react-router/vite.config.ts +59 -0
  517. package/templates/react-router/vitest.config.ts +8 -0
  518. package/templates/react-router/workers/app.ts +40 -0
  519. package/templates/react-router/wrangler.jsonc +111 -0
  520. package/templates/tanstack-start/.dev.vars.example +5 -0
  521. package/templates/tanstack-start/AGENTS.md +95 -0
  522. package/templates/tanstack-start/DESIGN.md +65 -0
  523. package/templates/tanstack-start/components.json +21 -0
  524. package/templates/tanstack-start/content/docs/getting-started.mdx +65 -0
  525. package/templates/tanstack-start/content/docs/index.mdx +10 -0
  526. package/templates/tanstack-start/content/docs/mcp.mdx +122 -0
  527. package/templates/tanstack-start/content/docs/meta.json +4 -0
  528. package/templates/tanstack-start/dev/CODEBASE-MAP.md +84 -0
  529. package/templates/tanstack-start/dev/SPEC-OVERVIEW.md +46 -0
  530. package/templates/tanstack-start/dev/SPEC.md +213 -0
  531. package/templates/tanstack-start/dev/features/archive/.gitkeep +1 -0
  532. package/templates/tanstack-start/docs/theme-previews/base.svg +24 -0
  533. package/templates/tanstack-start/docs/theme-previews/steel.svg +24 -0
  534. package/templates/tanstack-start/docs/theme-previews/zen.svg +24 -0
  535. package/templates/tanstack-start/docs/themes.md +116 -0
  536. package/templates/tanstack-start/drizzle.config.ts +5 -0
  537. package/templates/tanstack-start/gitignore +11 -0
  538. package/templates/tanstack-start/migrations/app/0000_low_karen_page.sql +26 -0
  539. package/templates/tanstack-start/migrations/app/meta/0000_snapshot.json +196 -0
  540. package/templates/tanstack-start/migrations/app/meta/_journal.json +13 -0
  541. package/templates/tanstack-start/package.json +77 -0
  542. package/templates/tanstack-start/public/_headers +8 -0
  543. package/templates/tanstack-start/public/icons/app-icon-maskable.svg +1 -0
  544. package/templates/tanstack-start/public/icons/app-icon.svg +1 -0
  545. package/templates/tanstack-start/public/icons/apple-touch-icon.png +0 -0
  546. package/templates/tanstack-start/public/manifest.webmanifest +14 -0
  547. package/templates/tanstack-start/public/raybase-push-sw.js +32 -0
  548. package/templates/tanstack-start/source.config.ts +10 -0
  549. package/templates/tanstack-start/src/actions.ts +560 -0
  550. package/templates/tanstack-start/src/ai/agents.ts +78 -0
  551. package/templates/tanstack-start/src/ai/retrieval.ts +36 -0
  552. package/templates/tanstack-start/src/auth-door.ts +18 -0
  553. package/templates/tanstack-start/src/client.tsx +25 -0
  554. package/templates/tanstack-start/src/components/.gitkeep +1 -0
  555. package/templates/tanstack-start/src/components/account-menu.tsx +127 -0
  556. package/templates/tanstack-start/src/components/auth-shell.tsx +69 -0
  557. package/templates/tanstack-start/src/components/install-app.tsx +35 -0
  558. package/templates/tanstack-start/src/components/mode-toggle.tsx +32 -0
  559. package/templates/tanstack-start/src/components/search-command-palette.tsx +107 -0
  560. package/templates/tanstack-start/src/components/setup-token-page.tsx +197 -0
  561. package/templates/tanstack-start/src/components/ui/avatar.tsx +107 -0
  562. package/templates/tanstack-start/src/components/ui/badge.tsx +52 -0
  563. package/templates/tanstack-start/src/components/ui/button.tsx +69 -0
  564. package/templates/tanstack-start/src/components/ui/checkbox.tsx +29 -0
  565. package/templates/tanstack-start/src/components/ui/dialog.tsx +158 -0
  566. package/templates/tanstack-start/src/components/ui/dropdown-menu.tsx +303 -0
  567. package/templates/tanstack-start/src/components/ui/input.tsx +20 -0
  568. package/templates/tanstack-start/src/components/ui/label.tsx +20 -0
  569. package/templates/tanstack-start/src/components/ui/scroll-area.tsx +53 -0
  570. package/templates/tanstack-start/src/components/ui/select.tsx +215 -0
  571. package/templates/tanstack-start/src/components/ui/separator.tsx +23 -0
  572. package/templates/tanstack-start/src/components/ui/sheet.tsx +138 -0
  573. package/templates/tanstack-start/src/components/ui/sidebar.tsx +728 -0
  574. package/templates/tanstack-start/src/components/ui/skeleton.tsx +13 -0
  575. package/templates/tanstack-start/src/components/ui/textarea.tsx +18 -0
  576. package/templates/tanstack-start/src/components/ui/tooltip.tsx +66 -0
  577. package/templates/tanstack-start/src/db/migrations.gen.ts +6 -0
  578. package/templates/tanstack-start/src/db/schema.ts +90 -0
  579. package/templates/tanstack-start/src/db/seed.ts +106 -0
  580. package/templates/tanstack-start/src/db/storage.ts +32 -0
  581. package/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
  582. package/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
  583. package/templates/tanstack-start/src/docs/docs-data.ts +24 -0
  584. package/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
  585. package/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
  586. package/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
  587. package/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
  588. package/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
  589. package/templates/tanstack-start/src/docs/llm-text.ts +61 -0
  590. package/templates/tanstack-start/src/docs/source.ts +7 -0
  591. package/templates/tanstack-start/src/hooks/use-mobile.ts +19 -0
  592. package/templates/tanstack-start/src/hooks/use-pwa-install.ts +77 -0
  593. package/templates/tanstack-start/src/jobs.example.ts +56 -0
  594. package/templates/tanstack-start/src/lib/account.ts +13 -0
  595. package/templates/tanstack-start/src/lib/auth-client.ts +187 -0
  596. package/templates/tanstack-start/src/lib/push-client.ts +98 -0
  597. package/templates/tanstack-start/src/lib/utils.ts +6 -0
  598. package/templates/tanstack-start/src/mcp-app.ts +74 -0
  599. package/templates/tanstack-start/src/notifications.example.ts +37 -0
  600. package/templates/tanstack-start/src/raybase.auth.ts +86 -0
  601. package/templates/tanstack-start/src/raybase.config.ts +86 -0
  602. package/templates/tanstack-start/src/raybase.server.ts +155 -0
  603. package/templates/tanstack-start/src/realtime.example.ts +46 -0
  604. package/templates/tanstack-start/src/router.tsx +19 -0
  605. package/templates/tanstack-start/src/routes/__root.tsx +73 -0
  606. package/templates/tanstack-start/src/routes/_app/admin.tsx +13 -0
  607. package/templates/tanstack-start/src/routes/_app/forgot-password.tsx +97 -0
  608. package/templates/tanstack-start/src/routes/_app/index.tsx +1316 -0
  609. package/templates/tanstack-start/src/routes/_app/invite.$token.tsx +11 -0
  610. package/templates/tanstack-start/src/routes/_app/login.tsx +193 -0
  611. package/templates/tanstack-start/src/routes/_app/profile.tsx +98 -0
  612. package/templates/tanstack-start/src/routes/_app/reset-password.$token.tsx +16 -0
  613. package/templates/tanstack-start/src/routes/_app/reset-password.tsx +115 -0
  614. package/templates/tanstack-start/src/routes/_app/setup.$token.tsx +11 -0
  615. package/templates/tanstack-start/src/routes/_app/signup.tsx +141 -0
  616. package/templates/tanstack-start/src/routes/_app/verify-email.$token.tsx +15 -0
  617. package/templates/tanstack-start/src/routes/_app/verify-email.tsx +154 -0
  618. package/templates/tanstack-start/src/routes/_app.tsx +33 -0
  619. package/templates/tanstack-start/src/routes/admin/$.ts +20 -0
  620. package/templates/tanstack-start/src/routes/api/$.ts +19 -0
  621. package/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
  622. package/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
  623. package/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
  624. package/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
  625. package/templates/tanstack-start/src/routes/docs.tsx +22 -0
  626. package/templates/tanstack-start/src/search.ts +26 -0
  627. package/templates/tanstack-start/src/settings.ts +12 -0
  628. package/templates/tanstack-start/src/styles-docs.css +3 -0
  629. package/templates/tanstack-start/src/styles.css +73 -0
  630. package/templates/tanstack-start/src/themes/base.css +76 -0
  631. package/templates/tanstack-start/src/themes/carbon.css +76 -0
  632. package/templates/tanstack-start/src/themes/fonts.css +18 -0
  633. package/templates/tanstack-start/src/themes/sage.css +76 -0
  634. package/templates/tanstack-start/src/themes/sand.css +76 -0
  635. package/templates/tanstack-start/src/themes/slate.css +76 -0
  636. package/templates/tanstack-start/src/themes/ultra.css +76 -0
  637. package/templates/tanstack-start/src/themes/zen.css +76 -0
  638. package/templates/tanstack-start/src/worker-entry.ts +30 -0
  639. package/templates/tanstack-start/tests/raybase-patterns.test.ts +247 -0
  640. package/templates/tanstack-start/tsconfig.json +33 -0
  641. package/templates/tanstack-start/vite.config.ts +132 -0
  642. package/templates/tanstack-start/vitest.config.ts +8 -0
  643. package/templates/tanstack-start/wrangler.jsonc +112 -0
  644. package/README.md +0 -3
@@ -0,0 +1,265 @@
1
+ # EmDash Collections Reference (vendored)
2
+
3
+ Trimmed from EmDash's own site-building skill for use inside Raybase Sites.
4
+ Verified against EmDash 0.23 (the version pinned in
5
+ `site/package.json`). When the pinned EmDash version moves, re-check this
6
+ file against the EmDash docs (`https://docs.emdashcms.com`) before trusting
7
+ details here over observed behaviour.
8
+
9
+ In an astro-emdash app the EmDash site lives in `site/`; run every `emdash`
10
+ CLI command from there, for example `pnpm --dir site exec emdash schema list`.
11
+ Some localhost dev flows can use the EmDash dev bypass, but Raybase-auth
12
+ scaffolds or built Wrangler previews may require an authenticated CLI token.
13
+
14
+ ## Seed File Structure
15
+
16
+ `site/seed/seed.json` defines schema plus optional starter content:
17
+
18
+ ```json
19
+ {
20
+ "$schema": "https://emdashcms.com/seed.schema.json",
21
+ "version": "1",
22
+ "meta": { "name": "...", "description": "...", "author": "..." },
23
+ "settings": { "title": "...", "tagline": "..." },
24
+ "collections": [ ... ],
25
+ "taxonomies": [ ... ],
26
+ "menus": [ ... ],
27
+ "content": { ... }
28
+ }
29
+ ```
30
+
31
+ It is applied automatically on the first request when the content database is
32
+ empty; existing data is never overwritten. Validation runs at apply time - an
33
+ invalid seed fails the first request and logs the error; fix and restart the
34
+ dev server.
35
+
36
+ ## Collections
37
+
38
+ ```json
39
+ {
40
+ "slug": "articles",
41
+ "label": "Articles",
42
+ "labelSingular": "Article",
43
+ "urlPattern": "/articles/{slug}",
44
+ "supports": ["drafts", "revisions", "search", "seo"],
45
+ "fields": [ ... ]
46
+ }
47
+ ```
48
+
49
+ - Slugs are lowercase alphanumeric plus underscores (`/^[a-z][a-z0-9_]*$/`),
50
+ max 63 characters.
51
+ - `supports`: `drafts` (draft/published workflow), `revisions` (history),
52
+ `search` (full-text indexing), `seo` (meta fields in admin).
53
+ - `urlPattern` gives entries public URLs. In this starter the public catch-all
54
+ resolves matching paths and renders `title` / `description` / `content` /
55
+ `design`; omit `urlPattern` for collections that only feed section
56
+ `dataSources`.
57
+
58
+ ## Field Types
59
+
60
+ | Type | Runtime shape | Notes |
61
+ | -------------- | ------------------------------------- | ---------------------------- |
62
+ | `string` | `string` | Single line |
63
+ | `text` | `string` | Multi-line |
64
+ | `number` | `number` | Floating point |
65
+ | `integer` | `number` | Whole numbers |
66
+ | `boolean` | `boolean` | |
67
+ | `datetime` | `Date` | ISO 8601 in DB |
68
+ | `image` | `{ id, src?, alt?, width?, height? }` | An object, never a string |
69
+ | `reference` | `string` (entry ULID) | Points at another entry |
70
+ | `portableText` | `PortableTextBlock[]` | Rich text as structured JSON |
71
+ | `json` | `any` | Arbitrary JSON |
72
+
73
+ The CLI additionally accepts `select`, `multiSelect`, `file`, `slug`, and
74
+ `url` field types.
75
+
76
+ Field definition:
77
+
78
+ ```json
79
+ { "slug": "title", "label": "Title", "type": "string", "required": true, "searchable": true }
80
+ ```
81
+
82
+ Example page-backing collection field set (matches the shape the public
83
+ route renders):
84
+
85
+ ```json
86
+ "fields": [
87
+ { "slug": "title", "label": "Title", "type": "string", "required": true, "searchable": true },
88
+ { "slug": "description", "label": "Description", "type": "text", "searchable": true },
89
+ { "slug": "content", "label": "Content", "type": "portableText", "searchable": true },
90
+ { "slug": "design", "label": "Design", "type": "json", "widget": "galley:block" }
91
+ ]
92
+ ```
93
+
94
+ Example section-data collection (no `urlPattern`, no `content`):
95
+
96
+ ```json
97
+ "fields": [
98
+ { "slug": "quote", "label": "Quote", "type": "text", "required": true },
99
+ { "slug": "attribution", "label": "Attribution", "type": "string" },
100
+ { "slug": "portrait", "label": "Portrait", "type": "image" }
101
+ ]
102
+ ```
103
+
104
+ ## Taxonomies And Menus
105
+
106
+ ```json
107
+ {
108
+ "name": "category",
109
+ "label": "Categories",
110
+ "labelSingular": "Category",
111
+ "hierarchical": true,
112
+ "collections": ["articles"],
113
+ "terms": [{ "slug": "guides", "label": "Guides" }]
114
+ }
115
+ ```
116
+
117
+ Query names must match the seed's `name` exactly (`"category"`, not
118
+ `"categories"`); a wrong name returns empty results with no error.
119
+
120
+ ```json
121
+ {
122
+ "name": "primary",
123
+ "label": "Primary Navigation",
124
+ "items": [{ "type": "custom", "label": "Home", "url": "/" }]
125
+ }
126
+ ```
127
+
128
+ ## Seed Content
129
+
130
+ Sample rows are organized by collection slug under `content`:
131
+
132
+ ```json
133
+ "content": {
134
+ "articles": [
135
+ {
136
+ "id": "article-1",
137
+ "slug": "hello-world",
138
+ "status": "published",
139
+ "data": {
140
+ "title": "Hello World",
141
+ "content": [
142
+ {
143
+ "_type": "block",
144
+ "_key": "a1-intro",
145
+ "style": "normal",
146
+ "markDefs": [],
147
+ "children": [
148
+ { "_type": "span", "_key": "a1-intro-text", "text": "Body text.", "marks": [] }
149
+ ]
150
+ }
151
+ ]
152
+ },
153
+ "taxonomies": { "category": ["guides"] }
154
+ }
155
+ ]
156
+ }
157
+ ```
158
+
159
+ - Give every Portable Text block and span a stable `_key` (Raybase rule:
160
+ Galley edit context depends on stable keys; upstream EmDash examples omit
161
+ them, this starter must not).
162
+ - Image fields use `$media` so EmDash downloads and stores the file:
163
+ `"featured_image": { "$media": { "url": "https://...", "alt": "...", "filename": "x.jpg" } }`.
164
+ - Reference fields use `"$ref:<seed-id>"`.
165
+ - `"status": "draft"` seeds unpublished content.
166
+ - Block styles: `normal`, `h1`-`h6`, `blockquote`; inline marks via
167
+ `"marks": ["strong"]` etc.
168
+
169
+ ## Ingesting Owner Assets
170
+
171
+ Use this section for greenfield owner asset intake and for migrated site
172
+ imagery. First get the bytes onto local disk however the host provides them:
173
+ chat attachments, a folder the owner names, or URLs you download. Normalize
174
+ before upload: descriptive kebab-case filenames, oversized originals
175
+ downscaled locally, and raster heroes kept to roughly 300KB where practical.
176
+ Nothing in this starter resizes images for you; EmDash's default direct-upload
177
+ limit is 50MB, but review performance should be much stricter than that.
178
+
179
+ For a fresh app whose content database is still empty, prefer seed `$media`
180
+ when the asset is already hosted:
181
+
182
+ ```json
183
+ "featured_image": {
184
+ "$media": {
185
+ "url": "https://example.com/photo.jpg",
186
+ "alt": "Chef Mina plating saffron risotto at the pass",
187
+ "filename": "chef-mina-risotto.jpg"
188
+ }
189
+ }
190
+ ```
191
+
192
+ EmDash downloads those URLs on first seed apply. If a source URL is blocked,
193
+ private, oversized, or otherwise unreachable, the seed apply continues with a
194
+ warning, the affected media value is skipped, and the image field becomes
195
+ `null`; check the first-request logs. The fallback is to download the file
196
+ locally and upload it with the CLI after the first seed apply.
197
+
198
+ For built Cloudflare/Wrangler local previews, `$media` seed apply may populate
199
+ the media table and download files into `--uploads-dir` without putting those
200
+ bytes into Miniflare's R2 bucket. Verify each
201
+ `/_emdash/api/media/file/{storageKey}` URL. If rows exist but URLs 404, hydrate
202
+ the local R2 state from the upload directory or upload the files through the
203
+ API before signing off on media parity.
204
+
205
+ For local files after the seed has applied, or for any live database, upload
206
+ each asset through the EmDash CLI:
207
+
208
+ ```bash
209
+ pnpm --dir site exec emdash media upload ./chef-mina-risotto.jpg --alt "Chef Mina plating saffron risotto at the pass" --json
210
+ ```
211
+
212
+ Capture the returned media item. In EmDash 0.23 the response includes an
213
+ `id` and a relative `url` like `/_emdash/api/media/file/{storageKey}`. For
214
+ Galley `data-dynamic-src` fields, paste the site-origin-qualified URL
215
+ (`https://site.example/_emdash/api/media/file/{storageKey}` in production, or
216
+ the local dev origin during review). For collection `image` fields, use the
217
+ media object shape the field expects: `{ id, src?, alt?, width?, height? }`.
218
+
219
+ Destination rule: collection `image` fields get media objects; Galley section
220
+ fields get URL strings in `data-dynamic-src` plus authored alt text in
221
+ `data-dynamic-alt`. Alt text is copy, not metadata cleanup: write it in the
222
+ site's voice and never derive it from the filename. Seed `$media` preserves
223
+ `alt`, but in pinned EmDash 0.23 the direct-upload route behind the CLI does
224
+ not persist `--alt`/`--caption` to the media row; after CLI upload, set the
225
+ final alt text on the collection entry or Galley `data-dynamic-alt` field and
226
+ verify it before handoff.
227
+
228
+ ## Live Database Operations (CLI)
229
+
230
+ Once the local content database has real data, change schema and content
231
+ through the CLI or `/_emdash/admin`, not by re-editing the applied seed.
232
+ Create and update auto-publish by default; pass `--draft` to stage instead.
233
+
234
+ ```bash
235
+ # Schema
236
+ pnpm --dir site exec emdash schema list
237
+ pnpm --dir site exec emdash schema get articles
238
+ pnpm --dir site exec emdash schema create articles --label Articles
239
+ pnpm --dir site exec emdash schema add-field articles summary --type text --label "Summary"
240
+
241
+ # Content (update requires --rev from a prior get)
242
+ pnpm --dir site exec emdash content list articles --json
243
+ pnpm --dir site exec emdash content get articles <ulid>
244
+ pnpm --dir site exec emdash content create articles --data '{"title": "Hello"}'
245
+ pnpm --dir site exec emdash content update articles <ulid> --rev <rev> --data '{"title": "Updated"}'
246
+ pnpm --dir site exec emdash content publish articles <ulid>
247
+
248
+ # Taxonomies / media / types
249
+ pnpm --dir site exec emdash taxonomy add-term category --name "Guides" --slug guides
250
+ pnpm --dir site exec emdash media upload ./photo.jpg --alt "A sunset"
251
+ pnpm --dir site exec emdash types
252
+
253
+ # Round-trip a grown database back into a seed
254
+ pnpm --dir site exec emdash export-seed --with-content
255
+ ```
256
+
257
+ ## Gotchas
258
+
259
+ - `entry.id` is the slug (use in URLs); `entry.data.id` is the database ULID
260
+ (use for API calls and reference fields). Mixing them up returns silently
261
+ empty results.
262
+ - Image fields render `[object Object]` if treated as strings; use the
263
+ `Image` component from `emdash/ui` in any bespoke Astro code.
264
+ - All CMS pages are server-rendered; never add `getStaticPaths` for EmDash
265
+ content.
@@ -0,0 +1,60 @@
1
+ Substantial portions of this skill are adapted from Impeccable Design
2
+ (https://impeccable.style/), used under the Apache License, Version 2.0,
3
+ whose text follows. The adapted passages were rewritten for Raybase apps;
4
+ the files that carry them say so where they begin or end.
5
+
6
+ Apache License
7
+
8
+ Version 2.0, January 2004
9
+
10
+ http://www.apache.org/licenses/
11
+
12
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
13
+
14
+ 1. Definitions.
15
+
16
+ "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
17
+
18
+ "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
19
+
20
+ "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
21
+
22
+ "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
23
+
24
+ "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
25
+
26
+ "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
27
+
28
+ "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
29
+
30
+ "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
31
+
32
+ "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
33
+
34
+ "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
35
+
36
+ 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
37
+
38
+ 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
39
+
40
+ 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
41
+
42
+ You must give any other recipients of the Work or Derivative Works a copy of this License; and
43
+
44
+ You must cause any modified files to carry prominent notices stating that You changed the files; and
45
+
46
+ You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
47
+
48
+ If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
49
+
50
+ 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
51
+
52
+ 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
53
+
54
+ 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
55
+
56
+ 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
57
+
58
+ 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
59
+
60
+ END OF TERMS AND CONDITIONS
@@ -0,0 +1,170 @@
1
+ ---
2
+ name: raybase-astro-emdash-design
3
+ description: Design astro-emdash public sites to a distinctive, production bar - derive a design direction from the spec, select and work within a registry theme on the shadcn-semantic-v1 token contract, and craft site typography, color, layout, imagery, motion, and copy. Records durable decisions in DESIGN.md. Read before theme selection and before any durable visual or UX change.
4
+ ---
5
+
6
+ # Raybase Astro/EmDash Design Skill
7
+
8
+ The public site of an `astro-emdash` app is a **brand surface: design IS the
9
+ product**. A visitor's impression is the deliverable. The bar is
10
+ distinctiveness — a visitor should ask "how was this made?", not "which AI
11
+ made this?". AI-generated sites have flooded the internet; restraint without
12
+ intent now reads as mediocre, not refined. The site needs a point of view, a
13
+ specific audience, and a willingness to commit.
14
+
15
+ The Raybase spine is the opposite register: an operator tool that keeps the
16
+ starter's baseline design system (the spine sections of `DESIGN.md`). This
17
+ skill is about the public site; the spine rules at the end keep the lanes
18
+ separate.
19
+
20
+ ## Read Order
21
+
22
+ 1. Read `.agents/skills/raybase-astro-emdash/SKILL.md`.
23
+ 2. Read `dev/SPEC.md` (especially the interview's tone and audience answers) and the `Site plan` section produced by `.agents/skills/raybase-astro-emdash-content-model/SKILL.md`.
24
+ 3. Read `DESIGN.md`; its Public Site section is the durable design memory this skill writes and later work consumes.
25
+ 4. Read `.agents/skills/raybase-astro-emdash-galley/SKILL.md` before implementing section-level changes.
26
+ 5. Read the matching [reference file](#reference-files) before working in its area.
27
+
28
+ ## The Flow
29
+
30
+ 1. **Derive a design direction** from the approved spec ([reference/direction.md](reference/direction.md)) — before searching for a theme. Theme selection consumes a direction; it must not invent one from the first search results.
31
+ 2. **Record it in `DESIGN.md`** before running the theme-selection loop.
32
+ 3. **Select a theme, then a shell** with `.agents/skills/raybase-astro-emdash-theme-selection/SKILL.md`. The theme (voice + vocabulary) and the shell (the IA's frame — nav/footer/layout, chosen by capacity from the site plan's link sets) are separate artifacts; it records both, plus palette and rationale, in the same `DESIGN.md` section.
33
+ 4. **Adapt within the theme**: replace sample copy and imagery with the site's own voice and assets, tune section composition, and make deliberate deviations — recorded with their why.
34
+ 5. **Look at it like a designer.** Browser-verify at mobile and desktop widths (the hub skill's Browser Verification recipe). Critique against the direction and the bans below, patch material defects, re-inspect. Don't invent defects to demonstrate iteration; a confident "first pass clean" beats a fake fix.
35
+
36
+ ## DESIGN.md Is The Design Memory
37
+
38
+ `DESIGN.md` is not documentation ceremony — it is the design system's memory.
39
+ Sessions end and context windows close; the file is what lets the next agent
40
+ (or a runtime agent editing the live site) make on-brand decisions without
41
+ re-deriving them. Keep the Public Site section short and current:
42
+
43
+ - The design direction and its rationale (fields in [reference/direction.md](reference/direction.md)).
44
+ - The selected theme, palette, and tone rationale (written at theme selection).
45
+ - The selected shell (layout id) and its capacity rationale (nav item count, footer grade, IA fit) — written at shell selection.
46
+ - Deliberate deviations from the theme baseline (bespoke sections, palette edits, font swaps, shell nav/footer swaps) and why.
47
+ - The site's 1–2 signature moves, so later edits protect them instead of sanding them off.
48
+
49
+ Update it when a decision changes; never scatter design decisions across
50
+ commit messages or chat instead of this file.
51
+
52
+ ## Work Within The Chosen Theme
53
+
54
+ Once a theme is activated it is the site's design system, not a starting
55
+ suggestion:
56
+
57
+ - The theme constrains the layout shell, nav, footer, section families, and palette. Prefer the theme family's own sections and page starters; add a bespoke section only when the family lacks a needed band (galley skill rules apply).
58
+ - Change the site's look by switching the palette or re-running theme selection, not by scattering CSS overrides across templates.
59
+ - Registry themes expose their installable palettes as `palettes`; `raybase templates info` shows each palette's kind, fonts, and provenance. What `--palette` accepts is the theme's registry list.
60
+ - Ambition still has room: direction-led copy and imagery, section composition and rhythm, a new registry palette or validated Galley `paletteCss` overlay authored to the token contract, and motion presets are all in-theme levers. Use them before considering bespoke CSS.
61
+
62
+ ## Token Contract: shadcn-semantic-v1
63
+
64
+ Registry templates declare `catalog.tokenContract: "shadcn-semantic-v1"`:
65
+ they style only against the shadcn semantic CSS variables, so one palette
66
+ swap restyles every section.
67
+
68
+ - Installed palettes live in `site/src/styles/palettes.gen.css` as `[data-palette="..."]` and `[data-palette="..."].dark` blocks defining `--background`, `--foreground`, `--card`, `--muted`, `--primary`, `--accent`, `--border`, and their companions, plus font (`--app-font-sans/serif/mono/display`) and radius variables. `SiteLayout.astro` applies the active palette as `data-palette` on the site `<html>` from the app database and appends any validated Galley `paletteCss` overlay.
69
+ - Stay on token rails in Galley Liquid and Astro site components: semantic classes and variables only. A hardcoded hex, font family, or radius in section markup breaks every palette except the one it was written against.
70
+ - A new color strategy materializes as a new palette artifact or app-local overlay defining the same semantic variables ([reference/color.md](reference/color.md)); a new typeface materializes through palette font metadata and font variables ([reference/typography.md](reference/typography.md)). Bespoke sections must honor the same contract.
71
+
72
+ ## Hard Rules
73
+
74
+ The floor for every page. The references go deeper.
75
+
76
+ - Body text ≥ 4.5:1 contrast against its background; large text (≥18px, or bold ≥14px) ≥ 3:1. The most common failure is muted gray body text on a tinted near-white — when in doubt, darken the text. Never gray text on a colored background; use a darker shade of the background's own hue or a transparency of the text color.
77
+ - Text over photography always sits on a scrim (gradient overlay such as `bg-gradient-to-t from-card via-card/75 to-card/25`, or a solid panel) — never on the raw image; the content author controls the photo, so legibility cannot depend on it staying dark or quiet. Verify on the rendered page, not the template source: if the scrim's palette-token utilities fail to compile (see `raybase templates doctor`'s token-contract check), the text ships illegible while the markup looks correct.
78
+ - Body line length 65–75ch; body ≥ 16px, fixed (fluid `clamp()` is for headings). Hero heading ceiling: clamp max ≤ 6rem. Display letter-spacing floor: ≥ −0.04em. `text-wrap: balance` on h1–h3, `pretty` on long prose.
79
+ - Vary spacing for rhythm: tight within groups, generous between sections. Cards are the lazy answer; nested cards are always wrong. Flexbox for 1D, Grid for 2D; semantic z-index scale, never 999.
80
+ - One-page sites compress the whole narrative into one scroll, so pacing discipline doubles: sequence bands as an arc (arrive → establish → show the work → answer objections → convert), repeat the CTA at the arc's turns rather than after every band, and give anchored bands sticky-nav clearance (`scroll-mt-*` sized to the shell header). Ten equal-weight bands is a brochure, not an argument.
81
+ - When the brief implies imagery (restaurant, hotel, travel, food, product, portfolio), ship imagery. Zero images is a bug, not restraint ([reference/imagery.md](reference/imagery.md)).
82
+ - Motion is intentional and part of the build. Use the starter's `data-rb-motion` presets; reduced motion is not optional ([reference/motion.md](reference/motion.md)). Never gate content visibility on a scroll-triggered class — a reveal that doesn't fire ships a blank section.
83
+ - Test heading copy at every breakpoint; text that overflows its container is a defect. The viewport is part of the design.
84
+ - Real content at handoff: no placeholder copy, broken image URLs, dead links, or leftover registry sample text. And real means true — never invent stats, testimonials, or credentials the owner didn't supply ([reference/copy.md](reference/copy.md)).
85
+
86
+ ## Absolute Bans
87
+
88
+ Match-and-refuse. About to write one of these? Rewrite the element with
89
+ different structure:
90
+
91
+ - **Side-stripe borders** — `border-left/right` > 1px as a colored accent. Full hairline border, background tint, or nothing.
92
+ - **Gradient text** (`background-clip: text`). Solid color; emphasis via weight or size.
93
+ - **Glassmorphism as default.** Rare and purposeful, or nothing.
94
+ - **The ghost card** — 1px border + wide soft shadow (blur ≥ 16px) on the same element. Pick one.
95
+ - **Over-rounding** — cards top out at 12–16px radius; full-pill is for tags and buttons.
96
+ - **The hero-metric template** — big number, small label, gradient accent — unless it shows real data.
97
+ - **Identical card grids** — same-sized icon + heading + text cards, repeated endlessly.
98
+ - **Tiny uppercase tracked eyebrows or numbered markers (01 · 02 · 03) above every section.** One named kicker can be brand voice; section-grammar repetition is AI scaffolding. Numbers only when the content really is a sequence.
99
+ - **Purple-blue gradients**, `repeating-linear-gradient` stripe backgrounds, and decorative 1px grid-line backgrounds (unless the surface is literally a canvas, map, or blueprint).
100
+ - **Hand-drawn / sketchy SVG illustrations** as fallback art. If you can't render the scene with real assets, ship no illustration.
101
+ - **The cream/sand/beige default body.** The warm near-white band (OKLCH L 0.84–0.97, C < 0.06, hue 40–100) is the saturated AI default; "warm" briefs are carried by accent, typography, and imagery, not a parchment background.
102
+ - **Monospace as costume** for "technical", **editorial-magazine styling by default** (display serif + italic + drop caps on briefs that aren't magazine-shaped), **all-caps body copy**.
103
+
104
+ ## The Slop Test
105
+
106
+ If someone could look at the site and say "AI made that" without doubt, it
107
+ has failed. Two altitudes:
108
+
109
+ - **First-order**: if the theme + palette are guessable from the category alone ("Italian restaurant → cream and terracotta", "fintech → navy"), it's the first training-data reflex. Rework the direction until the answer isn't obvious from the domain.
110
+ - **Second-order**: if the aesthetic family is guessable from category-plus-anti-reference ("dev tool that's not SaaS-cream → editorial serif + mono labels"), it's the trap one tier deeper. Rework until both answers are non-obvious.
111
+
112
+ ## Brand Permissions
113
+
114
+ Things a content site can afford that app UI can't — use them when the
115
+ direction invites them:
116
+
117
+ - **Ambitious entrance motion.** One well-orchestrated page load or hero reveal beats scattered micro-interactions. Some brands skip entrance motion entirely; that restraint is also a voice.
118
+ - **Single-purpose viewports.** One dominant idea per fold, long scroll, deliberate pacing.
119
+ - **Committed color.** A saturated color carrying most of a surface is voice, not excess, when the chosen strategy calls for it.
120
+ - **Art direction per section** when the narrative demands it. Consistency of voice beats consistency of treatment.
121
+
122
+ ## Public Site Lanes
123
+
124
+ - Design the public site as a content experience, not as a Raybase admin screen.
125
+ - Put public route/layout shell styling in `site/src/styles.css`. Ordinary public page sections are Galley templates, not new Astro block components (galley skill rules).
126
+ - Keep `site/src/components/blocks/RaybaseActionIsland.astro` focused on the Raybase Server Island exception. Island controls show their remote state and errors without exposing internal tokens or URLs; any public action control calls a named, allow-listed action only.
127
+ - Public pages should render useful fallback content before EmDash setup, but edited content comes from EmDash.
128
+ - Content-editor handoff is a clear command that mints a short-lived token and opens the EmDash admin.
129
+
130
+ ## Raybase Spine
131
+
132
+ - The spine UI is an operator surface: quiet, dense enough to scan, focused on handoff, status, docs, and operational controls. It keeps the starter's baseline design system (the spine sections of `DESIGN.md`); the selected site theme styles the public site only.
133
+ - The spine auth door is part of the design pass. Its copy starts in the app-owned `src/auth-door.ts`, and its look lives in `src/components/auth-shell.tsx`; edit or replace that shell freely while Raybase config continues to own auth routes and behavior.
134
+ - Do not put public marketing pages in the Raybase route graph, and do not let the site's brand voice leak into spine chrome.
135
+ - Do not add app-owned persona switchers or custom auth behavior; local persona switching on the public site is the generated `/_raybase/dev/session` content-door route (hub skill).
136
+
137
+ ## Verification
138
+
139
+ Drive the hub skill's Browser Verification recipe yourself before handoff.
140
+ Design-specific checks at mobile and desktop widths:
141
+
142
+ - Header links do not overlap; hero and section text stays inside its container at 320px, 768px, and desktop.
143
+ - Every page in the site plan renders real content — no sample copy, no
144
+ broken images, no empty data rails, and every asset-inventory slot renders
145
+ either an owner asset or a named stock stand-in.
146
+ - Fonts load without layout shift; images have stable dimensions; Server Island output wraps long JSON.
147
+ - The [reference/polish.md](reference/polish.md) checklist passes.
148
+
149
+ ## Reference Files
150
+
151
+ Read the relevant file before working in its area — they hold the depth this
152
+ file deliberately omits:
153
+
154
+ | File | Read when |
155
+ |---|---|
156
+ | [reference/direction.md](reference/direction.md) | deriving or revising the design direction; writing the DESIGN.md record |
157
+ | [reference/typography.md](reference/typography.md) | choosing or swapping fonts, building heading scales, fixing hierarchy or readability |
158
+ | [reference/color.md](reference/color.md) | picking a color strategy, authoring a `[data-palette]` palette, contrast questions |
159
+ | [reference/layout.md](reference/layout.md) | page rhythm, section composition, hierarchy, responsive behavior |
160
+ | [reference/imagery.md](reference/imagery.md) | sourcing, placing, or optimizing photos, illustrations, and media |
161
+ | [reference/motion.md](reference/motion.md) | adding any animation — presets, timing, easing, reduced motion |
162
+ | [reference/copy.md](reference/copy.md) | replacing sample copy, writing headlines, CTAs, microcopy, alt text |
163
+ | [reference/polish.md](reference/polish.md) | the final pass before handoff — hardening, states, performance, the checklist |
164
+
165
+ ## Credits
166
+
167
+ Substantial portions of this skill are adapted from
168
+ [Impeccable Design](https://impeccable.style/), used under the Apache License
169
+ 2.0. If you want the full system — live browser iteration, critique scoring,
170
+ detector rules, slash commands — use Impeccable directly.
@@ -0,0 +1,91 @@
1
+ # Color
2
+
3
+ On a brand surface, palette IS voice. A calm brand and a restless brand
4
+ should not share palette mechanics, and a beige-and-muted-slate page ignores
5
+ the register. The color strategy comes from the direction
6
+ ([direction.md](direction.md)); this file is how to execute it on the
7
+ starter's token rails.
8
+
9
+ ## How color works in this starter
10
+
11
+ - The site's installed palettes live in `site/src/styles/palettes.gen.css` as `[data-palette="..."]` and `[data-palette="..."].dark` blocks defining the shadcn semantic variables: `--background`, `--foreground`, `--card`, `--muted`, `--muted-foreground`, `--primary`, `--secondary`, `--accent`, `--border`, `--input`, `--ring`, and companions, plus `--radius` and the font variables. `SiteLayout.astro` applies the active theme as `data-palette` on `<html>` from the app database.
12
+ - `site/src/styles.css` owns only starter defaults and layout/component CSS. Do not put durable palette choices there unless you are changing the fallback defaults.
13
+ - **Switching look = switching palette**, via theme selection (`--palette` accepts the keys the theme's registry entry lists) - not scattering overrides across templates.
14
+ - **A new strategy = a new registry palette or Galley overlay** defining the same semantic variables. For reusable packages, add a standard or signature palette artifact; for app-local work, edit the generated palette file or use a validated Galley `paletteCss` overlay. Record it in `DESIGN.md` as a deviation with its why.
15
+ - Sections style against semantic classes and variables only. One hardcoded hex in a Liquid template breaks every palette except the one it was written against.
16
+
17
+ ## Execute the chosen strategy
18
+
19
+ - **Restrained**: tinted neutrals do 90% of the work; one accent ≤10% of visual weight, reserved for primary actions, links, and emphasis. The 60-30-10 weighting applies here — and only here.
20
+ - **Committed**: one saturated color carries 30–60% of the surface (a drenched hero band, a colored nav, full-bleed section backgrounds). Don't hedge with neutrals around the edges; commit.
21
+ - **Full palette**: 3–4 named roles, each used deliberately and consistently — never rainbow application.
22
+ - **Drenched**: the surface IS the color; text and accents are tints and inks of it.
23
+
24
+ Name a real reference before picking values ("Klim #ff4500 orange drench",
25
+ "Vercel pure black monochrome"). When a cultural-symbol palette is the
26
+ obvious pull (Italian flag greens, national colors), reach past it — let the
27
+ cultural reading come from typography, imagery, and copy.
28
+
29
+ ## Use OKLCH
30
+
31
+ The starter's palettes are OKLCH; stay in it. `oklch(L C H)` is perceptually
32
+ uniform — equal lightness steps *look* equal. Build ramps by holding chroma +
33
+ hue and varying lightness; **reduce chroma near white and black** (high
34
+ chroma at extreme lightness looks garish).
35
+
36
+ - **Tinted neutrals**: pure gray is dead next to a colored brand. Add 0.005–0.015 chroma toward *this site's own hue* to neutrals — cohesive without reading as "tinted". Never tint warm or cool by formula; that's the cross-project monoculture move.
37
+ - **The cream ban**: the warm near-white band (L 0.84–0.97, C < 0.06, hue 40–100) is the saturated AI default body background — token names like `--paper`, `--sand`, `--linen` are tells in themselves. "Warm, traditional, editorial" briefs are carried by accent + typography + imagery; the body is either a true off-white at the brand's own hue (or chroma 0), a saturated brand color, or a darker mid-tone that's clearly the brand's own.
38
+ - The hue is a brand decision, not a default: not blue-250 or warm-60 by reflex.
39
+
40
+ ## Contrast
41
+
42
+ | Content | AA minimum |
43
+ |---------|------------|
44
+ | Body text (and placeholders) | 4.5:1 |
45
+ | Large text (≥18px, or bold ≥14px) | 3:1 |
46
+ | UI components, icons, focus rings | 3:1 |
47
+
48
+ - The #1 failure: light gray body text on near-white "for elegance". If it's even close, move toward the ink end.
49
+ - Gray text on a colored background looks washed out — use a darker shade of the background's own hue, or a transparency of the text color.
50
+ - Thin light text over photos has unpredictable contrast: add a scrim, a solid band, or move the text.
51
+ - Verify with a checker or DevTools, not your eyes. Test every `[data-palette]` the site exposes, including generated palettes and any live Galley overlay, and never rely on color alone for meaning (8% of men can't separate red/green).
52
+
53
+ ## Dark palettes
54
+
55
+ A dark site (the scene sentence decides — see [direction.md](direction.md))
56
+ is not inverted light:
57
+
58
+ - Depth from lighter surfaces, not shadows: a 3-step surface ramp (~15% / 20% / 25% L) at the brand's own hue and low chroma.
59
+ - Body background: pure black or a brand-tinted near-black (oklch 12–18% L).
60
+ - Desaturate accents slightly; drop body weight a notch; see the light-on-dark compensation in [typography.md](typography.md).
61
+
62
+ ### Single-scheme palettes and mode toggles
63
+
64
+ Every palette declares a color scheme: `"light dark"` (both modes), `"dark"`,
65
+ or `"light"`. The generated `site/src/lib/palettes.gen.ts` exports
66
+ `PALETTE_SCHEMES`, and single-scheme blocks in `palettes.gen.css` carry a
67
+ banner comment. A `"dark"` palette (e.g. the standard `noir`) is dark in both
68
+ OS modes by design — its tokens live in the base `[data-palette]` block, it
69
+ declares `color-scheme: dark` for native form controls, and it ships no
70
+ `.dark` override block. **Do not build a light/dark mode toggle while a
71
+ single-scheme palette is active**; there is no second mode to switch to. If
72
+ the site offers a toggle, gate it on
73
+ `PALETTE_SCHEMES[activePalette] === "light dark"`.
74
+
75
+ ## Alpha is a design smell
76
+
77
+ Heavy rgba/transparency usually means an incomplete palette — unpredictable
78
+ contrast and inconsistency. Define explicit overlay and hover values in the
79
+ palette block. Exceptions: focus rings, scrims over imagery, momentary
80
+ interactive states.
81
+
82
+ ## Never
83
+
84
+ - Hardcoded hex/oklch values, font families, or radii in section markup.
85
+ - Gray text on colored backgrounds; color as the only state indicator.
86
+ - Purple-blue gradients; default cream/sand bodies; palettes converging across projects.
87
+ - Editing a shared stock palette in place for a new direction - author a new signature palette or app-local overlay and record it.
88
+
89
+ ---
90
+
91
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).