@raybase/create 0.0.2 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (644) hide show
  1. package/LICENSE +21 -0
  2. package/THIRD_PARTY_NOTICES.md +38 -0
  3. package/assets/apple-touch-icons/0.png +0 -0
  4. package/assets/apple-touch-icons/1.png +0 -0
  5. package/assets/apple-touch-icons/2.png +0 -0
  6. package/assets/apple-touch-icons/3.png +0 -0
  7. package/assets/apple-touch-icons/4.png +0 -0
  8. package/assets/apple-touch-icons/5.png +0 -0
  9. package/assets/apple-touch-icons/6.png +0 -0
  10. package/assets/apple-touch-icons/7.png +0 -0
  11. package/assets/apple-touch-icons/8.png +0 -0
  12. package/assets/apple-touch-icons/9.png +0 -0
  13. package/assets/apple-touch-icons/A.png +0 -0
  14. package/assets/apple-touch-icons/B.png +0 -0
  15. package/assets/apple-touch-icons/C.png +0 -0
  16. package/assets/apple-touch-icons/D.png +0 -0
  17. package/assets/apple-touch-icons/E.png +0 -0
  18. package/assets/apple-touch-icons/F.png +0 -0
  19. package/assets/apple-touch-icons/G.png +0 -0
  20. package/assets/apple-touch-icons/H.png +0 -0
  21. package/assets/apple-touch-icons/I.png +0 -0
  22. package/assets/apple-touch-icons/J.png +0 -0
  23. package/assets/apple-touch-icons/K.png +0 -0
  24. package/assets/apple-touch-icons/L.png +0 -0
  25. package/assets/apple-touch-icons/M.png +0 -0
  26. package/assets/apple-touch-icons/N.png +0 -0
  27. package/assets/apple-touch-icons/O.png +0 -0
  28. package/assets/apple-touch-icons/P.png +0 -0
  29. package/assets/apple-touch-icons/Q.png +0 -0
  30. package/assets/apple-touch-icons/R.png +0 -0
  31. package/assets/apple-touch-icons/S.png +0 -0
  32. package/assets/apple-touch-icons/T.png +0 -0
  33. package/assets/apple-touch-icons/U.png +0 -0
  34. package/assets/apple-touch-icons/V.png +0 -0
  35. package/assets/apple-touch-icons/W.png +0 -0
  36. package/assets/apple-touch-icons/X.png +0 -0
  37. package/assets/apple-touch-icons/Y.png +0 -0
  38. package/assets/apple-touch-icons/Z.png +0 -0
  39. package/assets/apple-touch-icons/default.png +0 -0
  40. package/dist/.source-hash +1 -0
  41. package/dist/index.d.ts +56 -0
  42. package/dist/index.d.ts.map +1 -0
  43. package/dist/index.js +2351 -0
  44. package/dist/index.js.map +1 -0
  45. package/dist/raybase-package-ranges.d.ts +11 -0
  46. package/dist/raybase-package-ranges.d.ts.map +1 -0
  47. package/dist/raybase-package-ranges.js +11 -0
  48. package/dist/raybase-package-ranges.js.map +1 -0
  49. package/dist/source-fetch.d.ts +91 -0
  50. package/dist/source-fetch.d.ts.map +1 -0
  51. package/dist/source-fetch.js +325 -0
  52. package/dist/source-fetch.js.map +1 -0
  53. package/dist/source-hash.d.ts +2 -0
  54. package/dist/source-hash.d.ts.map +1 -0
  55. package/dist/source-hash.js +23 -0
  56. package/dist/source-hash.js.map +1 -0
  57. package/dist/starter-description.d.ts +44 -0
  58. package/dist/starter-description.d.ts.map +1 -0
  59. package/dist/starter-description.js +273 -0
  60. package/dist/starter-description.js.map +1 -0
  61. package/dist/starter-source.d.ts +43 -0
  62. package/dist/starter-source.d.ts.map +1 -0
  63. package/dist/starter-source.js +156 -0
  64. package/dist/starter-source.js.map +1 -0
  65. package/dist/store-app-apply.d.ts +27 -0
  66. package/dist/store-app-apply.d.ts.map +1 -0
  67. package/dist/store-app-apply.js +100 -0
  68. package/dist/store-app-apply.js.map +1 -0
  69. package/dist/store-app-manifest.d.ts +86 -0
  70. package/dist/store-app-manifest.d.ts.map +1 -0
  71. package/dist/store-app-manifest.js +110 -0
  72. package/dist/store-app-manifest.js.map +1 -0
  73. package/dist/store-app-registry.d.ts +30 -0
  74. package/dist/store-app-registry.d.ts.map +1 -0
  75. package/dist/store-app-registry.js +232 -0
  76. package/dist/store-app-registry.js.map +1 -0
  77. package/models/recommended.json +42 -0
  78. package/modules/api/templates/react-router/app/api/operations.ts +8 -0
  79. package/modules/api/templates/tanstack-start/src/api/operations.ts +15 -0
  80. package/modules/docs/templates/astro-emdash/content/docs/getting-started.mdx +13 -0
  81. package/modules/docs/templates/astro-emdash/content/docs/index.mdx +13 -0
  82. package/modules/docs/templates/astro-emdash/content/docs/mcp.mdx +11 -0
  83. package/modules/docs/templates/astro-emdash/content/docs/meta.json +4 -0
  84. package/modules/docs/templates/astro-emdash/site/content/docs/getting-started.mdx +12 -0
  85. package/modules/docs/templates/astro-emdash/site/content/docs/index.mdx +12 -0
  86. package/modules/docs/templates/astro-emdash/site/content/docs/mcp.mdx +10 -0
  87. package/modules/docs/templates/astro-emdash/site/content/docs/meta.json +4 -0
  88. package/modules/docs/templates/astro-emdash/site/source.config.ts +10 -0
  89. package/modules/docs/templates/astro-emdash/site/src/docs/docs-assets.ts +1 -0
  90. package/modules/docs/templates/astro-emdash/site/src/docs/docs-client.tsx +22 -0
  91. package/modules/docs/templates/astro-emdash/site/src/docs/docs-data.ts +24 -0
  92. package/modules/docs/templates/astro-emdash/site/src/docs/docs-handler.tsx +105 -0
  93. package/modules/docs/templates/astro-emdash/site/src/docs/docs-layout.tsx +56 -0
  94. package/modules/docs/templates/astro-emdash/site/src/docs/docs-mdx.tsx +79 -0
  95. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page-actions.tsx +146 -0
  96. package/modules/docs/templates/astro-emdash/site/src/docs/docs-page.tsx +70 -0
  97. package/modules/docs/templates/astro-emdash/site/src/docs/llm-text.ts +61 -0
  98. package/modules/docs/templates/astro-emdash/site/src/docs/source.ts +7 -0
  99. package/modules/docs/templates/astro-emdash/site/src/pages/docs/[...slug].ts +6 -0
  100. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/markdown.ts +4 -0
  101. package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/search.ts +4 -0
  102. package/modules/docs/templates/astro-emdash/site/src/pages/llms.txt.ts +8 -0
  103. package/modules/docs/templates/astro-emdash/site/src/styles-docs.css +3 -0
  104. package/modules/docs/templates/astro-emdash/source.config.ts +10 -0
  105. package/modules/docs/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
  106. package/modules/docs/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
  107. package/modules/docs/templates/astro-emdash/src/docs/docs-data.ts +24 -0
  108. package/modules/docs/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
  109. package/modules/docs/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
  110. package/modules/docs/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
  111. package/modules/docs/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
  112. package/modules/docs/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
  113. package/modules/docs/templates/astro-emdash/src/docs/llm-text.ts +61 -0
  114. package/modules/docs/templates/astro-emdash/src/docs/source.ts +7 -0
  115. package/modules/docs/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
  116. package/modules/docs/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
  117. package/modules/docs/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
  118. package/modules/docs/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
  119. package/modules/docs/templates/astro-emdash/src/routes/docs.tsx +22 -0
  120. package/modules/docs/templates/astro-emdash/src/styles-docs.css +3 -0
  121. package/modules/docs/templates/react-router/app/components/mdx.tsx +79 -0
  122. package/modules/docs/templates/react-router/app/lib/layout.shared.tsx +54 -0
  123. package/modules/docs/templates/react-router/app/lib/source.ts +7 -0
  124. package/modules/docs/templates/react-router/app/routes/docs.$.tsx +49 -0
  125. package/modules/docs/templates/react-router/app/routes/docs.api.search.ts +10 -0
  126. package/modules/docs/templates/react-router/app/routes/docs.tsx +13 -0
  127. package/modules/docs/templates/react-router/content/docs/getting-started.mdx +8 -0
  128. package/modules/docs/templates/react-router/content/docs/index.mdx +8 -0
  129. package/modules/docs/templates/react-router/content/docs/mcp.mdx +121 -0
  130. package/modules/docs/templates/react-router/content/docs/meta.json +4 -0
  131. package/modules/docs/templates/react-router/source.config.ts +5 -0
  132. package/modules/docs/templates/tanstack-start/content/docs/getting-started.mdx +10 -0
  133. package/modules/docs/templates/tanstack-start/content/docs/index.mdx +8 -0
  134. package/modules/docs/templates/tanstack-start/content/docs/mcp.mdx +121 -0
  135. package/modules/docs/templates/tanstack-start/content/docs/meta.json +4 -0
  136. package/modules/docs/templates/tanstack-start/source.config.ts +10 -0
  137. package/modules/docs/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
  138. package/modules/docs/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
  139. package/modules/docs/templates/tanstack-start/src/docs/docs-data.ts +24 -0
  140. package/modules/docs/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
  141. package/modules/docs/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
  142. package/modules/docs/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
  143. package/modules/docs/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
  144. package/modules/docs/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
  145. package/modules/docs/templates/tanstack-start/src/docs/llm-text.ts +61 -0
  146. package/modules/docs/templates/tanstack-start/src/docs/source.ts +7 -0
  147. package/modules/docs/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
  148. package/modules/docs/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
  149. package/modules/docs/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
  150. package/modules/docs/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
  151. package/modules/docs/templates/tanstack-start/src/routes/docs.tsx +22 -0
  152. package/modules/docs/templates/tanstack-start/src/styles-docs.css +3 -0
  153. package/modules/guide/templates/astro-emdash/content/guide/capability-map.md +17 -0
  154. package/modules/guide/templates/astro-emdash/src/components/guide-widget.tsx +41 -0
  155. package/modules/guide/templates/astro-emdash/src/guide/actions.ts +8 -0
  156. package/modules/guide/templates/astro-emdash/src/guide/config.ts +21 -0
  157. package/modules/guide/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
  158. package/modules/guide/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
  159. package/modules/guide/templates/astro-emdash/src/guide/corpus.ts +4 -0
  160. package/modules/guide/templates/astro-emdash/src/guide/resources.json +4 -0
  161. package/modules/guide/templates/react-router/app/components/guide-widget.tsx +29 -0
  162. package/modules/guide/templates/react-router/app/guide/actions.ts +3 -0
  163. package/modules/guide/templates/react-router/app/guide/config.ts +21 -0
  164. package/modules/guide/templates/react-router/app/guide/corpus.gen.ts +4 -0
  165. package/modules/guide/templates/react-router/app/guide/corpus.manifest.json +22 -0
  166. package/modules/guide/templates/react-router/app/guide/corpus.ts +4 -0
  167. package/modules/guide/templates/react-router/app/guide/resources.json +4 -0
  168. package/modules/guide/templates/react-router/content/guide/capability-map.md +13 -0
  169. package/modules/guide/templates/tanstack-start/content/guide/capability-map.md +17 -0
  170. package/modules/guide/templates/tanstack-start/src/components/guide-widget.tsx +41 -0
  171. package/modules/guide/templates/tanstack-start/src/guide/actions.ts +17 -0
  172. package/modules/guide/templates/tanstack-start/src/guide/config.ts +21 -0
  173. package/modules/guide/templates/tanstack-start/src/guide/corpus.gen.ts +4 -0
  174. package/modules/guide/templates/tanstack-start/src/guide/corpus.manifest.json +22 -0
  175. package/modules/guide/templates/tanstack-start/src/guide/corpus.ts +4 -0
  176. package/modules/guide/templates/tanstack-start/src/guide/resources.json +4 -0
  177. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  178. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  179. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  180. package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  181. package/modules/openai-subscription/templates/astro-emdash/src/openai-subscription.ts +11 -0
  182. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  183. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  184. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  185. package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  186. package/modules/openai-subscription/templates/react-router/app/openai-subscription.ts +11 -0
  187. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
  188. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
  189. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
  190. package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
  191. package/modules/openai-subscription/templates/tanstack-start/src/openai-subscription.ts +11 -0
  192. package/package.json +34 -8
  193. package/skills/README.md +122 -0
  194. package/skills/raybase-actions/SKILL.md +223 -0
  195. package/skills/raybase-actions/references/action-patterns.md +190 -0
  196. package/skills/raybase-actions/references/adapting-actions.md +93 -0
  197. package/skills/raybase-actions/references/testing-actions.md +48 -0
  198. package/skills/raybase-agent-debugging/SKILL.md +230 -0
  199. package/skills/raybase-ai/SKILL.md +1310 -0
  200. package/skills/raybase-api/SKILL.md +45 -0
  201. package/skills/raybase-astro-emdash/SKILL.md +143 -0
  202. package/skills/raybase-astro-emdash-content-model/SKILL.md +217 -0
  203. package/skills/raybase-astro-emdash-content-model/references/LICENSE-emdash +9 -0
  204. package/skills/raybase-astro-emdash-content-model/references/emdash-collections.md +265 -0
  205. package/skills/raybase-astro-emdash-design/LICENSE-impeccable +60 -0
  206. package/skills/raybase-astro-emdash-design/SKILL.md +170 -0
  207. package/skills/raybase-astro-emdash-design/reference/color.md +91 -0
  208. package/skills/raybase-astro-emdash-design/reference/copy.md +73 -0
  209. package/skills/raybase-astro-emdash-design/reference/direction.md +115 -0
  210. package/skills/raybase-astro-emdash-design/reference/imagery.md +84 -0
  211. package/skills/raybase-astro-emdash-design/reference/layout.md +69 -0
  212. package/skills/raybase-astro-emdash-design/reference/motion.md +75 -0
  213. package/skills/raybase-astro-emdash-design/reference/polish.md +75 -0
  214. package/skills/raybase-astro-emdash-design/reference/typography.md +72 -0
  215. package/skills/raybase-astro-emdash-galley/SKILL.md +265 -0
  216. package/skills/raybase-astro-emdash-migration/SKILL.md +218 -0
  217. package/skills/raybase-astro-emdash-migration/references/inventory-and-conversion.md +242 -0
  218. package/skills/raybase-astro-emdash-security-review/SKILL.md +68 -0
  219. package/skills/raybase-astro-emdash-theme-selection/SKILL.md +216 -0
  220. package/skills/raybase-auth/SKILL.md +358 -0
  221. package/skills/raybase-background-jobs/SKILL.md +774 -0
  222. package/skills/raybase-building/SKILL.md +409 -0
  223. package/skills/raybase-building/references/interview-and-spec.md +87 -0
  224. package/skills/raybase-building/references/planning-docs.md +26 -0
  225. package/skills/raybase-building/references/schema-and-config.md +70 -0
  226. package/skills/raybase-changing-a-live-app/SKILL.md +119 -0
  227. package/skills/raybase-data-and-policies/SKILL.md +377 -0
  228. package/skills/raybase-deploy/SKILL.md +136 -0
  229. package/skills/raybase-docs-writing/SKILL.md +119 -0
  230. package/skills/raybase-guide/SKILL.md +235 -0
  231. package/skills/raybase-mcp/SKILL.md +309 -0
  232. package/skills/raybase-mcp/agents/openai.yaml +4 -0
  233. package/skills/raybase-notifications/SKILL.md +138 -0
  234. package/skills/raybase-pro-migration/SKILL.md +28 -0
  235. package/skills/raybase-react-router/SKILL.md +241 -0
  236. package/skills/raybase-react-router-design/LICENSE-impeccable +60 -0
  237. package/skills/raybase-react-router-design/SKILL.md +135 -0
  238. package/skills/raybase-react-router-design/reference/color.md +87 -0
  239. package/skills/raybase-react-router-design/reference/copy.md +83 -0
  240. package/skills/raybase-react-router-design/reference/delight.md +48 -0
  241. package/skills/raybase-react-router-design/reference/interaction.md +91 -0
  242. package/skills/raybase-react-router-design/reference/layout.md +82 -0
  243. package/skills/raybase-react-router-design/reference/motion.md +86 -0
  244. package/skills/raybase-react-router-design/reference/polish.md +79 -0
  245. package/skills/raybase-react-router-design/reference/typography.md +71 -0
  246. package/skills/raybase-react-router-security-review/LICENSE +22 -0
  247. package/skills/raybase-react-router-security-review/SKILL.md +190 -0
  248. package/skills/raybase-react-router-security-review/agents/openai.yaml +4 -0
  249. package/skills/raybase-react-router-security-review/references/api-security.md +519 -0
  250. package/skills/raybase-react-router-security-review/references/authentication.md +353 -0
  251. package/skills/raybase-react-router-security-review/references/authorization.md +372 -0
  252. package/skills/raybase-react-router-security-review/references/business-logic.md +443 -0
  253. package/skills/raybase-react-router-security-review/references/cryptography.md +329 -0
  254. package/skills/raybase-react-router-security-review/references/csrf.md +398 -0
  255. package/skills/raybase-react-router-security-review/references/data-protection.md +378 -0
  256. package/skills/raybase-react-router-security-review/references/deserialization.md +410 -0
  257. package/skills/raybase-react-router-security-review/references/error-handling.md +436 -0
  258. package/skills/raybase-react-router-security-review/references/file-security.md +457 -0
  259. package/skills/raybase-react-router-security-review/references/injection.md +259 -0
  260. package/skills/raybase-react-router-security-review/references/logging.md +433 -0
  261. package/skills/raybase-react-router-security-review/references/misconfiguration.md +435 -0
  262. package/skills/raybase-react-router-security-review/references/modern-threats.md +475 -0
  263. package/skills/raybase-react-router-security-review/references/raybase-react-router-security.md +235 -0
  264. package/skills/raybase-react-router-security-review/references/ssrf.md +413 -0
  265. package/skills/raybase-react-router-security-review/references/supply-chain.md +405 -0
  266. package/skills/raybase-react-router-security-review/references/xss.md +336 -0
  267. package/skills/raybase-realtime/SKILL.md +158 -0
  268. package/skills/raybase-realtime/agents/openai.yaml +4 -0
  269. package/skills/raybase-schema/SKILL.md +209 -0
  270. package/skills/raybase-search/SKILL.md +137 -0
  271. package/skills/raybase-search/agents/openai.yaml +4 -0
  272. package/skills/raybase-settings/SKILL.md +139 -0
  273. package/skills/raybase-settings/agents/openai.yaml +4 -0
  274. package/skills/raybase-tanstack-start/SKILL.md +166 -0
  275. package/skills/raybase-tanstack-start-design/LICENSE-impeccable +60 -0
  276. package/skills/raybase-tanstack-start-design/SKILL.md +140 -0
  277. package/skills/raybase-tanstack-start-design/reference/color.md +80 -0
  278. package/skills/raybase-tanstack-start-design/reference/copy.md +83 -0
  279. package/skills/raybase-tanstack-start-design/reference/delight.md +48 -0
  280. package/skills/raybase-tanstack-start-design/reference/interaction.md +91 -0
  281. package/skills/raybase-tanstack-start-design/reference/layout.md +82 -0
  282. package/skills/raybase-tanstack-start-design/reference/motion.md +86 -0
  283. package/skills/raybase-tanstack-start-design/reference/polish.md +79 -0
  284. package/skills/raybase-tanstack-start-design/reference/typography.md +71 -0
  285. package/skills/raybase-tanstack-start-security-review/LICENSE +22 -0
  286. package/skills/raybase-tanstack-start-security-review/SKILL.md +194 -0
  287. package/skills/raybase-tanstack-start-security-review/agents/openai.yaml +4 -0
  288. package/skills/raybase-tanstack-start-security-review/references/api-security.md +519 -0
  289. package/skills/raybase-tanstack-start-security-review/references/authentication.md +353 -0
  290. package/skills/raybase-tanstack-start-security-review/references/authorization.md +372 -0
  291. package/skills/raybase-tanstack-start-security-review/references/business-logic.md +443 -0
  292. package/skills/raybase-tanstack-start-security-review/references/cryptography.md +329 -0
  293. package/skills/raybase-tanstack-start-security-review/references/csrf.md +398 -0
  294. package/skills/raybase-tanstack-start-security-review/references/data-protection.md +378 -0
  295. package/skills/raybase-tanstack-start-security-review/references/deserialization.md +410 -0
  296. package/skills/raybase-tanstack-start-security-review/references/error-handling.md +436 -0
  297. package/skills/raybase-tanstack-start-security-review/references/file-security.md +457 -0
  298. package/skills/raybase-tanstack-start-security-review/references/injection.md +259 -0
  299. package/skills/raybase-tanstack-start-security-review/references/logging.md +433 -0
  300. package/skills/raybase-tanstack-start-security-review/references/misconfiguration.md +435 -0
  301. package/skills/raybase-tanstack-start-security-review/references/modern-threats.md +475 -0
  302. package/skills/raybase-tanstack-start-security-review/references/raybase-tanstack-security.md +208 -0
  303. package/skills/raybase-tanstack-start-security-review/references/ssrf.md +413 -0
  304. package/skills/raybase-tanstack-start-security-review/references/supply-chain.md +405 -0
  305. package/skills/raybase-tanstack-start-security-review/references/xss.md +336 -0
  306. package/skills-manifest.json +41 -0
  307. package/templates/astro-emdash/.dev.vars.example +7 -0
  308. package/templates/astro-emdash/AGENTS.md +122 -0
  309. package/templates/astro-emdash/DESIGN.md +90 -0
  310. package/templates/astro-emdash/components.json +21 -0
  311. package/templates/astro-emdash/content/docs/getting-started.mdx +20 -0
  312. package/templates/astro-emdash/content/docs/index.mdx +13 -0
  313. package/templates/astro-emdash/content/docs/mcp.mdx +11 -0
  314. package/templates/astro-emdash/content/docs/meta.json +4 -0
  315. package/templates/astro-emdash/content/docs/site-templates.mdx +62 -0
  316. package/templates/astro-emdash/dev/CODEBASE-MAP.md +46 -0
  317. package/templates/astro-emdash/dev/SPEC-OVERVIEW.md +15 -0
  318. package/templates/astro-emdash/dev/SPEC.md +84 -0
  319. package/templates/astro-emdash/dev/features/archive/.gitkeep +1 -0
  320. package/templates/astro-emdash/docs/theme-previews/base.svg +24 -0
  321. package/templates/astro-emdash/docs/theme-previews/steel.svg +24 -0
  322. package/templates/astro-emdash/docs/theme-previews/zen.svg +24 -0
  323. package/templates/astro-emdash/docs/themes.md +106 -0
  324. package/templates/astro-emdash/drizzle.config.ts +5 -0
  325. package/templates/astro-emdash/gitignore +11 -0
  326. package/templates/astro-emdash/migrations/app/meta/_journal.json +5 -0
  327. package/templates/astro-emdash/package.json +79 -0
  328. package/templates/astro-emdash/pnpm-workspace.yaml +71 -0
  329. package/templates/astro-emdash/public/_headers +4 -0
  330. package/templates/astro-emdash/site/astro.config.mjs +120 -0
  331. package/templates/astro-emdash/site/demo/README.md +72 -0
  332. package/templates/astro-emdash/site/demo/content/collection.json +43 -0
  333. package/templates/astro-emdash/site/demo/content/entries.json +120 -0
  334. package/templates/astro-emdash/site/demo/templates/demo-article-card/manifest.json +51 -0
  335. package/templates/astro-emdash/site/demo/templates/demo-article-card/sample-content.json +5 -0
  336. package/templates/astro-emdash/site/demo/templates/demo-article-card/template.liquid +48 -0
  337. package/templates/astro-emdash/site/demo/templates/demo-article-page/host.json +9 -0
  338. package/templates/astro-emdash/site/demo/templates/demo-article-page/manifest.json +38 -0
  339. package/templates/astro-emdash/site/demo/templates/demo-article-page/sample-content.json +34 -0
  340. package/templates/astro-emdash/site/demo/templates/demo-article-page/template.liquid +84 -0
  341. package/templates/astro-emdash/site/demo/templates/demo-articles-index/manifest.json +64 -0
  342. package/templates/astro-emdash/site/demo/templates/demo-articles-index/page.json +7 -0
  343. package/templates/astro-emdash/site/demo/templates/demo-articles-index/sample-content.json +24 -0
  344. package/templates/astro-emdash/site/demo/templates/demo-articles-index/template.liquid +100 -0
  345. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/manifest.json +51 -0
  346. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/sample-content.json +5 -0
  347. package/templates/astro-emdash/site/demo/templates/demo-menu-nav/template.liquid +70 -0
  348. package/templates/astro-emdash/site/gitignore +1 -0
  349. package/templates/astro-emdash/site/package.json +56 -0
  350. package/templates/astro-emdash/site/scripts/apply-site-templates.mjs +560 -0
  351. package/templates/astro-emdash/site/scripts/galley-demo.mjs +298 -0
  352. package/templates/astro-emdash/site/scripts/seed-galley-starter.mjs +360 -0
  353. package/templates/astro-emdash/site/scripts/site-origin.mjs +45 -0
  354. package/templates/astro-emdash/site/seed/seed.json +154 -0
  355. package/templates/astro-emdash/site/seed/templates/.gitkeep +1 -0
  356. package/templates/astro-emdash/site/src/components/RaybaseSignedInMenu.astro +163 -0
  357. package/templates/astro-emdash/site/src/components/blocks/RaybaseActionIsland.astro +41 -0
  358. package/templates/astro-emdash/site/src/content-door/raybase-routes.ts +738 -0
  359. package/templates/astro-emdash/site/src/content-door/resolve-page.ts +142 -0
  360. package/templates/astro-emdash/site/src/content-door/seed.ts +85 -0
  361. package/templates/astro-emdash/site/src/env.d.ts +12 -0
  362. package/templates/astro-emdash/site/src/layouts/SiteLayout.astro +68 -0
  363. package/templates/astro-emdash/site/src/lib/palettes.gen.ts +7 -0
  364. package/templates/astro-emdash/site/src/lib/site-motion.ts +169 -0
  365. package/templates/astro-emdash/site/src/lib/site-shell.ts +294 -0
  366. package/templates/astro-emdash/site/src/live.config.ts +8 -0
  367. package/templates/astro-emdash/site/src/middleware.ts +20 -0
  368. package/templates/astro-emdash/site/src/pages/[...slug].astro +113 -0
  369. package/templates/astro-emdash/site/src/pages/_raybase/handoff/consume.ts +6 -0
  370. package/templates/astro-emdash/site/src/pages/_raybase/islands/action.ts +8 -0
  371. package/templates/astro-emdash/site/src/pages/_raybase/sign-out/index.ts +6 -0
  372. package/templates/astro-emdash/site/src/styles/palette-fonts.gen.css +1 -0
  373. package/templates/astro-emdash/site/src/styles/palettes.gen.css +3 -0
  374. package/templates/astro-emdash/site/src/styles.css +607 -0
  375. package/templates/astro-emdash/site/tsconfig.json +12 -0
  376. package/templates/astro-emdash/site/wrangler.jsonc +34 -0
  377. package/templates/astro-emdash/source.config.ts +10 -0
  378. package/templates/astro-emdash/src/actions.ts +58 -0
  379. package/templates/astro-emdash/src/ai/agents.ts +20 -0
  380. package/templates/astro-emdash/src/ai/retrieval.ts +36 -0
  381. package/templates/astro-emdash/src/auth-door.ts +18 -0
  382. package/templates/astro-emdash/src/client.tsx +25 -0
  383. package/templates/astro-emdash/src/components/.gitkeep +1 -0
  384. package/templates/astro-emdash/src/components/account-menu.tsx +91 -0
  385. package/templates/astro-emdash/src/components/auth-shell.tsx +69 -0
  386. package/templates/astro-emdash/src/components/mode-toggle.tsx +32 -0
  387. package/templates/astro-emdash/src/components/search-command-palette.tsx +107 -0
  388. package/templates/astro-emdash/src/components/setup-token-page.tsx +196 -0
  389. package/templates/astro-emdash/src/components/ui/avatar.tsx +107 -0
  390. package/templates/astro-emdash/src/components/ui/badge.tsx +52 -0
  391. package/templates/astro-emdash/src/components/ui/button.tsx +69 -0
  392. package/templates/astro-emdash/src/components/ui/checkbox.tsx +29 -0
  393. package/templates/astro-emdash/src/components/ui/dialog.tsx +158 -0
  394. package/templates/astro-emdash/src/components/ui/dropdown-menu.tsx +303 -0
  395. package/templates/astro-emdash/src/components/ui/input.tsx +20 -0
  396. package/templates/astro-emdash/src/components/ui/label.tsx +20 -0
  397. package/templates/astro-emdash/src/components/ui/scroll-area.tsx +53 -0
  398. package/templates/astro-emdash/src/components/ui/select.tsx +215 -0
  399. package/templates/astro-emdash/src/components/ui/separator.tsx +23 -0
  400. package/templates/astro-emdash/src/components/ui/sheet.tsx +138 -0
  401. package/templates/astro-emdash/src/components/ui/sidebar.tsx +728 -0
  402. package/templates/astro-emdash/src/components/ui/skeleton.tsx +13 -0
  403. package/templates/astro-emdash/src/components/ui/textarea.tsx +18 -0
  404. package/templates/astro-emdash/src/components/ui/tooltip.tsx +66 -0
  405. package/templates/astro-emdash/src/db/migrations.gen.ts +6 -0
  406. package/templates/astro-emdash/src/db/schema.ts +6 -0
  407. package/templates/astro-emdash/src/db/seed.ts +16 -0
  408. package/templates/astro-emdash/src/db/storage.ts +32 -0
  409. package/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
  410. package/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
  411. package/templates/astro-emdash/src/docs/docs-data.ts +24 -0
  412. package/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
  413. package/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
  414. package/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
  415. package/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
  416. package/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
  417. package/templates/astro-emdash/src/docs/llm-text.ts +61 -0
  418. package/templates/astro-emdash/src/docs/source.ts +7 -0
  419. package/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
  420. package/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
  421. package/templates/astro-emdash/src/hooks/use-mobile.ts +19 -0
  422. package/templates/astro-emdash/src/jobs.example.ts +48 -0
  423. package/templates/astro-emdash/src/lib/account.ts +12 -0
  424. package/templates/astro-emdash/src/lib/auth-client.ts +181 -0
  425. package/templates/astro-emdash/src/lib/utils.ts +6 -0
  426. package/templates/astro-emdash/src/mcp-app.ts +57 -0
  427. package/templates/astro-emdash/src/notifications.example.ts +37 -0
  428. package/templates/astro-emdash/src/raybase.auth.ts +70 -0
  429. package/templates/astro-emdash/src/raybase.config.ts +49 -0
  430. package/templates/astro-emdash/src/raybase.server.ts +56 -0
  431. package/templates/astro-emdash/src/realtime.example.ts +18 -0
  432. package/templates/astro-emdash/src/router.tsx +19 -0
  433. package/templates/astro-emdash/src/routes/__root.tsx +56 -0
  434. package/templates/astro-emdash/src/routes/_app/admin.tsx +13 -0
  435. package/templates/astro-emdash/src/routes/_app/forgot-password.tsx +97 -0
  436. package/templates/astro-emdash/src/routes/_app/index.tsx +169 -0
  437. package/templates/astro-emdash/src/routes/_app/invite.$token.tsx +11 -0
  438. package/templates/astro-emdash/src/routes/_app/login.tsx +193 -0
  439. package/templates/astro-emdash/src/routes/_app/profile.tsx +98 -0
  440. package/templates/astro-emdash/src/routes/_app/reset-password.$token.tsx +15 -0
  441. package/templates/astro-emdash/src/routes/_app/reset-password.tsx +115 -0
  442. package/templates/astro-emdash/src/routes/_app/setup.$token.tsx +11 -0
  443. package/templates/astro-emdash/src/routes/_app/signup.tsx +141 -0
  444. package/templates/astro-emdash/src/routes/_app/verify-email.$token.tsx +15 -0
  445. package/templates/astro-emdash/src/routes/_app/verify-email.tsx +154 -0
  446. package/templates/astro-emdash/src/routes/_app.tsx +33 -0
  447. package/templates/astro-emdash/src/routes/admin/$.ts +20 -0
  448. package/templates/astro-emdash/src/routes/api/$.ts +19 -0
  449. package/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
  450. package/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
  451. package/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
  452. package/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
  453. package/templates/astro-emdash/src/routes/docs.tsx +22 -0
  454. package/templates/astro-emdash/src/search.ts +6 -0
  455. package/templates/astro-emdash/src/settings.ts +12 -0
  456. package/templates/astro-emdash/src/styles-docs.css +3 -0
  457. package/templates/astro-emdash/src/styles.css +101 -0
  458. package/templates/astro-emdash/src/themes/base.css +76 -0
  459. package/templates/astro-emdash/src/themes/carbon.css +76 -0
  460. package/templates/astro-emdash/src/themes/fonts.css +25 -0
  461. package/templates/astro-emdash/src/themes/sage.css +76 -0
  462. package/templates/astro-emdash/src/themes/sand.css +76 -0
  463. package/templates/astro-emdash/src/themes/slate.css +81 -0
  464. package/templates/astro-emdash/src/themes/ultra.css +76 -0
  465. package/templates/astro-emdash/src/themes/zen.css +76 -0
  466. package/templates/astro-emdash/src/worker-entry.ts +31 -0
  467. package/templates/astro-emdash/tests/raybase-patterns.test.ts +29 -0
  468. package/templates/astro-emdash/tsconfig.json +36 -0
  469. package/templates/astro-emdash/vite.config.ts +130 -0
  470. package/templates/astro-emdash/vitest.config.ts +8 -0
  471. package/templates/astro-emdash/wrangler.jsonc +112 -0
  472. package/templates/react-router/.dev.vars.example +5 -0
  473. package/templates/react-router/.editorconfig +15 -0
  474. package/templates/react-router/AGENTS.md +54 -0
  475. package/templates/react-router/README.md +52 -0
  476. package/templates/react-router/app/app.css +44 -0
  477. package/templates/react-router/app/components/mdx.tsx +79 -0
  478. package/templates/react-router/app/components/ui/button.tsx +45 -0
  479. package/templates/react-router/app/components/ui/card.tsx +87 -0
  480. package/templates/react-router/app/components/ui/separator.tsx +22 -0
  481. package/templates/react-router/app/db/migrations.gen.ts +6 -0
  482. package/templates/react-router/app/db/schema.ts +56 -0
  483. package/templates/react-router/app/db/seed.ts +14 -0
  484. package/templates/react-router/app/entry.server.tsx +41 -0
  485. package/templates/react-router/app/globals.d.ts +1 -0
  486. package/templates/react-router/app/lib/layout.shared.tsx +52 -0
  487. package/templates/react-router/app/lib/source.ts +7 -0
  488. package/templates/react-router/app/lib/utils.ts +6 -0
  489. package/templates/react-router/app/raybase.server.ts +65 -0
  490. package/templates/react-router/app/root.tsx +23 -0
  491. package/templates/react-router/app/routes/_index.tsx +53 -0
  492. package/templates/react-router/app/routes/docs.$.tsx +49 -0
  493. package/templates/react-router/app/routes/docs.api.search.ts +10 -0
  494. package/templates/react-router/app/routes/docs.tsx +13 -0
  495. package/templates/react-router/app/routes.ts +3 -0
  496. package/templates/react-router/components.json +22 -0
  497. package/templates/react-router/content/docs/getting-started.mdx +15 -0
  498. package/templates/react-router/content/docs/index.mdx +8 -0
  499. package/templates/react-router/content/docs/mcp.mdx +121 -0
  500. package/templates/react-router/content/docs/meta.json +4 -0
  501. package/templates/react-router/dev/CODEBASE-MAP.md +48 -0
  502. package/templates/react-router/dev/SPEC-OVERVIEW.md +35 -0
  503. package/templates/react-router/dev/SPEC.md +93 -0
  504. package/templates/react-router/dev/features/archive/.gitkeep +1 -0
  505. package/templates/react-router/drizzle.config.ts +5 -0
  506. package/templates/react-router/env.d.ts +53 -0
  507. package/templates/react-router/gitignore +23 -0
  508. package/templates/react-router/migrations/app/meta/_journal.json +1 -0
  509. package/templates/react-router/package.json +70 -0
  510. package/templates/react-router/public/_headers +4 -0
  511. package/templates/react-router/public/favicon.ico +0 -0
  512. package/templates/react-router/react-router.config.ts +9 -0
  513. package/templates/react-router/source.config.ts +5 -0
  514. package/templates/react-router/tests/raybase-patterns.test.ts +23 -0
  515. package/templates/react-router/tsconfig.json +27 -0
  516. package/templates/react-router/vite.config.ts +59 -0
  517. package/templates/react-router/vitest.config.ts +8 -0
  518. package/templates/react-router/workers/app.ts +40 -0
  519. package/templates/react-router/wrangler.jsonc +111 -0
  520. package/templates/tanstack-start/.dev.vars.example +5 -0
  521. package/templates/tanstack-start/AGENTS.md +95 -0
  522. package/templates/tanstack-start/DESIGN.md +65 -0
  523. package/templates/tanstack-start/components.json +21 -0
  524. package/templates/tanstack-start/content/docs/getting-started.mdx +65 -0
  525. package/templates/tanstack-start/content/docs/index.mdx +10 -0
  526. package/templates/tanstack-start/content/docs/mcp.mdx +122 -0
  527. package/templates/tanstack-start/content/docs/meta.json +4 -0
  528. package/templates/tanstack-start/dev/CODEBASE-MAP.md +84 -0
  529. package/templates/tanstack-start/dev/SPEC-OVERVIEW.md +46 -0
  530. package/templates/tanstack-start/dev/SPEC.md +213 -0
  531. package/templates/tanstack-start/dev/features/archive/.gitkeep +1 -0
  532. package/templates/tanstack-start/docs/theme-previews/base.svg +24 -0
  533. package/templates/tanstack-start/docs/theme-previews/steel.svg +24 -0
  534. package/templates/tanstack-start/docs/theme-previews/zen.svg +24 -0
  535. package/templates/tanstack-start/docs/themes.md +116 -0
  536. package/templates/tanstack-start/drizzle.config.ts +5 -0
  537. package/templates/tanstack-start/gitignore +11 -0
  538. package/templates/tanstack-start/migrations/app/0000_low_karen_page.sql +26 -0
  539. package/templates/tanstack-start/migrations/app/meta/0000_snapshot.json +196 -0
  540. package/templates/tanstack-start/migrations/app/meta/_journal.json +13 -0
  541. package/templates/tanstack-start/package.json +77 -0
  542. package/templates/tanstack-start/public/_headers +8 -0
  543. package/templates/tanstack-start/public/icons/app-icon-maskable.svg +1 -0
  544. package/templates/tanstack-start/public/icons/app-icon.svg +1 -0
  545. package/templates/tanstack-start/public/icons/apple-touch-icon.png +0 -0
  546. package/templates/tanstack-start/public/manifest.webmanifest +14 -0
  547. package/templates/tanstack-start/public/raybase-push-sw.js +32 -0
  548. package/templates/tanstack-start/source.config.ts +10 -0
  549. package/templates/tanstack-start/src/actions.ts +560 -0
  550. package/templates/tanstack-start/src/ai/agents.ts +78 -0
  551. package/templates/tanstack-start/src/ai/retrieval.ts +36 -0
  552. package/templates/tanstack-start/src/auth-door.ts +18 -0
  553. package/templates/tanstack-start/src/client.tsx +25 -0
  554. package/templates/tanstack-start/src/components/.gitkeep +1 -0
  555. package/templates/tanstack-start/src/components/account-menu.tsx +127 -0
  556. package/templates/tanstack-start/src/components/auth-shell.tsx +69 -0
  557. package/templates/tanstack-start/src/components/install-app.tsx +35 -0
  558. package/templates/tanstack-start/src/components/mode-toggle.tsx +32 -0
  559. package/templates/tanstack-start/src/components/search-command-palette.tsx +107 -0
  560. package/templates/tanstack-start/src/components/setup-token-page.tsx +197 -0
  561. package/templates/tanstack-start/src/components/ui/avatar.tsx +107 -0
  562. package/templates/tanstack-start/src/components/ui/badge.tsx +52 -0
  563. package/templates/tanstack-start/src/components/ui/button.tsx +69 -0
  564. package/templates/tanstack-start/src/components/ui/checkbox.tsx +29 -0
  565. package/templates/tanstack-start/src/components/ui/dialog.tsx +158 -0
  566. package/templates/tanstack-start/src/components/ui/dropdown-menu.tsx +303 -0
  567. package/templates/tanstack-start/src/components/ui/input.tsx +20 -0
  568. package/templates/tanstack-start/src/components/ui/label.tsx +20 -0
  569. package/templates/tanstack-start/src/components/ui/scroll-area.tsx +53 -0
  570. package/templates/tanstack-start/src/components/ui/select.tsx +215 -0
  571. package/templates/tanstack-start/src/components/ui/separator.tsx +23 -0
  572. package/templates/tanstack-start/src/components/ui/sheet.tsx +138 -0
  573. package/templates/tanstack-start/src/components/ui/sidebar.tsx +728 -0
  574. package/templates/tanstack-start/src/components/ui/skeleton.tsx +13 -0
  575. package/templates/tanstack-start/src/components/ui/textarea.tsx +18 -0
  576. package/templates/tanstack-start/src/components/ui/tooltip.tsx +66 -0
  577. package/templates/tanstack-start/src/db/migrations.gen.ts +6 -0
  578. package/templates/tanstack-start/src/db/schema.ts +90 -0
  579. package/templates/tanstack-start/src/db/seed.ts +106 -0
  580. package/templates/tanstack-start/src/db/storage.ts +32 -0
  581. package/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
  582. package/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
  583. package/templates/tanstack-start/src/docs/docs-data.ts +24 -0
  584. package/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
  585. package/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
  586. package/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
  587. package/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
  588. package/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
  589. package/templates/tanstack-start/src/docs/llm-text.ts +61 -0
  590. package/templates/tanstack-start/src/docs/source.ts +7 -0
  591. package/templates/tanstack-start/src/hooks/use-mobile.ts +19 -0
  592. package/templates/tanstack-start/src/hooks/use-pwa-install.ts +77 -0
  593. package/templates/tanstack-start/src/jobs.example.ts +56 -0
  594. package/templates/tanstack-start/src/lib/account.ts +13 -0
  595. package/templates/tanstack-start/src/lib/auth-client.ts +187 -0
  596. package/templates/tanstack-start/src/lib/push-client.ts +98 -0
  597. package/templates/tanstack-start/src/lib/utils.ts +6 -0
  598. package/templates/tanstack-start/src/mcp-app.ts +74 -0
  599. package/templates/tanstack-start/src/notifications.example.ts +37 -0
  600. package/templates/tanstack-start/src/raybase.auth.ts +86 -0
  601. package/templates/tanstack-start/src/raybase.config.ts +86 -0
  602. package/templates/tanstack-start/src/raybase.server.ts +155 -0
  603. package/templates/tanstack-start/src/realtime.example.ts +46 -0
  604. package/templates/tanstack-start/src/router.tsx +19 -0
  605. package/templates/tanstack-start/src/routes/__root.tsx +73 -0
  606. package/templates/tanstack-start/src/routes/_app/admin.tsx +13 -0
  607. package/templates/tanstack-start/src/routes/_app/forgot-password.tsx +97 -0
  608. package/templates/tanstack-start/src/routes/_app/index.tsx +1316 -0
  609. package/templates/tanstack-start/src/routes/_app/invite.$token.tsx +11 -0
  610. package/templates/tanstack-start/src/routes/_app/login.tsx +193 -0
  611. package/templates/tanstack-start/src/routes/_app/profile.tsx +98 -0
  612. package/templates/tanstack-start/src/routes/_app/reset-password.$token.tsx +16 -0
  613. package/templates/tanstack-start/src/routes/_app/reset-password.tsx +115 -0
  614. package/templates/tanstack-start/src/routes/_app/setup.$token.tsx +11 -0
  615. package/templates/tanstack-start/src/routes/_app/signup.tsx +141 -0
  616. package/templates/tanstack-start/src/routes/_app/verify-email.$token.tsx +15 -0
  617. package/templates/tanstack-start/src/routes/_app/verify-email.tsx +154 -0
  618. package/templates/tanstack-start/src/routes/_app.tsx +33 -0
  619. package/templates/tanstack-start/src/routes/admin/$.ts +20 -0
  620. package/templates/tanstack-start/src/routes/api/$.ts +19 -0
  621. package/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
  622. package/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
  623. package/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
  624. package/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
  625. package/templates/tanstack-start/src/routes/docs.tsx +22 -0
  626. package/templates/tanstack-start/src/search.ts +26 -0
  627. package/templates/tanstack-start/src/settings.ts +12 -0
  628. package/templates/tanstack-start/src/styles-docs.css +3 -0
  629. package/templates/tanstack-start/src/styles.css +73 -0
  630. package/templates/tanstack-start/src/themes/base.css +76 -0
  631. package/templates/tanstack-start/src/themes/carbon.css +76 -0
  632. package/templates/tanstack-start/src/themes/fonts.css +18 -0
  633. package/templates/tanstack-start/src/themes/sage.css +76 -0
  634. package/templates/tanstack-start/src/themes/sand.css +76 -0
  635. package/templates/tanstack-start/src/themes/slate.css +76 -0
  636. package/templates/tanstack-start/src/themes/ultra.css +76 -0
  637. package/templates/tanstack-start/src/themes/zen.css +76 -0
  638. package/templates/tanstack-start/src/worker-entry.ts +30 -0
  639. package/templates/tanstack-start/tests/raybase-patterns.test.ts +247 -0
  640. package/templates/tanstack-start/tsconfig.json +33 -0
  641. package/templates/tanstack-start/vite.config.ts +132 -0
  642. package/templates/tanstack-start/vitest.config.ts +8 -0
  643. package/templates/tanstack-start/wrangler.jsonc +112 -0
  644. package/README.md +0 -3
@@ -0,0 +1,87 @@
1
+ # Color
2
+
3
+ App UI color is semantic first and almost always restrained: tinted neutrals doing 90% of the work, one accent reserved for actions and state. Strategic color beats rainbow vomit; every color has a job.
4
+
5
+ ## Use OKLCH
6
+
7
+ Stop using HSL. OKLCH is perceptually uniform — equal lightness steps *look* equal. `oklch(L C H)`: lightness 0–100%, chroma ~0–0.4, hue 0–360. Build shade ramps by holding chroma + hue and varying lightness; **reduce chroma near white and black** (high chroma at extreme lightness looks garish).
8
+
9
+ The hue is a product decision, not a default. Don't reach for blue (~250) or warm orange (~60) by reflex — those are the saturated AI defaults. Equally, don't translate "warm/friendly" into the cream/sand near-white body background; that band (OKLCH L 0.84–0.97, C < 0.06, hue 40–100) is the most recognizable AI tell of all. Stay neutral or tint toward this app's own accent.
10
+
11
+ ## Palette structure
12
+
13
+ | Role | Purpose | Shape |
14
+ |------|---------|-------|
15
+ | **Accent** | primary actions, selection, focus, links | 1 hue, 3–5 shades |
16
+ | **Neutral** | text, backgrounds, borders | 9–11 shade ramp, tinted toward the accent |
17
+ | **Semantic** | success / error / warning / info | 4 hues, 2–3 shades each |
18
+ | **Surface** | page bg, cards, overlays, panels | 2–3 elevation levels |
19
+
20
+ - **Tinted neutrals:** pure gray is dead next to a colored accent. Add 0.005–0.015 chroma toward *this app's* accent hue to every neutral — unconsciously cohesive, never reads as "tinted". Don't tint warm or cool by formula.
21
+ - **A second neutral layer** for sidebars, toolbars, and panels — slightly lighter/darker than the content surface — separates chrome from content without borders everywhere.
22
+ - **Skip secondary/tertiary accents** unless the app genuinely needs them (e.g. data viz categories). One accent is almost always enough.
23
+ - **60-30-10 by visual weight:** ~60% neutral surfaces and whitespace, ~30% text/borders/secondary, ~10% accent. Accents work *because* they're rare.
24
+
25
+ ## Semantic state colors
26
+
27
+ Standardize the full vocabulary: hover, focus, active, disabled, selected, loading, error, warning, success, info. Same color always means the same thing — green is success everywhere or nowhere. Never rely on color alone (icons/labels too; 8% of men can't separate red/green).
28
+
29
+ ## Tokens, Tailwind, and the UI kit
30
+
31
+ Two layers: primitive (`--blue-500`-style ramps) and semantic (`--color-accent`, `--color-surface`, `--color-ink`). Components reference only the semantic layer; dark mode redefines only the semantic layer.
32
+
33
+ - In Tailwind v4, keep `@theme inline` in `app/app.css` as the utility mapping
34
+ layer: `--color-background: var(--background)`, and so on. Do not put
35
+ app-specific color values in `@theme inline`.
36
+ - The shadcn-style variables in the `:root` block of `app/app.css`
37
+ (`--background`, `--foreground`, `--card`, `--primary`, `--secondary`,
38
+ `--muted`, `--destructive`, `--border`, `--input`, `--ring`, each with its
39
+ `-foreground` pair where one exists) *are* the semantic layer — retheme those
40
+ variables to this app's palette and the UI kit follows. Keep one `:root`
41
+ block; a second bare `:root` block elsewhere is easy to lose in Tailwind v4's
42
+ cascade. When you add a token (an accent, a radius, a popover surface), add it
43
+ to `:root` and map it in `@theme inline`. Never ship the stock neutral palette
44
+ as the final theme.
45
+
46
+ ## Palettes & light/dark
47
+
48
+ The starter ships one neutral light palette and no theme presets, dark palette, or light/dark toggle. Choose the palette during the design pass and write it into `app/app.css`, keeping colors in OKLCH.
49
+
50
+ If the app needs dark mode, add a `.dark` block that redefines the same semantic variables, toggle the `.dark` class on `<html>`, and apply the saved choice before first paint (an inline script in `app/root.tsx`) so the page does not flash. The `/docs` layout passes `theme={{ enabled: false }}` to Fumadocs' `RootProvider`, so the docs site has no toggle of its own; if you turn it on, use the same `.dark` class so app pages and `/docs` agree. The default should follow the OS `prefers-color-scheme`. Check the primary clears AA in both modes (see below).
51
+
52
+ ## Contrast
53
+
54
+ | Content | AA minimum |
55
+ |---------|------------|
56
+ | Body text (and placeholders) | 4.5:1 |
57
+ | Large text (≥18px, or bold ≥14px) | 3:1 |
58
+ | UI components, icons, focus rings | 3:1 |
59
+
60
+ Commonly failing combos: light gray on white (the #1 fail), gray on any colored background (use a darker shade of that background's hue, or text-color transparency), yellow on white, thin light text on images. If contrast is even close, bump toward the ink end — light gray "for elegance" is the single biggest reason AI designs feel hard to read. Verify with a checker or DevTools, not your eyes.
61
+
62
+ ## Dark mode is not inverted light mode
63
+
64
+ | Light mode | Dark mode |
65
+ |------------|-----------|
66
+ | shadows for depth | lighter surfaces for depth |
67
+ | dark text on light | light text on dark — reduce weight slightly (e.g. 350) |
68
+ | vibrant accents | slightly desaturated accents |
69
+ | white backgrounds | brand-tinted near-black (oklch 12–18% L) or pure black |
70
+
71
+ Build a 3-step dark surface ramp (e.g. 15% / 20% / 25% lightness) using the accent's own hue at low chroma; elevation = lighter, not shadowed.
72
+
73
+ ## Alpha is a design smell
74
+
75
+ Heavy rgba/transparency usually means an incomplete palette: unpredictable contrast and inconsistency. Define explicit overlay/hover colors per surface. Exceptions: focus rings and momentary interactive states.
76
+
77
+ ## Never
78
+
79
+ - Accent color as decoration, or heavy saturation on inactive states.
80
+ - Gray text on colored backgrounds.
81
+ - More than 2–4 colors beyond neutrals; rainbow application without meaning.
82
+ - Purple-blue gradients; default-warm cream/sand backgrounds.
83
+ - Color as the only state indicator.
84
+
85
+ ---
86
+
87
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,83 @@
1
+ # UX Copy
2
+
3
+ Interface text is part of the design. Vague copy creates support tickets and abandonment; specific copy gets users through the task. Good UX writing is invisible — users understand immediately without noticing the words.
4
+
5
+ ## Principles
6
+
7
+ 1. **Be specific**: "Enter email" not "Enter value".
8
+ 2. **Be concise**: cut every sentence in half, then again.
9
+ 3. **Be active**: "Save changes" not "Changes will be saved".
10
+ 4. **Be human**, not system-flavored — but never cute during errors.
11
+ 5. **Tell users what to do**, not just what happened.
12
+ 6. **Be consistent**: one term per concept, everywhere.
13
+
14
+ ## Buttons
15
+
16
+ Never "OK", "Submit", or "Yes/No". Verb + object:
17
+
18
+ | Bad | Good | Why |
19
+ |-----|------|-----|
20
+ | OK | Save changes | says what happens |
21
+ | Submit | Create account | outcome-focused |
22
+ | Yes | Delete message | confirms the action |
23
+ | Cancel | Keep editing | clarifies what cancel means |
24
+ | Click here | Download PDF | describes the destination |
25
+
26
+ For destructive actions, name the destruction and show the count: "Delete 5 items", not "Remove selected".
27
+
28
+ ## Error messages
29
+
30
+ Every error answers three questions: what happened, why, how to fix it.
31
+
32
+ | Situation | Template |
33
+ |-----------|----------|
34
+ | Format error | "[Field] needs to be [format]. Example: [example]" |
35
+ | Missing required | "Please enter [what's missing]" |
36
+ | Permission denied | "You don't have access to [thing]. [What to do instead]" |
37
+ | Network error | "We couldn't reach [thing]. Check your connection and [action]." |
38
+ | Server error | "Something went wrong on our end. We're looking into it. [Alternative action]" |
39
+
40
+ Don't blame the user: "Please enter a date in MM/DD/YYYY format", never "You entered an invalid date". **Never use humor for errors** — users are already frustrated; be helpful, not cute.
41
+
42
+ ## Empty states
43
+
44
+ Empty states are onboarding moments, not dead ends. Three parts: what will be here, why it's valuable, a clear action.
45
+
46
+ > No projects yet. Projects organize your work and your team's. **[Create your first project]**
47
+
48
+ Distinguish the types — first use (sell the value, offer a template), cleared by the user (light touch), no search results (suggest a different query, offer to clear filters), no permission (explain why, how to get access).
49
+
50
+ ## Loading and success
51
+
52
+ - Specific beats generic: "Saving your draft…" not "Loading…". For long waits, set expectations ("usually takes 30–60 seconds") or show progress.
53
+ - Success: confirm what happened and what's next, briefly. "Settings saved — changes take effect immediately."
54
+ - Loading copy that's specific to what the app actually does, never AI-filler whimsy ("Herding pixels…", "Teaching robots to dance…" are instantly recognizable machine copy).
55
+
56
+ ## Confirmation dialogs
57
+
58
+ Most are design failures — prefer undo (see [interaction.md](interaction.md)). When you must confirm: name the action and object, state the consequence, use specific button labels.
59
+
60
+ ## Voice and tone
61
+
62
+ Voice (the app's personality) stays constant; tone adapts to the moment:
63
+
64
+ | Moment | Tone |
65
+ |--------|------|
66
+ | Success | celebratory, brief |
67
+ | Error | empathetic, helpful |
68
+ | Loading | reassuring |
69
+ | Destructive confirm | serious, clear |
70
+
71
+ ## Consistency
72
+
73
+ Pick one term and enforce it everywhere — Delete *or* Remove, Settings *or* Preferences, Sign in *or* Log in, Create *or* Add. The same concept must use the same noun on every screen ("Workspace" here can't be "Project" three screens away). If the heading explains it, the intro is redundant; say it once.
74
+
75
+ ## Accessibility and translation
76
+
77
+ - Link text has standalone meaning: "View pricing plans", not "Click here".
78
+ - Alt text describes the information, not the image; `alt=""` for decoration. Icon-only buttons need `aria-label`.
79
+ - Leave room for translation: German runs ~+30%. No fixed widths on text containers; full sentences as single strings; no abbreviations ("5 minutes ago", not "5 mins ago").
80
+
81
+ ---
82
+
83
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,48 @@
1
+ # Delight
2
+
3
+ Delight is what turns a functional interface into one users remember and recommend. In app UI it lives at specific **moments** — completion, first-time actions, error recovery, milestones — not spread across pages. Reliability and consistency carry the rest of the experience; delight pushed everywhere reads as noise.
4
+
5
+ ## Principles
6
+
7
+ - **Amplifies, never blocks.** Delight moments are quick (<1s), skippable, and never delay core functionality. If users notice the delight more than their goal, it's gone too far.
8
+ - **Appropriate to context.** Celebrate success; empathize with errors; never be playful during a critical failure. An invoicing tool and a habit tracker have different licenses.
9
+ - **Compounds over time.** Vary responses so the 100th encounter still lands; reveal layers with continued use; don't announce every touch — let users discover some.
10
+ - **Earned, not defaulted.** One signature moment executed perfectly beats ten scattered flourishes.
11
+
12
+ ## Where delight belongs in an app
13
+
14
+ - **Completion**: a checkmark draw animation on save; a satisfying progress-bar finish; confetti reserved for genuinely major milestones (first deploy, 100th order — not every form submit).
15
+ - **First-time actions**: the first project, the first invite, the first import get slightly warmer treatment than the hundredth.
16
+ - **Empty states**: a touch of personality in the illustration or copy — see [copy.md](copy.md) for the structure.
17
+ - **Error recovery**: soften the moment; a helpful, human error message is itself a delight feature.
18
+ - **Micro-interactions**: a button that presses down 1–2px, a toggle that slides with weight, a checkbox with a subtle scale pulse. Felt, not seen.
19
+
20
+ ```css
21
+ .button { transition: transform 0.1s, box-shadow 0.1s; }
22
+ .button:hover { transform: translateY(-1px); }
23
+ .button:active { transform: translateY(1px); }
24
+ ```
25
+
26
+ - **Easter eggs** (lightest touch): a console message for developers, a keyboard shortcut that's a pleasure to find. Optional, never load-bearing.
27
+
28
+ ## Copy as delight
29
+
30
+ Personality lives cheaply in words — empty states, success toasts, loading messages — as long as it's *this product's* voice. Write loading and empty-state copy specific to what the app actually does ("Syncing your team's changes…"), never generic AI-filler whimsy ("Herding pixels…", "Consulting the magic 8-ball…").
31
+
32
+ ## Implementation notes
33
+
34
+ - CSS covers most of it. For orchestrated moments: Motion/Framer Motion, canvas-confetti, Lottie for illustrated animation.
35
+ - Sound is almost never right in a web app; if used, off by default and respectful of system settings.
36
+ - Everything here obeys [motion.md](motion.md): timing, easing, `prefers-reduced-motion`, and performance budgets apply to delight doubly.
37
+
38
+ ## Never
39
+
40
+ - Delay or hide core functionality for a flourish.
41
+ - Use delight to paper over poor UX.
42
+ - Make every interaction delightful — special moments stop being special.
43
+ - Repeat an unskippable celebration on every occurrence.
44
+ - Sacrifice performance or accessibility for it.
45
+
46
+ ---
47
+
48
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,91 @@
1
+ # Interaction
2
+
3
+ The difference between a screenshot and a product is interaction design: states, focus, keyboard paths, and overlays that don't break. The starter's UI kit is deliberately small and built on native elements (`<button>`, plain `<div>`s), so overlays, menus and comboboxes are yours to add: build them on native primitives that already carry the behavior (`<dialog>`, the Popover API, `<details>`, real `<button>`s and form controls), and make everything custom clear the same bar.
4
+
5
+ ## The eight states
6
+
7
+ Every interactive element designs all of these. Don't ship with half:
8
+
9
+ | State | When | Treatment |
10
+ |-------|------|-----------|
11
+ | Default | at rest | base styling |
12
+ | Hover | pointer over (not touch) | subtle lift, color shift |
13
+ | Focus | keyboard focus | visible ring (below) |
14
+ | Active | being pressed | pressed in, darker |
15
+ | Disabled | not interactive | reduced opacity, no pointer |
16
+ | Loading | processing | spinner in button, skeleton in content |
17
+ | Error | invalid | border + icon + message |
18
+ | Success | completed | confirmation |
19
+
20
+ The common miss: hover without focus, or vice versa. They're different — keyboard users never see hover states.
21
+
22
+ Disabled needs a *why*: when an element is disabled because a condition isn't met (form incomplete, missing permission, plan limit), say so nearby — helper text, an inline hint, or a tooltip. A silently disabled button is a frustration trap. Often the better design is to keep the button enabled and validate on submit — the error can explain; a disabled control can't, and it's invisible to keyboard and screen-reader users.
23
+
24
+ ## Focus rings
25
+
26
+ Never `outline: none` without a replacement. Use `:focus-visible` so rings appear for keyboard users only:
27
+
28
+ ```css
29
+ button:focus { outline: none; }
30
+ button:focus-visible { outline: 2px solid var(--color-accent); outline-offset: 2px; }
31
+ ```
32
+
33
+ 2–3px thick, offset outside the element, ≥3:1 contrast against adjacent colors, consistent across every interactive element.
34
+
35
+ ## Forms
36
+
37
+ - **Placeholders aren't labels** — they disappear on input. Always visible `<label>` elements.
38
+ - **Validate on blur**, not on every keystroke (exception: password strength). Errors below the field, connected with `aria-describedby`. Preserve user input on error.
39
+ - Show format expectations with placeholder examples; explain *why* you're asking when it isn't obvious.
40
+ - Prevent double-submission: disable the button while the request is in flight.
41
+ - Logical tab order; don't overuse autofocus.
42
+
43
+ ## Loading
44
+
45
+ - **Skeleton screens > spinners** — they preview content shape and feel faster. Spinners belong inside buttons, not in the middle of content.
46
+ - **Optimistic updates** for low-stakes actions (toggles, likes): show success immediately, roll back on failure. Never for payments or destructive actions.
47
+
48
+ ## Overlays without z-index wars
49
+
50
+ The single most common generated-code bug: a dropdown positioned `absolute` inside an `overflow: hidden/auto` container gets clipped. Escape routes, in order of preference:
51
+
52
+ 1. **Popover API** — `popover` attribute puts the element in the top layer (above everything, regardless of z-index or overflow), with light-dismiss and accessibility built in:
53
+
54
+ ```html
55
+ <button popovertarget="menu">Open</button>
56
+ <div id="menu" popover>…</div>
57
+ ```
58
+
59
+ 2. **Native `<dialog>`** — `dialog.showModal()` gives a focus trap, Escape handling, and a backdrop free. For everything behind a custom modal, the `inert` attribute blocks focus and clicks without JavaScript gymnastics.
60
+ 3. **Portal** — render at the document root (`createPortal(menu, document.body)`), position from the trigger's `getBoundingClientRect()` with `position: fixed`; recalculate on scroll/resize, flip when it would overflow the viewport edge.
61
+ 4. **CSS anchor positioning** (`position-anchor` + `position-area` + `@position-try`) where browser support allows, with a fallback elsewhere.
62
+
63
+ And remember the product rule: **modal as first thought is laziness.** Exhaust inline and progressive alternatives before reaching for a dialog at all.
64
+
65
+ ## Destructive actions: undo > confirm
66
+
67
+ Users click through confirmation dialogs mindlessly. Prefer: act immediately, show an undo toast, commit when it expires. Reserve confirmation for the truly irreversible or high-cost — and then name the object and the consequence ("Delete 'Project Alpha'? This can't be undone.") with specific button labels ("Delete project" / "Keep project", never "Yes" / "No").
68
+
69
+ ## Keyboard
70
+
71
+ - All functionality reachable by keyboard; visible focus along the way.
72
+ - **Roving tabindex** for composite widgets (tabs, menus, radio groups): one item `tabindex="0"`, the rest `-1`, arrow keys move within, Tab leaves the widget.
73
+ - Skip link (`<a href="#main-content">`) hidden until focused.
74
+ - Command palette (⌘K) is a power-user pattern apps can earn; show shortcut hints in tooltips and menus.
75
+
76
+ ## Touch and gestures
77
+
78
+ - Targets ≥ 44×44px (pad the hit area beyond the visual if needed).
79
+ - Gestures are invisible — anything reachable by swipe must also be reachable by a visible control.
80
+
81
+ ## Never
82
+
83
+ - Removing focus indicators without a replacement.
84
+ - Placeholder-only labels; generic error states.
85
+ - Touch targets under 44×44px.
86
+ - Custom controls without ARIA and keyboard support — if you can't fund the full behavior, use the native element.
87
+ - Hover as the only path to a function.
88
+
89
+ ---
90
+
91
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,82 @@
1
+ # Layout
2
+
3
+ Space is the most underused design tool. When an interface feels "off" even though colors and fonts are fine, the layout is usually the problem. In app UI, predictable grids, consistent densities, and familiar navigation patterns win — consistency IS an affordance.
4
+
5
+ ## Spacing system
6
+
7
+ - Every value comes from a scale; Tailwind's spacing scale is fine. A 4pt base (4, 8, 12, 16, 24, 32, 48, 64) beats 8pt — you'll constantly need 12px between 8 and 16.
8
+ - Use `gap` for sibling spacing instead of margins; no margin-collapse hacks.
9
+ - **Vary spacing for rhythm.** Equal padding everywhere = no hierarchy. Tight within groups (8–12px between related siblings), generous between sections (32–64px in app UI). Proximity is grouping: related elements close, distinct groups separated.
10
+
11
+ ## Hierarchy
12
+
13
+ Run the squint test: blur your eyes — can you still spot the most important element, the second, and the groupings? Strong hierarchy combines 2–3 dimensions at once; a heading that is larger, bolder, *and* has more space above it reads as primary without trying.
14
+
15
+ | Tool | Strong | Weak |
16
+ |------|--------|------|
17
+ | Size | 3:1 ratio+ | <2:1 |
18
+ | Weight | Bold vs Regular | Medium vs Regular |
19
+ | Color | high contrast | similar tones |
20
+ | Space | surrounded by whitespace | crowded |
21
+
22
+ Space alone can be enough — generous whitespace around an element draws the eye. Add color or size contrast only when simpler means aren't sufficient.
23
+
24
+ ## Structure
25
+
26
+ - **Flexbox for 1D** (toolbars, button rows, card internals), **Grid for 2D** (page shells, dashboards). Don't reach for Grid when `flex-wrap` is simpler.
27
+ - Breakpointless responsive grids: `repeat(auto-fit, minmax(280px, 1fr))`.
28
+ - Named grid areas (`grid-template-areas`) for page shells; redefine at breakpoints.
29
+ - **Container queries for components, viewport queries for pages.** A card in a narrow sidebar stays compact while the same card in the main column expands:
30
+
31
+ ```css
32
+ .card-container { container-type: inline-size; }
33
+ @container (min-width: 400px) {
34
+ .card { grid-template-columns: 120px 1fr; }
35
+ }
36
+ ```
37
+
38
+ - Match density to content: data-dense screens run tight, content screens breathe. Pick the app's density once and keep it.
39
+
40
+ ## Cards: use sparingly
41
+
42
+ Cards are the lazy answer. Spacing and alignment create grouping on their own; use a card only when content is truly distinct and actionable. Never nest cards inside cards — use spacing and dividers for internal hierarchy. Break grid monotony by varying card sizes or mixing cards with non-card content; identical icon + heading + text cards repeated endlessly are a tell.
43
+
44
+ ## Depth and stacking
45
+
46
+ - One consistent shadow scale (sm → md → lg), subtle, used to reinforce hierarchy — not decoration. In dark mode, depth comes from lighter surfaces, not shadows.
47
+ - Semantic z-index scale: dropdown → sticky → modal-backdrop → modal → toast → tooltip. Never arbitrary 999s.
48
+
49
+ ## Optical adjustments
50
+
51
+ - Geometrically centered glyphs often look off-center (play icons shift right, arrows shift toward their direction). Nudge only when you're confident it actually looks wrong.
52
+ - Text at `margin-left: 0` looks indented because of letterform whitespace; `-0.05em` negative margin optically aligns headings with edges.
53
+ - **Touch targets ≥ 44×44px** even when the visual is smaller — expand the hit area:
54
+
55
+ ```css
56
+ .icon-button { position: relative; }
57
+ .icon-button::before { content: ''; position: absolute; inset: -10px; }
58
+ ```
59
+
60
+ ## Responsive behavior
61
+
62
+ In app UI, responsiveness is **structural**, not fluid type: collapse the sidebar, turn the table into cards, drop from three columns to one.
63
+
64
+ - Mobile-first: base styles narrow, `min-width` queries layer complexity. Content-driven breakpoints — stretch until the design breaks, break there. Three usually suffice (~640 / 768 / 1024).
65
+ - **Detect input, not just screen size**: `@media (pointer: coarse)` for bigger touch targets, `@media (hover: hover)` before relying on hover. Touch users can't hover — never make hover the only path to a function.
66
+ - Desktop → mobile: single column, bottom-weighted controls (thumb reach), bottom sheets instead of dropdowns, progressive disclosure instead of everything-at-once. Tables → stacked cards (`display: block` + `data-label`).
67
+ - Mobile → desktop: use the width — persistent side nav, master-detail, denser tables — but cap content with `max-width`; don't stretch to 4K.
68
+ - Safe areas on notched phones: `padding-bottom: max(1rem, env(safe-area-inset-bottom))` with `viewport-fit=cover`.
69
+ - **Never hide core functionality on mobile.** If it matters, make it work.
70
+ - Test at 320px and at 200% zoom; the viewport is part of the design. DevTools emulation is a start, not proof.
71
+
72
+ ## Never
73
+
74
+ - Arbitrary spacing values outside the scale.
75
+ - All spacing equal — variety creates hierarchy.
76
+ - Everything wrapped in cards; cards nested in cards.
77
+ - The hero-metric template (big number, small label, gradient accent) as decoration. A prominent metric is fine when it's real user data.
78
+ - Different information architecture across breakpoints (confusing) or hover-only functionality.
79
+
80
+ ---
81
+
82
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,86 @@
1
+ # Motion
2
+
3
+ In app UI, motion conveys state — feedback, reveal, loading, transition — and nothing else. Users are in flow; don't make them wait for choreography. No orchestrated page-load sequences: the app loads into a task. Motion is part of the build, not an afterthought, but the budget is spent on the moments that need it.
4
+
5
+ ## Timing
6
+
7
+ | Duration | Use | Examples |
8
+ |----------|-----|----------|
9
+ | 100–150ms | instant feedback | button press, toggle, color change |
10
+ | 200–300ms | state changes | menu open, tooltip, hover |
11
+ | 300–500ms | layout changes | accordion, modal, drawer |
12
+
13
+ Most app transitions live at 150–250ms. Exits run faster than entrances (~75% of the enter duration). Never over 500ms for feedback — it reads as lag.
14
+
15
+ ## Easing
16
+
17
+ ```css
18
+ --ease-out-quart: cubic-bezier(0.25, 1, 0.5, 1); /* smooth */
19
+ --ease-out-quint: cubic-bezier(0.22, 1, 0.36, 1); /* snappier */
20
+ --ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1); /* confident */
21
+ ```
22
+
23
+ No bounce, no elastic — they feel dated and draw attention to the animation itself. Timing matters more than easing for "feels right".
24
+
25
+ ## What to animate
26
+
27
+ - **Feedback**: button press (quick scale 0.97 → 1), input focus, toggle slide, validation shake/check.
28
+ - **State transitions**: show/hide as fade + slight slide, expand/collapse via `grid-template-rows` or FLIP (not animating `height` directly), skeleton → content crossfade.
29
+ - **Reveals**: list-item stagger is legitimate — `animation-delay: calc(var(--i) * 50ms)` with `--i` per item — but cap total stagger ≈ 500ms (10 × 50ms; reduce per-item delay beyond that).
30
+ - Reveal animations must enhance an already-visible default. Never gate content visibility on a class-triggered transition — hidden tabs and headless renderers never fire it, and the section ships blank.
31
+
32
+ ## Motion materials
33
+
34
+ Transform and opacity are the reliable defaults, not the whole palette:
35
+
36
+ - **Transform / opacity** — movement, press feedback, simple reveals, list choreography.
37
+ - **Blur / backdrop-filter** — focus pulls, depth, softened entrances (bounded, verified smooth).
38
+ - **Clip-path / mask** — wipes and reveals.
39
+ - **Shadow / glow / color** — affordance, focus, active state.
40
+
41
+ The hard rule isn't "transform and opacity only" — it's: don't casually animate layout-driving properties (`width`, `height`, `top`, `left`, margins), keep expensive effects small or isolated, and verify smoothness in the browser.
42
+
43
+ ## Performance
44
+
45
+ - `will-change` sparingly, on known-expensive animations only (e.g. via a `:hover` or `.animating` class) — never page-wide.
46
+ - Scroll triggers: Intersection Observer, unobserve after firing once. Never scroll event listeners.
47
+ - Target 60fps on real devices; a beautiful animation that janks is worse than none.
48
+
49
+ ## Perceived performance
50
+
51
+ Nobody cares how fast it *is*, only how fast it feels. Under ~80ms feels instant — target that for micro-interactions.
52
+
53
+ - **Skeletons** preview content shape and feel faster than spinners.
54
+ - **Optimistic UI**: update immediately, roll back on failure — for low-stakes actions (toggles, likes), never payments or destructive operations.
55
+ - Show content progressively; don't wait for everything.
56
+ - Caution: a too-instant response can undersell complex operations (search, analysis); a brief, visible "working" state sometimes signals real work.
57
+
58
+ ## Reduced motion
59
+
60
+ Not optional. Every animation needs a `prefers-reduced-motion` alternative — typically a crossfade or instant transition:
61
+
62
+ ```css
63
+ @media (prefers-reduced-motion: reduce) {
64
+ * {
65
+ animation-duration: 0.01ms !important;
66
+ animation-iteration-count: 1 !important;
67
+ transition-duration: 0.01ms !important;
68
+ }
69
+ }
70
+ ```
71
+
72
+ ## Libraries
73
+
74
+ CSS transitions/keyframes cover most app needs. For orchestration or interactive motion, use a library (Motion/Framer Motion, GSAP) rather than hand-rolling — but a library is not a license to add more motion.
75
+
76
+ ## Never
77
+
78
+ - Decorative motion that conveys no state; animating everything (animation fatigue is real).
79
+ - Bounce/elastic easing; durations over 500ms for feedback.
80
+ - Casually animating layout properties when transform, FLIP, or grid techniques work.
81
+ - Blocking interaction during animation unless intentional.
82
+ - Skipping `prefers-reduced-motion`.
83
+
84
+ ---
85
+
86
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,79 @@
1
+ # Polish & Hardening
2
+
3
+ The final pass before a screen ships: the small details that separate good from great, plus the hardening that makes the design survive real data. Polish comes last — don't polish work that isn't functionally complete — but it is not optional.
4
+
5
+ ## Align before you decorate
6
+
7
+ Polish without alignment is decoration on top of drift. First, check the screen against the system:
8
+
9
+ 1. Re-read `DESIGN.md` and the shared components. Are tokens used, or hard-coded values? Shared components, or one-off reimplementations?
10
+ 2. Name each deviation's root cause: a **missing token** (add it to the system), a **one-off implementation** (swap to the shared component), or a **conceptual misalignment** (the flow/hierarchy doesn't match neighboring screens — rework the shape, not the paint).
11
+ 3. Flow shape counts as consistency: a multi-step action uses the same shape as comparable flows elsewhere (modal vs full page, inline edit vs route, save-on-blur vs explicit submit). A settings page exposing 40 fields when the rest of the app reveals 5 at a time is drift, even if every field is perfectly styled. Same nouns and verbs as the rest of the app.
12
+
13
+ ## The polish pass
14
+
15
+ Work the dimensions methodically; zoom in; squint at it; use it yourself.
16
+
17
+ **Visual**
18
+ - Everything aligns to the grid; all gaps from the spacing scale (no random 13px); optical alignment where geometry lies (icons, play buttons).
19
+ - Typography hierarchy consistent — same role, same treatment, every screen. No widowed single words on last lines (`text-wrap: balance/pretty`).
20
+ - All colors from tokens; contrast verified (4.5:1 body, 3:1 large/UI); works in every theme the app supports.
21
+ - Icons from one family, consistently sized, optically aligned with text.
22
+
23
+ **Interaction**
24
+ - Every interactive element has all eight states ([interaction.md](interaction.md)).
25
+ - All transitions 150–300ms, ease-out, 60fps, reduced-motion respected.
26
+ - Keyboard path works end-to-end; focus visible throughout; touch targets ≥44px.
27
+
28
+ **Content**
29
+ - Terminology, capitalization, and punctuation consistent ([copy.md](copy.md)). No typos. Empty, loading, error, and success states all present and written.
30
+ - Images: alt text, no layout shift (dimensions/aspect-ratio set), lazy-load below the fold.
31
+
32
+ **Code**
33
+ - No console errors or logs, no dead code, no leftover TODOs. New values promoted to tokens; custom reimplementations replaced with the shared component; duplication consolidated.
34
+
35
+ ## Hardening
36
+
37
+ A design that only works with perfect data isn't production-ready. Test against reality:
38
+
39
+ **Extreme inputs**
40
+ - Very long names/titles (100+ chars), single characters, emoji, RTL text.
41
+ - Truncation where it belongs: `text-overflow: ellipsis` for one line, `-webkit-line-clamp` for several, `overflow-wrap: break-word` where wrapping is right. Title attributes or tooltips preserve the full value.
42
+ - Flex/grid children need `min-width: 0` to shrink below content size — the #1 cause of overflowing layouts.
43
+ - Large numbers, 0 items, 1 item, 1,000+ items (paginate or virtualize — never render 10,000 rows).
44
+
45
+ **Every non-happy path**
46
+ - Empty (first-use, cleared, no-results, no-permission — each is different; see [copy.md](copy.md)).
47
+ - Loading (initial, pagination, refresh) and failed (network error with retry, 401 → login, 403 explained, 404 state, 500 with support path).
48
+ - Concurrent actions: double-click submit must not double-create; disable while in flight.
49
+ - One component erroring must not take down the screen.
50
+
51
+ **International by default**
52
+ - Logical properties (`margin-inline-start`, `padding-inline`) instead of left/right, so RTL works free.
53
+ - No fixed widths on text containers; budget +30% for translation.
54
+ - `Intl.DateTimeFormat` / `Intl.NumberFormat` for dates, numbers, currency — never hand-formatted.
55
+
56
+ ## Final verification
57
+
58
+ - **Use it yourself** — the real flow, not just the happy path.
59
+ - Screenshot at mobile (~375px), tablet, and desktop widths, and read the screenshots. Check 200% zoom.
60
+ - No layout shift on load; no jank during interaction.
61
+ - A clean automated check is never proof the design is strong — browser evidence is.
62
+
63
+ ## The checklist
64
+
65
+ - [ ] Aligned to DESIGN.md and shared components (drift resolved by root cause)
66
+ - [ ] Flow shape matches neighboring screens
67
+ - [ ] Spacing, color, type all from tokens; contrast verified
68
+ - [ ] All eight interaction states; keyboard path; focus visible; 44px targets
69
+ - [ ] Motion 150–300ms ease-out; reduced-motion respected
70
+ - [ ] Copy consistent; empty/loading/error/success states written and designed
71
+ - [ ] Long text, emoji, RTL, 0 / 1 / 1,000 items all survive
72
+ - [ ] Double-submit prevented; errors recoverable; no console errors
73
+ - [ ] Verified in the browser at three widths, by actually using it
74
+
75
+ Never: perfect one corner while leaving another rough — quality should be consistent. If spacing is off everywhere, fix the system, not one screen.
76
+
77
+ ---
78
+
79
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
@@ -0,0 +1,71 @@
1
+ # Typography
2
+
3
+ Typography carries most of the information in an app. The goal isn't to make text fancier — it's to make it clearer, more readable, and more intentional. Good typography is invisible; bad typography is distracting.
4
+
5
+ ## App-UI defaults
6
+
7
+ - **One family is usually right.** App UIs don't need display/body pairing. A well-tuned sans carries headings, buttons, labels, body, and data. Only add a second family for genuine contrast (e.g. a mono for code/data), never two similar sans-serifs.
8
+ - **Fixed `rem` scale, not fluid.** No major app design system (Material, Polaris, Primer, Carbon) uses fluid type in product UI. Fixed scales, optionally adjusted at 1–2 breakpoints, give the spatial predictability dense layouts need. (Fluid `clamp()` headings are for marketing pages; if the app has a public landing page, bound the clamp max ≤ ~2.5× min.)
9
+ - **Tight scale ratio: 1.125–1.2 between steps.** Apps have many type elements; exaggerated contrast creates noise.
10
+ - **System fonts are underrated.** `system-ui, -apple-system, "Segoe UI", sans-serif` looks native, loads instantly, and reads well. Legitimate whenever performance matters more than personality.
11
+ - A distinctive choice is still allowed — a characterful grotesque or humanist sans can be the app's signature — but it must stay quiet at 13–14px in a table cell.
12
+
13
+ ## Scale and hierarchy
14
+
15
+ The common mistake: too many sizes too close together (14, 15, 16, 18px = muddy hierarchy). **Use fewer sizes with more contrast.** Five sizes cover most apps:
16
+
17
+ | Role | Typical size | Use |
18
+ |------|--------------|-----|
19
+ | xs | 0.75rem | captions, badges, legal |
20
+ | sm | 0.875rem | secondary UI, table cells, metadata |
21
+ | base | 1rem | body text, inputs |
22
+ | lg | 1.125–1.25rem | section headings, dialog titles |
23
+ | xl | 1.5–2rem | page titles |
24
+
25
+ - Pick a ratio and commit. Hierarchy combines **size + weight + color + space** — don't rely on size alone.
26
+ - Weights: define clear roles and stick to them (e.g. regular body, medium labels, semibold headings). 3–4 weights maximum; Medium vs Regular is barely visible, so make weight contrasts real.
27
+ - Don't restyle the same role differently on two screens. Same role, same treatment.
28
+
29
+ ## Readability
30
+
31
+ - Body ≥ 16px / 1rem. Use `rem`, never `px`, so user font settings are respected. Never disable zoom.
32
+ - Prose: `max-width: 65ch`. Tables and dense UI can run wider.
33
+ - Line-height: tight for headings (1.1–1.2), loose for body (1.5–1.7). Narrow columns want tighter leading.
34
+ - **Light-on-dark text needs compensation on three axes**: bump line-height +0.05–0.1, add 0.01–0.02em letter-spacing, and consider dropping the weight one notch (light text on dark reads heavier than dark on light).
35
+ - `text-wrap: balance` on headings; `text-wrap: pretty` on long prose.
36
+
37
+ ## Details that separate good from great
38
+
39
+ - `font-variant-numeric: tabular-nums` on tables, timers, and any numbers that should align.
40
+ - ALL-CAPS labels need tracking: `letter-spacing: 0.05em`–`0.12em` on short uppercase labels.
41
+ - Display/page-title letter-spacing floor: ≥ −0.04em. Tighter and letters touch — cramped, not "designed". −0.02 to −0.03em is plenty.
42
+ - `font-variant-ligatures: none` in code blocks; `font-kerning: normal` everywhere.
43
+ - Name tokens semantically (`--text-body`, `--text-heading`), not by value (`--font-16`).
44
+
45
+ ## Web font loading
46
+
47
+ - `font-display: swap` plus a metric-matched fallback (`size-adjust`, `ascent-override`, `descent-override`) kills layout shift. Tools like Fontaine compute the overrides.
48
+ - `optional` instead of `swap` when zero layout shift matters more than seeing the brand font on slow networks.
49
+ - Preload only the critical weight (the body weight used above the fold).
50
+ - 3+ weights or styles → use a variable font; it's usually smaller than three static files.
51
+ - Load only the weights you use.
52
+
53
+ ## Fonts
54
+
55
+ The starter sets `font-family: ui-sans-serif, system-ui, sans-serif` on `body` in `app/app.css` and ships no web fonts. The system stack is a legitimate choice for app UI. If the design calls for a typeface, self-host it rather than loading it from a font CDN:
56
+
57
+ - `pnpm add @fontsource-variable/<font>` (a plain `install` only fetches already-declared deps), `@import` it in `app/app.css`, and point the body font — or a `--font-sans` token mapped in `@theme inline` — at the family.
58
+ - Variable packages register it as `"<Name> Variable"` (e.g. `"Inter Variable"`), not `"<Name>"`; static `@fontsource/<font>` packages use `"<Name>"` and need per-weight imports.
59
+ - Vite emits the font files to `build/client/assets/` and the Worker serves them from `/assets/`; check one loads (200, `font/woff2`) under `pnpm run preview` after changing fonts.
60
+
61
+ ## Never
62
+
63
+ - More than 2–3 font families.
64
+ - Sizes off the scale; body text below 16px.
65
+ - Display or decorative fonts in body text, labels, buttons, or data.
66
+ - Pairing fonts that are similar but not identical (two geometric sans-serifs).
67
+ - `user-scalable=no`.
68
+
69
+ ---
70
+
71
+ Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).