@raybase/create 0.0.2 → 0.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (644) hide show
  1. package/LICENSE +21 -0
  2. package/THIRD_PARTY_NOTICES.md +38 -0
  3. package/assets/apple-touch-icons/0.png +0 -0
  4. package/assets/apple-touch-icons/1.png +0 -0
  5. package/assets/apple-touch-icons/2.png +0 -0
  6. package/assets/apple-touch-icons/3.png +0 -0
  7. package/assets/apple-touch-icons/4.png +0 -0
  8. package/assets/apple-touch-icons/5.png +0 -0
  9. package/assets/apple-touch-icons/6.png +0 -0
  10. package/assets/apple-touch-icons/7.png +0 -0
  11. package/assets/apple-touch-icons/8.png +0 -0
  12. package/assets/apple-touch-icons/9.png +0 -0
  13. package/assets/apple-touch-icons/A.png +0 -0
  14. package/assets/apple-touch-icons/B.png +0 -0
  15. package/assets/apple-touch-icons/C.png +0 -0
  16. package/assets/apple-touch-icons/D.png +0 -0
  17. package/assets/apple-touch-icons/E.png +0 -0
  18. package/assets/apple-touch-icons/F.png +0 -0
  19. package/assets/apple-touch-icons/G.png +0 -0
  20. package/assets/apple-touch-icons/H.png +0 -0
  21. package/assets/apple-touch-icons/I.png +0 -0
  22. package/assets/apple-touch-icons/J.png +0 -0
  23. package/assets/apple-touch-icons/K.png +0 -0
  24. package/assets/apple-touch-icons/L.png +0 -0
  25. package/assets/apple-touch-icons/M.png +0 -0
  26. package/assets/apple-touch-icons/N.png +0 -0
  27. package/assets/apple-touch-icons/O.png +0 -0
  28. package/assets/apple-touch-icons/P.png +0 -0
  29. package/assets/apple-touch-icons/Q.png +0 -0
  30. package/assets/apple-touch-icons/R.png +0 -0
  31. package/assets/apple-touch-icons/S.png +0 -0
  32. package/assets/apple-touch-icons/T.png +0 -0
  33. package/assets/apple-touch-icons/U.png +0 -0
  34. package/assets/apple-touch-icons/V.png +0 -0
  35. package/assets/apple-touch-icons/W.png +0 -0
  36. package/assets/apple-touch-icons/X.png +0 -0
  37. package/assets/apple-touch-icons/Y.png +0 -0
  38. package/assets/apple-touch-icons/Z.png +0 -0
  39. package/assets/apple-touch-icons/default.png +0 -0
  40. package/dist/.source-hash +1 -0
  41. package/dist/index.d.ts +56 -0
  42. package/dist/index.d.ts.map +1 -0
  43. package/dist/index.js +2353 -0
  44. package/dist/index.js.map +1 -0
  45. package/dist/raybase-package-ranges.d.ts +11 -0
  46. package/dist/raybase-package-ranges.d.ts.map +1 -0
  47. package/dist/raybase-package-ranges.js +11 -0
  48. package/dist/raybase-package-ranges.js.map +1 -0
  49. package/dist/source-fetch.d.ts +91 -0
  50. package/dist/source-fetch.d.ts.map +1 -0
  51. package/dist/source-fetch.js +325 -0
  52. package/dist/source-fetch.js.map +1 -0
  53. package/dist/source-hash.d.ts +2 -0
  54. package/dist/source-hash.d.ts.map +1 -0
  55. package/dist/source-hash.js +23 -0
  56. package/dist/source-hash.js.map +1 -0
  57. package/dist/starter-description.d.ts +44 -0
  58. package/dist/starter-description.d.ts.map +1 -0
  59. package/dist/starter-description.js +273 -0
  60. package/dist/starter-description.js.map +1 -0
  61. package/dist/starter-source.d.ts +43 -0
  62. package/dist/starter-source.d.ts.map +1 -0
  63. package/dist/starter-source.js +156 -0
  64. package/dist/starter-source.js.map +1 -0
  65. package/dist/store-app-apply.d.ts +27 -0
  66. package/dist/store-app-apply.d.ts.map +1 -0
  67. package/dist/store-app-apply.js +100 -0
  68. package/dist/store-app-apply.js.map +1 -0
  69. package/dist/store-app-manifest.d.ts +86 -0
  70. package/dist/store-app-manifest.d.ts.map +1 -0
  71. package/dist/store-app-manifest.js +110 -0
  72. package/dist/store-app-manifest.js.map +1 -0
  73. package/dist/store-app-registry.d.ts +30 -0
  74. package/dist/store-app-registry.d.ts.map +1 -0
  75. package/dist/store-app-registry.js +232 -0
  76. package/dist/store-app-registry.js.map +1 -0
  77. package/models/recommended.json +42 -0
  78. package/modules/api/templates/react-router/app/api/operations.ts +8 -0
  79. package/modules/api/templates/tanstack-start/src/api/operations.ts +15 -0
  80. package/modules/docs/templates/astro-emdash/content/docs/getting-started.mdx +13 -0
  81. package/modules/docs/templates/astro-emdash/content/docs/index.mdx +13 -0
  82. package/modules/docs/templates/astro-emdash/content/docs/mcp.mdx +11 -0
  83. package/modules/docs/templates/astro-emdash/content/docs/meta.json +4 -0
  84. package/modules/docs/templates/astro-emdash/site/content/docs/getting-started.mdx +12 -0
  85. package/modules/docs/templates/astro-emdash/site/content/docs/index.mdx +12 -0
  86. package/modules/docs/templates/astro-emdash/site/content/docs/mcp.mdx +10 -0
  87. package/modules/docs/templates/astro-emdash/site/content/docs/meta.json +4 -0
  88. package/modules/docs/templates/astro-emdash/site/source.config.ts +10 -0
  89. package/modules/docs/templates/astro-emdash/site/src/docs/docs-assets.ts +1 -0
  90. package/modules/docs/templates/astro-emdash/site/src/docs/docs-client.tsx +22 -0
  91. package/modules/docs/templates/astro-emdash/site/src/docs/docs-data.ts +24 -0
  92. package/modules/docs/templates/astro-emdash/site/src/docs/docs-handler.tsx +105 -0
  93. package/modules/docs/templates/astro-emdash/site/src/docs/docs-layout.tsx +56 -0
  94. package/modules/docs/templates/astro-emdash/site/src/docs/docs-mdx.tsx +79 -0
  95. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page-actions.tsx +146 -0
  96. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page.tsx +70 -0
  97. package/modules/docs/templates/astro-emdash/site/src/docs/llm-text.ts +61 -0
  98. package/modules/docs/templates/astro-emdash/site/src/docs/source.ts +7 -0
  99. package/modules/docs/templates/astro-emdash/site/src/pages/docs/[...slug].ts +6 -0
  100. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/markdown.ts +4 -0
  101. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/search.ts +4 -0
  102. package/modules/docs/templates/astro-emdash/site/src/pages/llms.txt.ts +8 -0
  103. package/modules/docs/templates/astro-emdash/site/src/styles-docs.css +3 -0
  104. package/modules/docs/templates/astro-emdash/source.config.ts +10 -0
  105. package/modules/docs/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
  106. package/modules/docs/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
  107. package/modules/docs/templates/astro-emdash/src/docs/docs-data.ts +24 -0
  108. package/modules/docs/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
  109. package/modules/docs/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
  110. package/modules/docs/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
  111. package/modules/docs/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
  112. package/modules/docs/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
  113. package/modules/docs/templates/astro-emdash/src/docs/llm-text.ts +61 -0
  114. package/modules/docs/templates/astro-emdash/src/docs/source.ts +7 -0
  115. package/modules/docs/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
  116. package/modules/docs/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
  117. package/modules/docs/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
  118. package/modules/docs/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
  119. package/modules/docs/templates/astro-emdash/src/routes/docs.tsx +22 -0
  120. package/modules/docs/templates/astro-emdash/src/styles-docs.css +3 -0
  121. package/modules/docs/templates/react-router/app/components/mdx.tsx +79 -0
  122. package/modules/docs/templates/react-router/app/lib/layout.shared.tsx +54 -0
  123. package/modules/docs/templates/react-router/app/lib/source.ts +7 -0
  124. package/modules/docs/templates/react-router/app/routes/docs.$.tsx +49 -0
  125. package/modules/docs/templates/react-router/app/routes/docs.api.search.ts +10 -0
  126. package/modules/docs/templates/react-router/app/routes/docs.tsx +13 -0
  127. package/modules/docs/templates/react-router/content/docs/getting-started.mdx +8 -0
  128. package/modules/docs/templates/react-router/content/docs/index.mdx +8 -0
  129. package/modules/docs/templates/react-router/content/docs/mcp.mdx +121 -0
  130. package/modules/docs/templates/react-router/content/docs/meta.json +4 -0
  131. package/modules/docs/templates/react-router/source.config.ts +5 -0
  132. package/modules/docs/templates/tanstack-start/content/docs/getting-started.mdx +10 -0
  133. package/modules/docs/templates/tanstack-start/content/docs/index.mdx +8 -0
  134. package/modules/docs/templates/tanstack-start/content/docs/mcp.mdx +121 -0
  135. package/modules/docs/templates/tanstack-start/content/docs/meta.json +4 -0
  136. package/modules/docs/templates/tanstack-start/source.config.ts +10 -0
  137. package/modules/docs/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
  138. package/modules/docs/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
  139. package/modules/docs/templates/tanstack-start/src/docs/docs-data.ts +24 -0
  140. package/modules/docs/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
  141. package/modules/docs/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
  142. package/modules/docs/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
  143. package/modules/docs/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
  144. package/modules/docs/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
  145. package/modules/docs/templates/tanstack-start/src/docs/llm-text.ts +61 -0
  146. package/modules/docs/templates/tanstack-start/src/docs/source.ts +7 -0
  147. package/modules/docs/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
  148. package/modules/docs/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
  149. package/modules/docs/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
  150. package/modules/docs/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
  151. package/modules/docs/templates/tanstack-start/src/routes/docs.tsx +22 -0
  152. package/modules/docs/templates/tanstack-start/src/styles-docs.css +3 -0
  153. package/modules/guide/templates/astro-emdash/content/guide/capability-map.md +17 -0
  154. package/modules/guide/templates/astro-emdash/src/components/guide-widget.tsx +41 -0
  155. package/modules/guide/templates/astro-emdash/src/guide/actions.ts +8 -0
  156. package/modules/guide/templates/astro-emdash/src/guide/config.ts +21 -0
  157. package/modules/guide/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
  158. package/modules/guide/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
  159. package/modules/guide/templates/astro-emdash/src/guide/corpus.ts +4 -0
  160. package/modules/guide/templates/astro-emdash/src/guide/resources.json +4 -0
  161. package/modules/guide/templates/react-router/app/components/guide-widget.tsx +29 -0
  162. package/modules/guide/templates/react-router/app/guide/actions.ts +3 -0
  163. package/modules/guide/templates/react-router/app/guide/config.ts +21 -0
  164. package/modules/guide/templates/react-router/app/guide/corpus.gen.ts +4 -0
  165. package/modules/guide/templates/react-router/app/guide/corpus.manifest.json +22 -0
  166. package/modules/guide/templates/react-router/app/guide/corpus.ts +4 -0
  167. package/modules/guide/templates/react-router/app/guide/resources.json +4 -0
  168. package/modules/guide/templates/react-router/content/guide/capability-map.md +13 -0
  169. package/modules/guide/templates/tanstack-start/content/guide/capability-map.md +17 -0
  170. package/modules/guide/templates/tanstack-start/src/components/guide-widget.tsx +41 -0
  171. package/modules/guide/templates/tanstack-start/src/guide/actions.ts +17 -0
  172. package/modules/guide/templates/tanstack-start/src/guide/config.ts +21 -0
  173. package/modules/guide/templates/tanstack-start/src/guide/corpus.gen.ts +4 -0
  174. package/modules/guide/templates/tanstack-start/src/guide/corpus.manifest.json +22 -0
  175. package/modules/guide/templates/tanstack-start/src/guide/corpus.ts +4 -0
  176. package/modules/guide/templates/tanstack-start/src/guide/resources.json +4 -0
  177. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  178. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  179. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  180. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  181. package/modules/openai-subscription/templates/astro-emdash/src/openai-subscription.ts +11 -0
  182. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  183. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  184. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  185. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  186. package/modules/openai-subscription/templates/react-router/app/openai-subscription.ts +11 -0
  187. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  188. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  189. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  190. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  191. package/modules/openai-subscription/templates/tanstack-start/src/openai-subscription.ts +11 -0
  192. package/package.json +34 -8
  193. package/skills/README.md +122 -0
  194. package/skills/raybase-actions/SKILL.md +223 -0
  195. package/skills/raybase-actions/references/action-patterns.md +190 -0
  196. package/skills/raybase-actions/references/adapting-actions.md +93 -0
  197. package/skills/raybase-actions/references/testing-actions.md +48 -0
  198. package/skills/raybase-agent-debugging/SKILL.md +230 -0
  199. package/skills/raybase-ai/SKILL.md +1310 -0
  200. package/skills/raybase-api/SKILL.md +45 -0
  201. package/skills/raybase-astro-emdash/SKILL.md +143 -0
  202. package/skills/raybase-astro-emdash-content-model/SKILL.md +217 -0
  203. package/skills/raybase-astro-emdash-content-model/references/LICENSE-emdash +9 -0
  204. package/skills/raybase-astro-emdash-content-model/references/emdash-collections.md +265 -0
  205. package/skills/raybase-astro-emdash-design/LICENSE-impeccable +60 -0
  206. package/skills/raybase-astro-emdash-design/SKILL.md +170 -0
  207. package/skills/raybase-astro-emdash-design/reference/color.md +91 -0
  208. package/skills/raybase-astro-emdash-design/reference/copy.md +73 -0
  209. package/skills/raybase-astro-emdash-design/reference/direction.md +115 -0
  210. package/skills/raybase-astro-emdash-design/reference/imagery.md +84 -0
  211. package/skills/raybase-astro-emdash-design/reference/layout.md +69 -0
  212. package/skills/raybase-astro-emdash-design/reference/motion.md +75 -0
  213. package/skills/raybase-astro-emdash-design/reference/polish.md +75 -0
  214. package/skills/raybase-astro-emdash-design/reference/typography.md +72 -0
  215. package/skills/raybase-astro-emdash-galley/SKILL.md +265 -0
  216. package/skills/raybase-astro-emdash-migration/SKILL.md +218 -0
  217. package/skills/raybase-astro-emdash-migration/references/inventory-and-conversion.md +242 -0
  218. package/skills/raybase-astro-emdash-security-review/SKILL.md +68 -0
  219. package/skills/raybase-astro-emdash-theme-selection/SKILL.md +216 -0
  220. package/skills/raybase-auth/SKILL.md +358 -0
  221. package/skills/raybase-background-jobs/SKILL.md +774 -0
  222. package/skills/raybase-building/SKILL.md +409 -0
  223. package/skills/raybase-building/references/interview-and-spec.md +87 -0
  224. package/skills/raybase-building/references/planning-docs.md +26 -0
  225. package/skills/raybase-building/references/schema-and-config.md +70 -0
  226. package/skills/raybase-changing-a-live-app/SKILL.md +119 -0
  227. package/skills/raybase-data-and-policies/SKILL.md +377 -0
  228. package/skills/raybase-deploy/SKILL.md +136 -0
  229. package/skills/raybase-docs-writing/SKILL.md +119 -0
  230. package/skills/raybase-guide/SKILL.md +235 -0
  231. package/skills/raybase-mcp/SKILL.md +309 -0
  232. package/skills/raybase-mcp/agents/openai.yaml +4 -0
  233. package/skills/raybase-notifications/SKILL.md +138 -0
  234. package/skills/raybase-pro-migration/SKILL.md +28 -0
  235. package/skills/raybase-react-router/SKILL.md +241 -0
  236. package/skills/raybase-react-router-design/LICENSE-impeccable +60 -0
  237. package/skills/raybase-react-router-design/SKILL.md +135 -0
  238. package/skills/raybase-react-router-design/reference/color.md +87 -0
  239. package/skills/raybase-react-router-design/reference/copy.md +83 -0
  240. package/skills/raybase-react-router-design/reference/delight.md +48 -0
  241. package/skills/raybase-react-router-design/reference/interaction.md +91 -0
  242. package/skills/raybase-react-router-design/reference/layout.md +82 -0
  243. package/skills/raybase-react-router-design/reference/motion.md +86 -0
  244. package/skills/raybase-react-router-design/reference/polish.md +79 -0
  245. package/skills/raybase-react-router-design/reference/typography.md +71 -0
  246. package/skills/raybase-react-router-security-review/LICENSE +22 -0
  247. package/skills/raybase-react-router-security-review/SKILL.md +190 -0
  248. package/skills/raybase-react-router-security-review/agents/openai.yaml +4 -0
  249. package/skills/raybase-react-router-security-review/references/api-security.md +519 -0
  250. package/skills/raybase-react-router-security-review/references/authentication.md +353 -0
  251. package/skills/raybase-react-router-security-review/references/authorization.md +372 -0
  252. package/skills/raybase-react-router-security-review/references/business-logic.md +443 -0
  253. package/skills/raybase-react-router-security-review/references/cryptography.md +329 -0
  254. package/skills/raybase-react-router-security-review/references/csrf.md +398 -0
  255. package/skills/raybase-react-router-security-review/references/data-protection.md +378 -0
  256. package/skills/raybase-react-router-security-review/references/deserialization.md +410 -0
  257. package/skills/raybase-react-router-security-review/references/error-handling.md +436 -0
  258. package/skills/raybase-react-router-security-review/references/file-security.md +457 -0
  259. package/skills/raybase-react-router-security-review/references/injection.md +259 -0
  260. package/skills/raybase-react-router-security-review/references/logging.md +433 -0
  261. package/skills/raybase-react-router-security-review/references/misconfiguration.md +435 -0
  262. package/skills/raybase-react-router-security-review/references/modern-threats.md +475 -0
  263. package/skills/raybase-react-router-security-review/references/raybase-react-router-security.md +235 -0
  264. package/skills/raybase-react-router-security-review/references/ssrf.md +413 -0
  265. package/skills/raybase-react-router-security-review/references/supply-chain.md +405 -0
  266. package/skills/raybase-react-router-security-review/references/xss.md +336 -0
  267. package/skills/raybase-realtime/SKILL.md +158 -0
  268. package/skills/raybase-realtime/agents/openai.yaml +4 -0
  269. package/skills/raybase-schema/SKILL.md +209 -0
  270. package/skills/raybase-search/SKILL.md +137 -0
  271. package/skills/raybase-search/agents/openai.yaml +4 -0
  272. package/skills/raybase-settings/SKILL.md +139 -0
  273. package/skills/raybase-settings/agents/openai.yaml +4 -0
  274. package/skills/raybase-tanstack-start/SKILL.md +166 -0
  275. package/skills/raybase-tanstack-start-design/LICENSE-impeccable +60 -0
  276. package/skills/raybase-tanstack-start-design/SKILL.md +140 -0
  277. package/skills/raybase-tanstack-start-design/reference/color.md +80 -0
  278. package/skills/raybase-tanstack-start-design/reference/copy.md +83 -0
  279. package/skills/raybase-tanstack-start-design/reference/delight.md +48 -0
  280. package/skills/raybase-tanstack-start-design/reference/interaction.md +91 -0
  281. package/skills/raybase-tanstack-start-design/reference/layout.md +82 -0
  282. package/skills/raybase-tanstack-start-design/reference/motion.md +86 -0
  283. package/skills/raybase-tanstack-start-design/reference/polish.md +79 -0
  284. package/skills/raybase-tanstack-start-design/reference/typography.md +71 -0
  285. package/skills/raybase-tanstack-start-security-review/LICENSE +22 -0
  286. package/skills/raybase-tanstack-start-security-review/SKILL.md +194 -0
  287. package/skills/raybase-tanstack-start-security-review/agents/openai.yaml +4 -0
  288. package/skills/raybase-tanstack-start-security-review/references/api-security.md +519 -0
  289. package/skills/raybase-tanstack-start-security-review/references/authentication.md +353 -0
  290. package/skills/raybase-tanstack-start-security-review/references/authorization.md +372 -0
  291. package/skills/raybase-tanstack-start-security-review/references/business-logic.md +443 -0
  292. package/skills/raybase-tanstack-start-security-review/references/cryptography.md +329 -0
  293. package/skills/raybase-tanstack-start-security-review/references/csrf.md +398 -0
  294. package/skills/raybase-tanstack-start-security-review/references/data-protection.md +378 -0
  295. package/skills/raybase-tanstack-start-security-review/references/deserialization.md +410 -0
  296. package/skills/raybase-tanstack-start-security-review/references/error-handling.md +436 -0
  297. package/skills/raybase-tanstack-start-security-review/references/file-security.md +457 -0
  298. package/skills/raybase-tanstack-start-security-review/references/injection.md +259 -0
  299. package/skills/raybase-tanstack-start-security-review/references/logging.md +433 -0
  300. package/skills/raybase-tanstack-start-security-review/references/misconfiguration.md +435 -0
  301. package/skills/raybase-tanstack-start-security-review/references/modern-threats.md +475 -0
  302. package/skills/raybase-tanstack-start-security-review/references/raybase-tanstack-security.md +208 -0
  303. package/skills/raybase-tanstack-start-security-review/references/ssrf.md +413 -0
  304. package/skills/raybase-tanstack-start-security-review/references/supply-chain.md +405 -0
  305. package/skills/raybase-tanstack-start-security-review/references/xss.md +336 -0
  306. package/skills-manifest.json +41 -0
  307. package/templates/astro-emdash/.dev.vars.example +7 -0
  308. package/templates/astro-emdash/AGENTS.md +122 -0
  309. package/templates/astro-emdash/DESIGN.md +90 -0
  310. package/templates/astro-emdash/components.json +21 -0
  311. package/templates/astro-emdash/content/docs/getting-started.mdx +20 -0
  312. package/templates/astro-emdash/content/docs/index.mdx +13 -0
  313. package/templates/astro-emdash/content/docs/mcp.mdx +11 -0
  314. package/templates/astro-emdash/content/docs/meta.json +4 -0
  315. package/templates/astro-emdash/content/docs/site-templates.mdx +62 -0
  316. package/templates/astro-emdash/dev/CODEBASE-MAP.md +46 -0
  317. package/templates/astro-emdash/dev/SPEC-OVERVIEW.md +15 -0
  318. package/templates/astro-emdash/dev/SPEC.md +84 -0
  319. package/templates/astro-emdash/dev/features/archive/.gitkeep +1 -0
  320. package/templates/astro-emdash/docs/theme-previews/base.svg +24 -0
  321. package/templates/astro-emdash/docs/theme-previews/steel.svg +24 -0
  322. package/templates/astro-emdash/docs/theme-previews/zen.svg +24 -0
  323. package/templates/astro-emdash/docs/themes.md +106 -0
  324. package/templates/astro-emdash/drizzle.config.ts +5 -0
  325. package/templates/astro-emdash/gitignore +11 -0
  326. package/templates/astro-emdash/migrations/app/meta/_journal.json +5 -0
  327. package/templates/astro-emdash/package.json +79 -0
  328. package/templates/astro-emdash/pnpm-workspace.yaml +71 -0
  329. package/templates/astro-emdash/public/_headers +4 -0
  330. package/templates/astro-emdash/site/astro.config.mjs +120 -0
  331. package/templates/astro-emdash/site/demo/README.md +72 -0
  332. package/templates/astro-emdash/site/demo/content/collection.json +43 -0
  333. package/templates/astro-emdash/site/demo/content/entries.json +120 -0
  334. package/templates/astro-emdash/site/demo/templates/demo-article-card/manifest.json +51 -0
  335. package/templates/astro-emdash/site/demo/templates/demo-article-card/sample-content.json +5 -0
  336. package/templates/astro-emdash/site/demo/templates/demo-article-card/template.liquid +48 -0
  337. package/templates/astro-emdash/site/demo/templates/demo-article-page/host.json +9 -0
  338. package/templates/astro-emdash/site/demo/templates/demo-article-page/manifest.json +38 -0
  339. package/templates/astro-emdash/site/demo/templates/demo-article-page/sample-content.json +34 -0
  340. package/templates/astro-emdash/site/demo/templates/demo-article-page/template.liquid +84 -0
  341. package/templates/astro-emdash/site/demo/templates/demo-articles-index/manifest.json +64 -0
  342. package/templates/astro-emdash/site/demo/templates/demo-articles-index/page.json +7 -0
  343. package/templates/astro-emdash/site/demo/templates/demo-articles-index/sample-content.json +24 -0
  344. package/templates/astro-emdash/site/demo/templates/demo-articles-index/template.liquid +100 -0
  345. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/manifest.json +51 -0
  346. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/sample-content.json +5 -0
  347. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/template.liquid +70 -0
  348. package/templates/astro-emdash/site/gitignore +1 -0
  349. package/templates/astro-emdash/site/package.json +56 -0
  350. package/templates/astro-emdash/site/scripts/apply-site-templates.mjs +560 -0
  351. package/templates/astro-emdash/site/scripts/galley-demo.mjs +298 -0
  352. package/templates/astro-emdash/site/scripts/seed-galley-starter.mjs +360 -0
  353. package/templates/astro-emdash/site/scripts/site-origin.mjs +45 -0
  354. package/templates/astro-emdash/site/seed/seed.json +154 -0
  355. package/templates/astro-emdash/site/seed/templates/.gitkeep +1 -0
  356. package/templates/astro-emdash/site/src/components/RaybaseSignedInMenu.astro +163 -0
  357. package/templates/astro-emdash/site/src/components/blocks/RaybaseActionIsland.astro +41 -0
  358. package/templates/astro-emdash/site/src/content-door/raybase-routes.ts +738 -0
  359. package/templates/astro-emdash/site/src/content-door/resolve-page.ts +142 -0
  360. package/templates/astro-emdash/site/src/content-door/seed.ts +85 -0
  361. package/templates/astro-emdash/site/src/env.d.ts +12 -0
  362. package/templates/astro-emdash/site/src/layouts/SiteLayout.astro +68 -0
  363. package/templates/astro-emdash/site/src/lib/palettes.gen.ts +7 -0
  364. package/templates/astro-emdash/site/src/lib/site-motion.ts +169 -0
  365. package/templates/astro-emdash/site/src/lib/site-shell.ts +294 -0
  366. package/templates/astro-emdash/site/src/live.config.ts +8 -0
  367. package/templates/astro-emdash/site/src/middleware.ts +20 -0
  368. package/templates/astro-emdash/site/src/pages/[...slug].astro +113 -0
  369. package/templates/astro-emdash/site/src/pages/_raybase/handoff/consume.ts +6 -0
  370. package/templates/astro-emdash/site/src/pages/_raybase/islands/action.ts +8 -0
  371. package/templates/astro-emdash/site/src/pages/_raybase/sign-out/index.ts +6 -0
  372. package/templates/astro-emdash/site/src/styles/palette-fonts.gen.css +1 -0
  373. package/templates/astro-emdash/site/src/styles/palettes.gen.css +3 -0
  374. package/templates/astro-emdash/site/src/styles.css +607 -0
  375. package/templates/astro-emdash/site/tsconfig.json +12 -0
  376. package/templates/astro-emdash/site/wrangler.jsonc +34 -0
  377. package/templates/astro-emdash/source.config.ts +10 -0
  378. package/templates/astro-emdash/src/actions.ts +58 -0
  379. package/templates/astro-emdash/src/ai/agents.ts +20 -0
  380. package/templates/astro-emdash/src/ai/retrieval.ts +36 -0
  381. package/templates/astro-emdash/src/auth-door.ts +18 -0
  382. package/templates/astro-emdash/src/client.tsx +25 -0
  383. package/templates/astro-emdash/src/components/.gitkeep +1 -0
  384. package/templates/astro-emdash/src/components/account-menu.tsx +91 -0
  385. package/templates/astro-emdash/src/components/auth-shell.tsx +69 -0
  386. package/templates/astro-emdash/src/components/mode-toggle.tsx +32 -0
  387. package/templates/astro-emdash/src/components/search-command-palette.tsx +107 -0
  388. package/templates/astro-emdash/src/components/setup-token-page.tsx +196 -0
  389. package/templates/astro-emdash/src/components/ui/avatar.tsx +107 -0
  390. package/templates/astro-emdash/src/components/ui/badge.tsx +52 -0
  391. package/templates/astro-emdash/src/components/ui/button.tsx +69 -0
  392. package/templates/astro-emdash/src/components/ui/checkbox.tsx +29 -0
  393. package/templates/astro-emdash/src/components/ui/dialog.tsx +158 -0
  394. package/templates/astro-emdash/src/components/ui/dropdown-menu.tsx +303 -0
  395. package/templates/astro-emdash/src/components/ui/input.tsx +20 -0
  396. package/templates/astro-emdash/src/components/ui/label.tsx +20 -0
  397. package/templates/astro-emdash/src/components/ui/scroll-area.tsx +53 -0
  398. package/templates/astro-emdash/src/components/ui/select.tsx +215 -0
  399. package/templates/astro-emdash/src/components/ui/separator.tsx +23 -0
  400. package/templates/astro-emdash/src/components/ui/sheet.tsx +138 -0
  401. package/templates/astro-emdash/src/components/ui/sidebar.tsx +728 -0
  402. package/templates/astro-emdash/src/components/ui/skeleton.tsx +13 -0
  403. package/templates/astro-emdash/src/components/ui/textarea.tsx +18 -0
  404. package/templates/astro-emdash/src/components/ui/tooltip.tsx +66 -0
  405. package/templates/astro-emdash/src/db/migrations.gen.ts +6 -0
  406. package/templates/astro-emdash/src/db/schema.ts +6 -0
  407. package/templates/astro-emdash/src/db/seed.ts +16 -0
  408. package/templates/astro-emdash/src/db/storage.ts +32 -0
  409. package/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
  410. package/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
  411. package/templates/astro-emdash/src/docs/docs-data.ts +24 -0
  412. package/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
  413. package/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
  414. package/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
  415. package/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
  416. package/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
  417. package/templates/astro-emdash/src/docs/llm-text.ts +61 -0
  418. package/templates/astro-emdash/src/docs/source.ts +7 -0
  419. package/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
  420. package/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
  421. package/templates/astro-emdash/src/hooks/use-mobile.ts +19 -0
  422. package/templates/astro-emdash/src/jobs.example.ts +48 -0
  423. package/templates/astro-emdash/src/lib/account.ts +12 -0
  424. package/templates/astro-emdash/src/lib/auth-client.ts +181 -0
  425. package/templates/astro-emdash/src/lib/utils.ts +6 -0
  426. package/templates/astro-emdash/src/mcp-app.ts +57 -0
  427. package/templates/astro-emdash/src/notifications.example.ts +37 -0
  428. package/templates/astro-emdash/src/raybase.auth.ts +70 -0
  429. package/templates/astro-emdash/src/raybase.config.ts +49 -0
  430. package/templates/astro-emdash/src/raybase.server.ts +56 -0
  431. package/templates/astro-emdash/src/realtime.example.ts +18 -0
  432. package/templates/astro-emdash/src/router.tsx +19 -0
  433. package/templates/astro-emdash/src/routes/__root.tsx +56 -0
  434. package/templates/astro-emdash/src/routes/_app/admin.tsx +13 -0
  435. package/templates/astro-emdash/src/routes/_app/forgot-password.tsx +97 -0
  436. package/templates/astro-emdash/src/routes/_app/index.tsx +169 -0
  437. package/templates/astro-emdash/src/routes/_app/invite.$token.tsx +11 -0
  438. package/templates/astro-emdash/src/routes/_app/login.tsx +193 -0
  439. package/templates/astro-emdash/src/routes/_app/profile.tsx +98 -0
  440. package/templates/astro-emdash/src/routes/_app/reset-password.$token.tsx +15 -0
  441. package/templates/astro-emdash/src/routes/_app/reset-password.tsx +115 -0
  442. package/templates/astro-emdash/src/routes/_app/setup.$token.tsx +11 -0
  443. package/templates/astro-emdash/src/routes/_app/signup.tsx +141 -0
  444. package/templates/astro-emdash/src/routes/_app/verify-email.$token.tsx +15 -0
  445. package/templates/astro-emdash/src/routes/_app/verify-email.tsx +154 -0
  446. package/templates/astro-emdash/src/routes/_app.tsx +33 -0
  447. package/templates/astro-emdash/src/routes/admin/$.ts +20 -0
  448. package/templates/astro-emdash/src/routes/api/$.ts +19 -0
  449. package/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
  450. package/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
  451. package/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
  452. package/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
  453. package/templates/astro-emdash/src/routes/docs.tsx +22 -0
  454. package/templates/astro-emdash/src/search.ts +6 -0
  455. package/templates/astro-emdash/src/settings.ts +12 -0
  456. package/templates/astro-emdash/src/styles-docs.css +3 -0
  457. package/templates/astro-emdash/src/styles.css +101 -0
  458. package/templates/astro-emdash/src/themes/base.css +76 -0
  459. package/templates/astro-emdash/src/themes/carbon.css +76 -0
  460. package/templates/astro-emdash/src/themes/fonts.css +25 -0
  461. package/templates/astro-emdash/src/themes/sage.css +76 -0
  462. package/templates/astro-emdash/src/themes/sand.css +76 -0
  463. package/templates/astro-emdash/src/themes/slate.css +81 -0
  464. package/templates/astro-emdash/src/themes/ultra.css +76 -0
  465. package/templates/astro-emdash/src/themes/zen.css +76 -0
  466. package/templates/astro-emdash/src/worker-entry.ts +31 -0
  467. package/templates/astro-emdash/tests/raybase-patterns.test.ts +29 -0
  468. package/templates/astro-emdash/tsconfig.json +36 -0
  469. package/templates/astro-emdash/vite.config.ts +130 -0
  470. package/templates/astro-emdash/vitest.config.ts +8 -0
  471. package/templates/astro-emdash/wrangler.jsonc +112 -0
  472. package/templates/react-router/.dev.vars.example +5 -0
  473. package/templates/react-router/.editorconfig +15 -0
  474. package/templates/react-router/AGENTS.md +54 -0
  475. package/templates/react-router/README.md +52 -0
  476. package/templates/react-router/app/app.css +44 -0
  477. package/templates/react-router/app/components/mdx.tsx +79 -0
  478. package/templates/react-router/app/components/ui/button.tsx +45 -0
  479. package/templates/react-router/app/components/ui/card.tsx +87 -0
  480. package/templates/react-router/app/components/ui/separator.tsx +22 -0
  481. package/templates/react-router/app/db/migrations.gen.ts +6 -0
  482. package/templates/react-router/app/db/schema.ts +56 -0
  483. package/templates/react-router/app/db/seed.ts +14 -0
  484. package/templates/react-router/app/entry.server.tsx +41 -0
  485. package/templates/react-router/app/globals.d.ts +1 -0
  486. package/templates/react-router/app/lib/layout.shared.tsx +52 -0
  487. package/templates/react-router/app/lib/source.ts +7 -0
  488. package/templates/react-router/app/lib/utils.ts +6 -0
  489. package/templates/react-router/app/raybase.server.ts +65 -0
  490. package/templates/react-router/app/root.tsx +23 -0
  491. package/templates/react-router/app/routes/_index.tsx +53 -0
  492. package/templates/react-router/app/routes/docs.$.tsx +49 -0
  493. package/templates/react-router/app/routes/docs.api.search.ts +10 -0
  494. package/templates/react-router/app/routes/docs.tsx +13 -0
  495. package/templates/react-router/app/routes.ts +3 -0
  496. package/templates/react-router/components.json +22 -0
  497. package/templates/react-router/content/docs/getting-started.mdx +15 -0
  498. package/templates/react-router/content/docs/index.mdx +8 -0
  499. package/templates/react-router/content/docs/mcp.mdx +121 -0
  500. package/templates/react-router/content/docs/meta.json +4 -0
  501. package/templates/react-router/dev/CODEBASE-MAP.md +48 -0
  502. package/templates/react-router/dev/SPEC-OVERVIEW.md +35 -0
  503. package/templates/react-router/dev/SPEC.md +93 -0
  504. package/templates/react-router/dev/features/archive/.gitkeep +1 -0
  505. package/templates/react-router/drizzle.config.ts +5 -0
  506. package/templates/react-router/env.d.ts +53 -0
  507. package/templates/react-router/gitignore +23 -0
  508. package/templates/react-router/migrations/app/meta/_journal.json +1 -0
  509. package/templates/react-router/package.json +70 -0
  510. package/templates/react-router/public/_headers +4 -0
  511. package/templates/react-router/public/favicon.ico +0 -0
  512. package/templates/react-router/react-router.config.ts +9 -0
  513. package/templates/react-router/source.config.ts +5 -0
  514. package/templates/react-router/tests/raybase-patterns.test.ts +23 -0
  515. package/templates/react-router/tsconfig.json +27 -0
  516. package/templates/react-router/vite.config.ts +59 -0
  517. package/templates/react-router/vitest.config.ts +8 -0
  518. package/templates/react-router/workers/app.ts +40 -0
  519. package/templates/react-router/wrangler.jsonc +111 -0
  520. package/templates/tanstack-start/.dev.vars.example +5 -0
  521. package/templates/tanstack-start/AGENTS.md +95 -0
  522. package/templates/tanstack-start/DESIGN.md +65 -0
  523. package/templates/tanstack-start/components.json +21 -0
  524. package/templates/tanstack-start/content/docs/getting-started.mdx +65 -0
  525. package/templates/tanstack-start/content/docs/index.mdx +10 -0
  526. package/templates/tanstack-start/content/docs/mcp.mdx +122 -0
  527. package/templates/tanstack-start/content/docs/meta.json +4 -0
  528. package/templates/tanstack-start/dev/CODEBASE-MAP.md +84 -0
  529. package/templates/tanstack-start/dev/SPEC-OVERVIEW.md +46 -0
  530. package/templates/tanstack-start/dev/SPEC.md +213 -0
  531. package/templates/tanstack-start/dev/features/archive/.gitkeep +1 -0
  532. package/templates/tanstack-start/docs/theme-previews/base.svg +24 -0
  533. package/templates/tanstack-start/docs/theme-previews/steel.svg +24 -0
  534. package/templates/tanstack-start/docs/theme-previews/zen.svg +24 -0
  535. package/templates/tanstack-start/docs/themes.md +116 -0
  536. package/templates/tanstack-start/drizzle.config.ts +5 -0
  537. package/templates/tanstack-start/gitignore +11 -0
  538. package/templates/tanstack-start/migrations/app/0000_low_karen_page.sql +26 -0
  539. package/templates/tanstack-start/migrations/app/meta/0000_snapshot.json +196 -0
  540. package/templates/tanstack-start/migrations/app/meta/_journal.json +13 -0
  541. package/templates/tanstack-start/package.json +77 -0
  542. package/templates/tanstack-start/public/_headers +8 -0
  543. package/templates/tanstack-start/public/icons/app-icon-maskable.svg +1 -0
  544. package/templates/tanstack-start/public/icons/app-icon.svg +1 -0
  545. package/templates/tanstack-start/public/icons/apple-touch-icon.png +0 -0
  546. package/templates/tanstack-start/public/manifest.webmanifest +14 -0
  547. package/templates/tanstack-start/public/raybase-push-sw.js +32 -0
  548. package/templates/tanstack-start/source.config.ts +10 -0
  549. package/templates/tanstack-start/src/actions.ts +560 -0
  550. package/templates/tanstack-start/src/ai/agents.ts +78 -0
  551. package/templates/tanstack-start/src/ai/retrieval.ts +36 -0
  552. package/templates/tanstack-start/src/auth-door.ts +18 -0
  553. package/templates/tanstack-start/src/client.tsx +25 -0
  554. package/templates/tanstack-start/src/components/.gitkeep +1 -0
  555. package/templates/tanstack-start/src/components/account-menu.tsx +127 -0
  556. package/templates/tanstack-start/src/components/auth-shell.tsx +69 -0
  557. package/templates/tanstack-start/src/components/install-app.tsx +35 -0
  558. package/templates/tanstack-start/src/components/mode-toggle.tsx +32 -0
  559. package/templates/tanstack-start/src/components/search-command-palette.tsx +107 -0
  560. package/templates/tanstack-start/src/components/setup-token-page.tsx +197 -0
  561. package/templates/tanstack-start/src/components/ui/avatar.tsx +107 -0
  562. package/templates/tanstack-start/src/components/ui/badge.tsx +52 -0
  563. package/templates/tanstack-start/src/components/ui/button.tsx +69 -0
  564. package/templates/tanstack-start/src/components/ui/checkbox.tsx +29 -0
  565. package/templates/tanstack-start/src/components/ui/dialog.tsx +158 -0
  566. package/templates/tanstack-start/src/components/ui/dropdown-menu.tsx +303 -0
  567. package/templates/tanstack-start/src/components/ui/input.tsx +20 -0
  568. package/templates/tanstack-start/src/components/ui/label.tsx +20 -0
  569. package/templates/tanstack-start/src/components/ui/scroll-area.tsx +53 -0
  570. package/templates/tanstack-start/src/components/ui/select.tsx +215 -0
  571. package/templates/tanstack-start/src/components/ui/separator.tsx +23 -0
  572. package/templates/tanstack-start/src/components/ui/sheet.tsx +138 -0
  573. package/templates/tanstack-start/src/components/ui/sidebar.tsx +728 -0
  574. package/templates/tanstack-start/src/components/ui/skeleton.tsx +13 -0
  575. package/templates/tanstack-start/src/components/ui/textarea.tsx +18 -0
  576. package/templates/tanstack-start/src/components/ui/tooltip.tsx +66 -0
  577. package/templates/tanstack-start/src/db/migrations.gen.ts +6 -0
  578. package/templates/tanstack-start/src/db/schema.ts +90 -0
  579. package/templates/tanstack-start/src/db/seed.ts +106 -0
  580. package/templates/tanstack-start/src/db/storage.ts +32 -0
  581. package/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
  582. package/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
  583. package/templates/tanstack-start/src/docs/docs-data.ts +24 -0
  584. package/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
  585. package/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
  586. package/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
  587. package/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
  588. package/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
  589. package/templates/tanstack-start/src/docs/llm-text.ts +61 -0
  590. package/templates/tanstack-start/src/docs/source.ts +7 -0
  591. package/templates/tanstack-start/src/hooks/use-mobile.ts +19 -0
  592. package/templates/tanstack-start/src/hooks/use-pwa-install.ts +77 -0
  593. package/templates/tanstack-start/src/jobs.example.ts +56 -0
  594. package/templates/tanstack-start/src/lib/account.ts +13 -0
  595. package/templates/tanstack-start/src/lib/auth-client.ts +187 -0
  596. package/templates/tanstack-start/src/lib/push-client.ts +98 -0
  597. package/templates/tanstack-start/src/lib/utils.ts +6 -0
  598. package/templates/tanstack-start/src/mcp-app.ts +74 -0
  599. package/templates/tanstack-start/src/notifications.example.ts +37 -0
  600. package/templates/tanstack-start/src/raybase.auth.ts +86 -0
  601. package/templates/tanstack-start/src/raybase.config.ts +86 -0
  602. package/templates/tanstack-start/src/raybase.server.ts +155 -0
  603. package/templates/tanstack-start/src/realtime.example.ts +46 -0
  604. package/templates/tanstack-start/src/router.tsx +19 -0
  605. package/templates/tanstack-start/src/routes/__root.tsx +73 -0
  606. package/templates/tanstack-start/src/routes/_app/admin.tsx +13 -0
  607. package/templates/tanstack-start/src/routes/_app/forgot-password.tsx +97 -0
  608. package/templates/tanstack-start/src/routes/_app/index.tsx +1316 -0
  609. package/templates/tanstack-start/src/routes/_app/invite.$token.tsx +11 -0
  610. package/templates/tanstack-start/src/routes/_app/login.tsx +193 -0
  611. package/templates/tanstack-start/src/routes/_app/profile.tsx +98 -0
  612. package/templates/tanstack-start/src/routes/_app/reset-password.$token.tsx +16 -0
  613. package/templates/tanstack-start/src/routes/_app/reset-password.tsx +115 -0
  614. package/templates/tanstack-start/src/routes/_app/setup.$token.tsx +11 -0
  615. package/templates/tanstack-start/src/routes/_app/signup.tsx +141 -0
  616. package/templates/tanstack-start/src/routes/_app/verify-email.$token.tsx +15 -0
  617. package/templates/tanstack-start/src/routes/_app/verify-email.tsx +154 -0
  618. package/templates/tanstack-start/src/routes/_app.tsx +33 -0
  619. package/templates/tanstack-start/src/routes/admin/$.ts +20 -0
  620. package/templates/tanstack-start/src/routes/api/$.ts +19 -0
  621. package/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
  622. package/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
  623. package/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
  624. package/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
  625. package/templates/tanstack-start/src/routes/docs.tsx +22 -0
  626. package/templates/tanstack-start/src/search.ts +26 -0
  627. package/templates/tanstack-start/src/settings.ts +12 -0
  628. package/templates/tanstack-start/src/styles-docs.css +3 -0
  629. package/templates/tanstack-start/src/styles.css +73 -0
  630. package/templates/tanstack-start/src/themes/base.css +76 -0
  631. package/templates/tanstack-start/src/themes/carbon.css +76 -0
  632. package/templates/tanstack-start/src/themes/fonts.css +18 -0
  633. package/templates/tanstack-start/src/themes/sage.css +76 -0
  634. package/templates/tanstack-start/src/themes/sand.css +76 -0
  635. package/templates/tanstack-start/src/themes/slate.css +76 -0
  636. package/templates/tanstack-start/src/themes/ultra.css +76 -0
  637. package/templates/tanstack-start/src/themes/zen.css +76 -0
  638. package/templates/tanstack-start/src/worker-entry.ts +30 -0
  639. package/templates/tanstack-start/tests/raybase-patterns.test.ts +247 -0
  640. package/templates/tanstack-start/tsconfig.json +33 -0
  641. package/templates/tanstack-start/vite.config.ts +132 -0
  642. package/templates/tanstack-start/vitest.config.ts +8 -0
  643. package/templates/tanstack-start/wrangler.jsonc +112 -0
  644. package/README.md +0 -3
@@ -0,0 +1,73 @@
1
+ # Copy
2
+
3
+ On a content site, copy is a design material with the same weight as
4
+ typography. Registry sample copy is scaffolding — replacing it with the
5
+ site's own voice is a required design step, not a content chore. Cheapest
6
+ moment: edit the staged files under `site/seed/` before `templates:apply`
7
+ (theme-selection skill); after publish, edits go through EmDash.
8
+
9
+ ## Voice
10
+
11
+ - Derive the voice from the direction's three brand-voice words and the audience ([direction.md](direction.md)). Voice stays constant across the site; tone adapts to the moment (celebratory in success, serious in a destructive confirm, empathetic in errors).
12
+ - **Make the specific claim.** "Wood-fired sourdough, fermented 48 hours" beats "Artisanal breads made with care". If a competitor could run the sentence unchanged, it isn't copy yet.
13
+ - No meta-criticism theater: naming a concept then layering an ironic modifier, or staging a strawman to "correct" it, is AI-flavored copy. Say the thing.
14
+ - Headings state the idea of their section, not its category. "Open a table by the water" beats "Reservations"; but never sacrifice wayfinding — nav labels stay plain and specific.
15
+
16
+ ## Specific means true
17
+
18
+ "Make the specific claim" is a voice rule, not a license to invent facts.
19
+ Vivid concrete language is yours to write; factual claims are not — numbers,
20
+ years, awards, testimonials, review counts, client names, team members,
21
+ certifications, "family-owned since" heritage. Every one must trace to the
22
+ spec, the interview, or owner-supplied material. When the true specific
23
+ isn't known, write voice without the number ("fermented slowly, shaped by
24
+ hand"), leave a named gap for the owner in the handoff message, or ask —
25
+ never manufacture credibility. Fabricated trust signals are data slop, and
26
+ they become lies the moment the site ships.
27
+
28
+ ## Headlines and CTAs
29
+
30
+ - One primary action per page, phrased verb + object ("Book a table", "Read the menu", "Start a project") — never "Submit", "Click here", or "Learn more" as the primary CTA.
31
+ - Match the register: a luxury hotel doesn't "Grab your spot". The CTA is voice too.
32
+ - Test headline copy at every breakpoint; if it overflows, rewrite or reduce the clamp — the words and the layout are one design.
33
+
34
+ ## Microcopy
35
+
36
+ The few interactive moments a site has deserve full treatment:
37
+
38
+ - **Forms** (contact, booking, signup): visible labels (placeholders aren't labels), format examples, errors that say what happened and how to fix it ("Email needs an @ — try name@example.com"), never blaming the user. Preserve input on error.
39
+ - **Island controls**: name the action specifically, show in-flight state ("Checking availability…"), and write the error path ("We couldn't reach the booking service. Try again or call us.") without exposing internal URLs or tokens.
40
+ - **Fallback content** (before EmDash setup or when a data rail is empty): useful and welcoming, never "No items" — say what will be here and what to do meanwhile.
41
+ - Loading copy specific to what's happening; never AI-filler whimsy ("Herding pixels…" is instantly recognizable machine copy).
42
+
43
+ ## Findability and sharing
44
+
45
+ - Every page gets a real `<title>` and meta description in its own words — write them with the page, not as an afterthought; they're the site's copy in search results.
46
+ - Link text has standalone meaning ("View the spring menu", not "click here").
47
+ - Alt text is part of the voice — see [imagery.md](imagery.md).
48
+
49
+ ## Consistency
50
+
51
+ - One term per concept, everywhere: the nav, the section headings, the CTAs, and the EmDash collection labels editors see should share nouns. A "Treatment" in the nav can't be a "Service" in the pricing band.
52
+ - Capitalization and punctuation are systemic: pick sentence case or title case for headings once; periods on sentences, not on labels.
53
+ - If the heading explains it, the intro paragraph restating it is redundant. Say it once, well.
54
+
55
+ ## Writing for editors
56
+
57
+ The copy you ship is the example editors will imitate. Portable Text bodies,
58
+ field values, and alt text should demonstrate the voice at handoff quality —
59
+ an editor extending the site should be able to match the register by
60
+ pattern-matching what's already there.
61
+
62
+ ## Never
63
+
64
+ - Registry sample copy or lorem placeholder text at handoff.
65
+ - Invented stats, testimonials, credentials, or heritage claims — fabricated specificity is worse than vagueness.
66
+ - Humor in error states; system-flavored language on the public site ("Invalid input", "Error 403").
67
+ - Jargon the audience doesn't use; internal nouns leaking into public labels.
68
+ - Copy that varies terminology for variety.
69
+ - All-caps body copy; eyebrows/kickers as section grammar ([SKILL.md bans](../SKILL.md)).
70
+
71
+ ---
72
+
73
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,115 @@
1
+ # Design Direction
2
+
3
+ A design direction is the short, committed statement that everything else —
4
+ theme selection, copy, imagery, palette, motion — consumes. Derive it from
5
+ the approved spec before searching for a theme; theme selection must not
6
+ invent a direction from the first search results. Most AI-generated sites
7
+ fail not because of bad execution but because this thinking was skipped.
8
+
9
+ ## The fields
10
+
11
+ Write each of these down. Vague answers here become generic pages later.
12
+
13
+ 1. **Audience and job.** Who specifically visits, and what is the site's job: sell, inform, publish, book, convert? Not "users" — role, context, frequency.
14
+ 2. **Three brand-voice words.** Not "modern" or "elegant" — physical-object words: "warm and mechanical and opinionated", "calm and clinical and careful". These drive font and palette choices later.
15
+ 3. **The scene sentence.** One sentence of physical context: who uses this, where, under what ambient light, in what mood. It forces dark vs light — dark is never "because it looks cool", light is never "to be safe". If the sentence doesn't force the answer, add detail until it does.
16
+ 4. **Color strategy.** Pick one on the commitment axis ([color.md](color.md) has the mechanics):
17
+ - **Restrained**: tinted neutrals + one accent ≤10% of visual weight.
18
+ - **Committed**: one saturated color carries 30–60% of the surface.
19
+ - **Full palette**: 3–4 named color roles, each deliberate.
20
+ - **Drenched**: the surface IS the color.
21
+ 5. **Two or three named anchor references, and one anti-reference.** Specific products, brands, or printed objects — "Klim Type Foundry's orange drench", "Stripe purple-on-white restraint", "a mid-century diner receipt" — never adjectives. The anti-reference names what this site must NOT feel like. Unnamed ambition becomes beige.
22
+ 6. **Density preference** and any reference sites from the spec interview.
23
+
24
+ ## Generate candidates before committing
25
+
26
+ The first direction that comes to mind is the training-data reflex — the
27
+ same reflex the slop tests below exist to catch. Counter it at the source:
28
+ fields 1–3 are facts about the brief, but before locking fields 4–5, write
29
+ down **3–4 candidate directions**. Each candidate is concrete — a color
30
+ strategy with its hue family, a type mood, a density, and a one-line
31
+ rationale tied to the brief — never an adjective set.
32
+
33
+ Rules for the set:
34
+
35
+ - Candidates must not share a palette family. Four takes on the same
36
+ warm-neutral are one candidate, not four.
37
+ - At least one must be deliberately off-distribution for the category — the
38
+ direction no competitor in this space would ship.
39
+ - Specify each before judging any. Variety must be designed, not hoped for;
40
+ alternatives left vague converge back onto the reflex.
41
+
42
+ Commit to the strongest candidate for this audience and job — not the
43
+ safest — and keep what the losers taught you: a rejected candidate often
44
+ names the anti-reference for free.
45
+
46
+ ## Check it against the slop tests
47
+
48
+ Before recording, run the two-altitude check from SKILL.md: could someone
49
+ guess the palette from the category alone (first-order reflex)? Could they
50
+ guess the aesthetic family from category-plus-anti-reference (second-order
51
+ reflex — "not SaaS-cream, so… editorial serif + mono labels")? The
52
+ editorial-typographic lane (display serif, often italic, small mono labels,
53
+ ruled separators, monochromatic restraint) is the currently saturated
54
+ second-order trap. Rework until neither answer is obvious.
55
+
56
+ Then the inverse test: describe the planned site in one sentence the way a
57
+ competitor would describe theirs. If the sentence fits the modal landing page
58
+ in the category, restart.
59
+
60
+ ## Speak the registry's vocabulary
61
+
62
+ Theme search and comparison work best when the direction uses the registry's
63
+ own guidance fields — `tone`, `density`, `bestFor`. Translate the direction
64
+ into those words before running `raybase templates search`, so the query and
65
+ the candidate comparison use the same language.
66
+
67
+ ## Record it in DESIGN.md
68
+
69
+ Write the direction into the Public Site section of `DESIGN.md` before the
70
+ theme-selection loop, in roughly this shape:
71
+
72
+ ```markdown
73
+ ## Public Site
74
+
75
+ - **Direction**: <audience> · site's job: <sell/inform/publish/book> ·
76
+ voice: <three words> · density: <airy/comfortable/dense>
77
+ - **Scene**: <the scene sentence> → <light/dark>
78
+ - **Color strategy**: <Restrained/Committed/Full palette/Drenched> — <hue family or anchor>
79
+ - **References**: <2–3 named> · **Anti-reference**: <named>
80
+ - **Theme**: <id> · palette: <key> — <tone rationale> (written at selection)
81
+ - **Shell**: <layout-id> — <capacity rationale: nav item count, footer grade, and why it fits the IA> (written at shell selection)
82
+ - **Signature moves**: <the 1–2 things that make this site unmistakably itself>
83
+ - **Deviations**: <bespoke sections, palette edits, font swaps, shell nav/footer swaps — each with why>
84
+ ```
85
+
86
+ The **Theme** owns voice and vocabulary; the **Shell** owns the IA's frame (the
87
+ nav/footer/layout). They are chosen separately — record both. If the IA later
88
+ grows (new pages, deeper nesting), you swap the shell for a higher-capacity one
89
+ without re-theming; the palette rides the layout pointer and the token contract
90
+ does the rest.
91
+
92
+ This is the durable design memory. Later sessions — and runtime agents
93
+ editing the live site — rebuild context from this record, not from the chat
94
+ that produced it. Update it when a decision changes; delete rationale that
95
+ turned out to be wrong rather than layering contradictions.
96
+
97
+ ## When to re-derive
98
+
99
+ Re-read the direction whenever adapting starters, replacing sample copy, or
100
+ choosing imagery — it decides wording, image mood, and which optional
101
+ sections earn a place, not just the theme choice. Re-derive it only when the
102
+ product story changes (new audience, new job, a pivot in the spec). A
103
+ direction that changes with every task was never a direction.
104
+
105
+ ## Identity preservation
106
+
107
+ The reflex-reject lists in [typography.md](typography.md) and the slop tests
108
+ apply to **new** design choices. When the site has already committed to a
109
+ font, palette, or lane as part of its shipped identity, identity-preservation
110
+ wins — don't second-guess what's live on every edit. Record the commitment in
111
+ `DESIGN.md` and defend it.
112
+
113
+ ---
114
+
115
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,84 @@
1
+ # Imagery
2
+
3
+ Content sites lean on imagery. A restaurant, hotel, travel, food, fashion,
4
+ product, or portfolio site without imagery reads as incomplete, not
5
+ restrained — a solid-color rectangle where a hero photo should go is worse
6
+ than a good stock photograph. **When the brief implies imagery, ship
7
+ imagery.** Zero images is a bug, not a design choice.
8
+
9
+ "Imagery" is broader than photography: product screenshots, real data
10
+ visualizations, credible SVG scenes, and canvas work all count. Text-only
11
+ pages where typography carries everything are the failure mode unless the
12
+ direction explicitly chose a type-led lane.
13
+
14
+ ## Where images live in this starter
15
+
16
+ - **Real site assets belong in EmDash media**, using the ingest workflow in
17
+ `.agents/skills/raybase-astro-emdash-content-model/references/emdash-collections.md#ingesting-owner-assets`.
18
+ Fresh apps can seed hosted assets with `$media`; local files and live
19
+ databases use `pnpm --dir site exec emdash media upload <file> --alt "..."`.
20
+ That's what editors will manage after handoff.
21
+ - During build-out, sourced stock imagery is the legitimate stand-in — but it
22
+ must actually resolve (below), and every stock slot must be named in the site
23
+ plan's asset inventory as `stock stand-in`.
24
+ - Galley templates take image URLs and alt text through fields
25
+ (`data-dynamic-src`, `data-dynamic-alt`), so editors can replace imagery
26
+ without touching Liquid. Collection image fields hold EmDash media objects,
27
+ not bare URL strings.
28
+ - The durable ledger lives in the site plan's asset inventory: every image
29
+ slot is `owner-supplied`, `stock stand-in`, or `none`. `DESIGN.md` records
30
+ only deliberate decisions, such as shipping a hero as stock by owner choice.
31
+
32
+ ## The swap-in pass
33
+
34
+ Owner assets often arrive after build-out. When they do, walk the site plan's
35
+ asset inventory slot by slot:
36
+
37
+ 1. Ingest the owner asset through the content-model reference above.
38
+ 2. Replace the stock URL and alt text in the affected Galley
39
+ `data-dynamic-src` / `data-dynamic-alt` fields, or replace the media object
40
+ in the affected collection entries.
41
+ 3. Update the asset inventory status and record any deliberate design decision
42
+ in `DESIGN.md`.
43
+ 4. Re-run the browser check on the affected pages at mobile and desktop
44
+ widths.
45
+
46
+ ## Sourcing
47
+
48
+ - **Unsplash is the default** for greenfield stock: `https://images.unsplash.com/photo-{id}?auto=format&fit=crop&w=1600&q=80`. **Verify every URL resolves before shipping it** — fetch it or load it in the browser check. Guessed photo IDs look plausible and 404 as broken-image placeholders. Without a verification path, use fewer images you're confident in; never substitute colored `<div>`s.
49
+ - **Search for the brand's physical object, not the category**: "handmade pasta on a scratched wooden table" beats "Italian food"; "cypress trees above a limestone facade at dusk" beats "luxury hotel". The direction's scene sentence is the search brief.
50
+ - **One decisive photo beats five mediocre ones.** Hero imagery commits to a mood; padding an indecisive hero with more stock doesn't rescue it.
51
+ - Keep a consistent grade across the site: one mood, one light temperature. A warm-dusk hero above cool-blue office stock reads as assembled, not designed.
52
+
53
+ ## Text over images
54
+
55
+ Thin light text over a photo has unpredictable contrast. Use a scrim
56
+ (gradient or solid overlay at the palette's ink hue), a solid band, or place
57
+ the text off the image. Verify the real contrast in the browser at mobile
58
+ crop, not just desktop.
59
+
60
+ ## Alt text is part of the voice
61
+
62
+ "Coastal fettuccine, hand-cut, served on the terrace" beats "pasta dish".
63
+ Describe the information in the register of the site; `alt=""` only for
64
+ genuinely decorative images. Editors inherit your alt text as the example to
65
+ follow.
66
+
67
+ ## Performance and stability
68
+
69
+ - **Dimensions always**: explicit `width`/`height` or `aspect-ratio` on every image slot so layout never shifts while loading. Media blocks keep stable dimensions at every breakpoint.
70
+ - The hero/LCP image loads eagerly (`fetchpriority="high"`, no lazy); everything below the fold gets `loading="lazy"`.
71
+ - Responsive sizes: `srcset` + `sizes` for resolution switching; `<picture>` when the crop itself changes between mobile and desktop (art direction). For Unsplash, vary the `w=` parameter per source.
72
+ - Modern formats when practical (`auto=format` handles this for Unsplash); keep raster heroes ≤ ~300KB where achievable.
73
+
74
+ ## Never
75
+
76
+ - Zero imagery on an image-led brief; colored blocks where a hero photo belongs.
77
+ - Unverified image URLs; broken images at handoff.
78
+ - Hand-drawn / sketchy SVG scenes as fallback art — if the scene can't be rendered with real assets, ship no illustration.
79
+ - Decorative effects that hide the content: heavy overlays, aggressive hover zooms, images as texture over readable copy.
80
+ - Generic large rounded icons above every heading as imagery-substitute — that's template grammar, not art direction.
81
+
82
+ ---
83
+
84
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,69 @@
1
+ # Layout
2
+
3
+ Space is the most underused design tool. On a content site, layout is
4
+ composed at two levels: **page rhythm** (which sections, in what order, at
5
+ what pacing — the `{% render %}` composition of a page starter) and
6
+ **section structure** (the grid inside a Galley template). Both belong to
7
+ design, and the first matters more.
8
+
9
+ ## Page rhythm
10
+
11
+ - A page is a narrative: one dominant idea per fold, deliberate pacing, long scroll when the story earns it. Edit rhythm by reordering, adding, or removing `{% render %}` lines in the staged page starter — that is the layout tool, not new Astro components.
12
+ - Vary section shape. If every band is a centered heading over a 3-card grid, the page is monotonous no matter how polished each band is. Alternate full-bleed and contained, image-led and type-led, dense and airy.
13
+ - **Vary spacing for rhythm**: tight within groups, generous between sections (48–96px and up on marketing pages, fluid via `clamp()` so separations breathe on large viewports).
14
+ - For image-led briefs (hotels, restaurants, portfolios, travel), a full-bleed hero photograph with overlaid nav and a committed headline is a canonical move — let the photograph be the design ([imagery.md](imagery.md)).
15
+
16
+ ## Hierarchy
17
+
18
+ Run the squint test: blur your eyes — can you still spot the most important
19
+ element, the second, and the groupings? Strong hierarchy combines 2–3
20
+ dimensions at once; a heading that is larger, bolder, *and* has more space
21
+ above it reads as primary without trying.
22
+
23
+ | Tool | Strong | Weak |
24
+ |------|--------|------|
25
+ | Size | 3:1 ratio+ | <2:1 |
26
+ | Weight | Bold vs Regular | Medium vs Regular |
27
+ | Color | high contrast | similar tones |
28
+ | Space | surrounded by whitespace | crowded |
29
+
30
+ Space alone can be enough — generous whitespace around one element draws the
31
+ eye. Asymmetric compositions and intentional grid-breaking for emphasis are
32
+ brand-register options; use them deliberately, not as a default to chase.
33
+
34
+ ## Structure inside sections
35
+
36
+ - **Flexbox for 1D** (nav rows, button groups, card internals), **Grid for 2D**. Don't reach for Grid when `flex-wrap` is simpler.
37
+ - Breakpointless responsive grids: `repeat(auto-fit, minmax(280px, 1fr))`.
38
+ - Spacing values come from a scale (4pt base: 4, 8, 12, 16, 24, 32, 48, 64, 96). Use `gap`, not margin hacks.
39
+ - One consistent, subtle shadow scale; semantic z-index scale (dropdown → sticky → backdrop → modal → toast → tooltip), never 999.
40
+ - Optical adjustments: geometrically centered glyphs often look off-center (play icons shift right); text at `margin-left: 0` looks indented — a −0.05em nudge optically aligns headings with edges. Adjust only what actually looks wrong.
41
+
42
+ ## Cards: use sparingly
43
+
44
+ Cards are the lazy answer. Spacing and alignment create grouping on their
45
+ own; use a card only when content is truly distinct and actionable. Never
46
+ nest cards. Break grid monotony by varying card sizes, spanning columns, or
47
+ mixing cards with non-card content — identical icon + heading + text cards
48
+ repeated endlessly are the tell.
49
+
50
+ ## Responsive behavior
51
+
52
+ - Mobile-first; content-driven breakpoints — stretch until the design breaks, break there. Three usually suffice (~640 / 768 / 1024).
53
+ - Sections must *compose* down, not shrink: a 3-column band becomes a deliberate single column, a table becomes stacked rows, an image-beside-text becomes image-above-text with the crop still working ([imagery.md](imagery.md)).
54
+ - Test the real heading copy at every width — long words + large clamps + narrow grids overflow. If it overflows, reduce the clamp max or rewrite the copy; the viewport is part of the design.
55
+ - Detect input, not just screen size: `@media (hover: hover)` before relying on hover; touch targets ≥ 44×44px; nothing reachable only by hover.
56
+ - Safe areas on notched phones: `padding-bottom: max(1rem, env(safe-area-inset-bottom))` with `viewport-fit=cover`.
57
+ - Never hide core content or navigation on mobile; never change the information architecture between breakpoints.
58
+
59
+ ## Never
60
+
61
+ - Arbitrary spacing off the scale; equal spacing everywhere (variety creates hierarchy).
62
+ - Everything in cards; cards in cards; identical card grids as the default band.
63
+ - The hero-metric template (big number, small label, gradient accent) as decoration.
64
+ - New Astro block components for ordinary content sections — layout changes go through Galley templates and page starters (galley skill).
65
+ - Text overflowing its container at any breakpoint.
66
+
67
+ ---
68
+
69
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,75 @@
1
+ # Motion
2
+
3
+ On a brand surface, motion is part of the voice. One well-orchestrated
4
+ entrance beats scattered micro-interactions — and some brands skip entrance
5
+ motion entirely; that restraint is also a voice. The saturated AI default is
6
+ an identical fade-and-rise on every scrolled section: that's a tell, not
7
+ choreography. Each reveal should fit what it reveals; suppressing the reflex
8
+ is never a reason to ship a page with no motion at all.
9
+
10
+ ## Use the starter's motion rails
11
+
12
+ Galley sections declare motion with `data-rb-motion` attributes;
13
+ `site/src/lib/site-motion.ts` drives them with the `motion` library. Do not
14
+ hand-roll scroll listeners or animation JS inside Liquid templates, and do
15
+ not treat `motion.strategy: "site-helper-v1"` as a missing sidecar — the
16
+ helper is the implementation.
17
+
18
+ - Presets: `fade-in`, `fade-up`, `slide-left`, `slide-right`, `scale-in`, `stagger-up`, `hero-reveal`, `hover-lift`.
19
+ - `data-rb-motion` goes on the section scope; `data-rb-motion-item` marks the staggered children for `stagger-up`.
20
+ - Tuning attributes: `data-rb-motion-duration` (seconds; default 0.5, `hero-reveal` 0.62), `data-rb-motion-stagger` (default 0.08), `data-rb-motion-delay`.
21
+ - The helper already handles the hard parts: it applies initial states from JS (no-JS and headless renders stay fully visible), triggers via `inView`, and **returns early under `prefers-reduced-motion`**. Never pre-hide content in CSS awaiting a reveal class — a reveal that doesn't fire ships a blank section.
22
+
23
+ ## Where motion belongs
24
+
25
+ - **The hero**: one committed entrance (`hero-reveal`) when the direction invites it — typographic choreography that earns its place.
26
+ - **One or two content bands** whose reveal means something (a portfolio grid staggering in, a menu list arriving). Not every section.
27
+ - **Feedback**: `hover-lift` on genuinely interactive cards/links; button and form feedback on the few interactive elements a site has.
28
+ - Island controls and forms: loading and success state transitions, 150–300ms.
29
+
30
+ ## Timing and easing
31
+
32
+ | Duration | Use |
33
+ |----------|-----|
34
+ | 100–150ms | instant feedback (press, toggle) |
35
+ | 200–300ms | state changes (menu, hover) |
36
+ | 300–500ms | section reveals, layout changes |
37
+ | 500–800ms | hero/entrance choreography only |
38
+
39
+ Exits run ~75% of entrance duration. Ease out with exponential curves — the
40
+ helper's default `[0.22, 1, 0.36, 1]` is ease-out-quint; no bounce, no
41
+ elastic, ever.
42
+
43
+ ## Materials
44
+
45
+ Transform and opacity are the reliable defaults, not the whole palette. Blur,
46
+ backdrop-filter, clip-path/mask wipes, and shadow/glow are legitimate when
47
+ they materially improve the effect and stay smooth. The hard rule: don't
48
+ casually animate layout-driving properties (`width`, `height`, `top`,
49
+ `left`, margins — use transforms, FLIP, or `grid-template-rows`), keep
50
+ expensive effects bounded to small areas, and verify smoothness in the
51
+ browser.
52
+
53
+ ## Performance
54
+
55
+ - `will-change` sparingly and only on known-expensive animations; never page-wide.
56
+ - Scroll triggering is the helper's job (it uses `inView` / IntersectionObserver); never scroll event listeners.
57
+ - Target 60fps on real viewports; a beautiful animation that janks is worse than none. Animation fatigue is real — spend the budget on the moments that need it.
58
+
59
+ ## Reduced motion
60
+
61
+ Not optional. The site helper covers `data-rb-motion` sections; any bespoke
62
+ CSS animation needs its own `@media (prefers-reduced-motion: reduce)`
63
+ alternative — typically a crossfade or instant transition.
64
+
65
+ ## Never
66
+
67
+ - The uniform reflex: one identical entrance applied to every section.
68
+ - Content hidden until a class-triggered transition reveals it.
69
+ - Bounce/elastic easing; decorative motion that conveys nothing; motion that blocks reading or scrolling.
70
+ - Hover animation on images (`scale`/`rotate` on `:hover` of a photo, directly or via a parent hover). If a card needs hover feedback, animate its background, border, or shadow — never the image.
71
+ - Hand-rolled animation JS in Liquid or new script sidecars where the site helper's presets suffice.
72
+
73
+ ---
74
+
75
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,75 @@
1
+ # Polish & Hardening
2
+
3
+ The final pass before handoff: the details that separate shipped from
4
+ polished, plus the hardening that makes the design survive real content.
5
+ Polish comes last — don't polish pages that aren't functionally complete —
6
+ but it is not optional. A clean automated check is never proof the design is
7
+ strong; browser evidence is.
8
+
9
+ ## Align before you decorate
10
+
11
+ Polish without alignment is decoration on top of drift:
12
+
13
+ 1. Re-read the Public Site section of `DESIGN.md` and the direction. Does every page still serve them? Are the signature moves intact, or sanded off by incremental edits?
14
+ 2. Name each deviation's root cause: a **palette/token gap** (extend the `[data-palette]` block), **off-rails styling** (a hardcoded value or one-off CSS that belongs on the token contract), or **composition drift** (a page whose rhythm no longer matches the direction — rework the `{% render %}` composition, not the paint).
15
+ 3. Sections that repeat across pages must look identical: same section, same treatment. If the same band renders differently on two pages, one of them is wrong.
16
+
17
+ ## The polish pass
18
+
19
+ Zoom in. Squint at it. Read the page like a first-time visitor.
20
+
21
+ **Visual**
22
+ - Spacing from the scale everywhere; section separations rhythmic, not uniform; optical alignment where geometry lies.
23
+ - Typography: same role, same treatment on every page; no widowed single words (`text-wrap: balance`/`pretty`); no FOUT reflow (metric-matched fallbacks — [typography.md](typography.md)).
24
+ - Color from the palette block only; contrast verified (4.5:1 body, 3:1 large/UI) in every palette the site exposes.
25
+ - Imagery: consistent grade, stable dimensions, scrims where text sits on photos ([imagery.md](imagery.md)).
26
+
27
+ **Interactive moments**
28
+ - The site's few interactive elements (nav, forms, island controls, menus) each design all their states: default, hover, focus-visible, active, disabled, loading, error, success. Keyboard path works; focus rings visible (never `outline: none` without a `:focus-visible` replacement); touch targets ≥ 44×44px.
29
+ - Dropdowns/menus positioned `absolute` inside `overflow: hidden` containers get clipped — use the Popover API, `position: fixed`, or a portal.
30
+ - Double-submit prevented on forms; island errors recoverable and specific.
31
+
32
+ **Content**
33
+ - Every page in the site plan renders real content: no sample copy, no lorem, no broken image URLs, no dead links, no empty data rails.
34
+ - Terminology, capitalization, punctuation consistent ([copy.md](copy.md)); titles and meta descriptions written.
35
+ - Stock placeholders awaiting owner assets are named in the handoff message.
36
+
37
+ ## Hardening against real content
38
+
39
+ The site's content comes from EmDash and will change after handoff. A design
40
+ that only survives the seed content isn't production-ready:
41
+
42
+ - **Editor-length text**: a 2× longer headline, a 100-character menu item name, an empty optional field. Truncate where truncation is right (`-webkit-line-clamp`), wrap where wrapping is right (`overflow-wrap: break-word`); flex/grid children need `min-width: 0` to shrink — the #1 cause of overflow.
43
+ - **Collection ranges**: 0 items, 1 item, 30 items through every `dataSources`-driven band. Empty rails show designed fallback content, not blank space.
44
+ - **Missing media**: an entry without an image must not break the band's grid.
45
+ - A failed `{% render %}` degrades to an HTML comment in production (galley skill) — verify no page depends on a template that isn't published.
46
+
47
+ ## Performance
48
+
49
+ Content sites are judged on arrival:
50
+
51
+ - Hero/LCP image eager with `fetchpriority="high"`; everything below the fold lazy; explicit dimensions everywhere (zero layout shift on load).
52
+ - Fonts: preload the critical weight only; `swap`/`optional` with metric fallbacks.
53
+ - No motion jank at 60fps on the target viewports; expensive effects bounded ([motion.md](motion.md)).
54
+ - No console errors; no unused script sidecars.
55
+
56
+ ## The checklist
57
+
58
+ - [ ] Direction and signature moves intact; deviations recorded in `DESIGN.md`
59
+ - [ ] On token rails: no hardcoded colors/fonts/radii in sections; palette verified per palette
60
+ - [ ] Typography roles consistent; no orphans; no font reflow
61
+ - [ ] Real content on every planned page; copy consistent; titles/meta written
62
+ - [ ] Imagery resolves, graded consistently, stable dimensions, alt text in voice
63
+ - [ ] Interactive states complete; keyboard + focus visible; 44px targets; forms recoverable
64
+ - [ ] Survives editor-length text, 0/1/many collection items, missing media
65
+ - [ ] No layout shift; LCP image eager; motion smooth; reduced-motion respected
66
+ - [ ] Browser-verified at ~320px, ~768px, and desktop — screenshots read, not just taken
67
+ - [ ] Hub skill's Browser Verification recipe passes end to end
68
+
69
+ Never perfect one page while leaving another rough — quality is consistent
70
+ across the site. If spacing is off everywhere, fix the token or the shared
71
+ section template, not one page.
72
+
73
+ ---
74
+
75
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,72 @@
1
+ # Typography
2
+
3
+ On a content site, typography carries most of the visual weight — often it
4
+ IS the design. The registry theme ships a deliberate type system; work within
5
+ it first. This file is for judging that system against the direction,
6
+ swapping fonts when the direction demands it, and building heading scales for
7
+ bespoke sections.
8
+
9
+ ## The starter's font rails
10
+
11
+ - Font choices live in generated palette CSS as `--app-font-sans`, `--app-font-serif`, `--app-font-mono`, and optionally `--app-font-display`. Galley sections and site components must reference these variables, never a literal family name — that's the token contract.
12
+ - Theme installation self-hosts declared fonts by writing `site/src/styles/palette-fonts.gen.css` and merging the palette's `@fontsource` packages into `site/package.json`. A custom app-local direction can still add packages manually, but durable registry themes should declare fonts in their palette metadata. Variable packages register as `"<Name> Variable"`; static `@fontsource/<font>` packages register as `"<Name>"` and import weight 400 only — add `/700.css` etc. for the weights you use.
13
+ - No Google Fonts `<link>` tags, no runtime font CDNs.
14
+
15
+ ## Font selection procedure
16
+
17
+ Run this whenever choosing or replacing a family. Never skip steps.
18
+
19
+ 1. Take the direction's three brand-voice words (physical-object words, not "modern"/"elegant").
20
+ 2. List the three fonts you'd reach for by reflex. If any appear in the reflex-reject list below, reject them — they are training-data defaults and they create monoculture.
21
+ 3. Browse a real catalog (Google Fonts for Fontsource-compatible picks, Fontsource's own index) with the three words in mind. Find the font for the brand as a *physical object*: a museum caption, a 1970s terminal manual, a fabric label, a concert poster, a mid-century diner receipt. Reject the first thing that "looks designy".
22
+ 4. Cross-check: "elegant" is not necessarily serif; "technical" is not necessarily sans or mono; "warm" is not Fraunces; a children's brand doesn't need a rounded display face. If the final pick matches the original reflex, start over.
23
+
24
+ ### Reflex-reject list
25
+
26
+ Training-data defaults for *new* choices (an existing shipped identity wins
27
+ — see [direction.md](direction.md)):
28
+
29
+ Fraunces · Newsreader · Lora · Crimson (all cuts) · Playfair Display ·
30
+ Cormorant (all cuts) · Syne · IBM Plex (all cuts) · Space Mono ·
31
+ Space Grotesk · Inter · DM Sans · DM Serif (all cuts) · Outfit ·
32
+ Plus Jakarta Sans · Instrument Sans · Instrument Serif
33
+
34
+ Also reject the saturated **editorial-typographic lane** as a default:
35
+ display serif (often italic) + small mono labels + ruled separators +
36
+ monochrome restraint. It's one aesthetic lane, valid when the brief is
37
+ literally editorial — not the house style of every brand site.
38
+
39
+ ## Pairing and voice
40
+
41
+ - A single well-chosen family with committed weight/size contrast beats a timid display+body pair. Add a second family only for genuine contrast: serif + sans, geometric + humanist, condensed display + wide body. Never pair fonts that are similar but not identical (two geometric sans-serifs).
42
+ - 2–3 families maximum, 3–4 weights maximum, and declare/load only the weights used.
43
+
44
+ ## Scale
45
+
46
+ - **Headings: fluid, committed.** Modular scale with ≥1.25 ratio between steps; flat scales (1.1×) read as uncommitted. Use `clamp(min, preferred, max)` with max ≤ ~2.5× min and a rem offset in the middle term. Hero ceiling: clamp max ≤ 6rem — above that the page is shouting.
47
+ - **Body: fixed.** ≥16px / 1rem, in `rem` (never `px`; never disable zoom). The size difference body needs across viewports is too small for fluid type.
48
+ - Measure 65–75ch (`max-width: 65ch`); scale container width and font size together so the measure holds at every viewport.
49
+ - Line-height: tight for headings (1.1–1.2), loose for body (1.5–1.7). Paragraph rhythm: space between paragraphs OR first-line indent, never both.
50
+ - **Light text on dark compensates on three axes**: line-height +0.05–0.1, letter-spacing +0.01–0.02em, and consider one weight notch down.
51
+
52
+ ## Details
53
+
54
+ - Display letter-spacing floor: ≥ −0.04em; −0.02 to −0.03em is plenty for tight display. ALL-CAPS labels need +0.05–0.12em tracking.
55
+ - `text-wrap: balance` on h1–h3; `text-wrap: pretty` on long prose to kill orphans.
56
+ - `font-variant-numeric: tabular-nums` for aligned numbers; `font-kerning: normal`; `font-optical-sizing: auto` for variable fonts.
57
+
58
+ ## Loading without layout shift
59
+
60
+ - `font-display: swap` plus a metric-matched fallback (`size-adjust`, `ascent-override`, `descent-override`) kills the reflow; tools like Fontaine compute overrides. Use `optional` when zero shift matters more than showing the brand font on a slow network.
61
+ - Preload only the critical weight (the body weight above the fold). For 3+ weights, a variable font file is usually smaller than three static files.
62
+
63
+ ## Never
64
+
65
+ - More than 2–3 families; body below 16px; display faces in body copy.
66
+ - All-caps body copy. Caps are for short labels and headings.
67
+ - Fluid body text, or heading clamps that overflow their container at any breakpoint (test the real copy).
68
+ - A hardcoded `font-family` in a Galley template or section component — it breaks every palette except the one it was written against.
69
+
70
+ ---
71
+
72
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).