@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,138 @@
1
+ ---
2
+ name: raybase-notifications
3
+ description: Build Raybase notification feeds, outbound delivery adapters, inbound webhook callbacks, and notification evidence safely.
4
+ ---
5
+
6
+ # Raybase Notifications
7
+
8
+ Use notifications for alerts, reminders, mentions, approvals, job
9
+ completion/failure, support captures, external callbacks, and operator
10
+ escalation. Do not invent bespoke outbox tables, direct provider fetches, raw
11
+ websocket feeds, or ad hoc webhook receipt logs for these cases.
12
+
13
+ ## Model
14
+
15
+ - Feed items are user/operator-visible events. They are not workflow state. Keep
16
+ approvals, assignments, and business history in app tables; send feed items
17
+ as derived evidence with stable links back to those rows. A notification can
18
+ be delayed, retried, deduped, or skipped in local development, so the product
19
+ must not depend on it as the only copy of a business fact.
20
+ - Feed-only notifications need `appConfig.notifications.enabled: true` and no
21
+ queue.
22
+ - External channels use `defineNotifications()` and adapters, and require
23
+ `raybase jobs enable` so delivery retries run through Raybase queues.
24
+ - When `appConfig.auth.email.provider === "cloudflare"`, Raybase provides the
25
+ built-in `email` channel using Cloudflare Email Service. Read
26
+ `.agents/skills/raybase-auth/SKILL.md` before enabling auth or notification
27
+ email. Verified destination addresses are suitable only for operator/admin
28
+ notifications or intentional test sends, not for auth verification, password
29
+ reset, invites, welcome email, magic links, or public signup.
30
+ - Realtime feed updates use Raybase's realtime channel when available and HTTP
31
+ fallback otherwise. Do not create a custom websocket feed.
32
+
33
+ ## Send
34
+
35
+ ```ts
36
+ await ctx.notifications.send({
37
+ title: "Import finished",
38
+ body: "42 rows were imported.",
39
+ to: [notificationRecipient.role("operations")],
40
+ channels: ["feed"],
41
+ target: { href: `/imports/${run.id}`, entity: { type: "import_run", id: run.id } },
42
+ metadata: { runId: run.id, rows: 42 },
43
+ dedupeKey: `import:${run.id}:finished`,
44
+ throttle: { key: "import-finished", minInterval: "15 minutes" }
45
+ });
46
+ ```
47
+
48
+ Use stable `dedupeKey` values for retries, scheduled jobs, and external
49
+ callbacks: choose a dedupe key for "this exact event should be sent once ever".
50
+ Use `throttle` for "this notification stream should reach each user at most
51
+ once per interval". Throttle keys must be code literals, not model, request, or
52
+ action input. Replace hand-bucketed dedupe keys such as
53
+ `stream:${userId}:${YYYY-MM-DD-HH}` with a stable `throttle.key` plus
54
+ `minInterval`. Keep `metadata` small and non-secret. Use `channels` for
55
+ delivery intent and `target` for navigation/evidence.
56
+
57
+ For a notification that should open a grounded Agent conversation, target an
58
+ app-owned route using the documented deep-link convention:
59
+
60
+ ```ts
61
+ const result = await ctx.notifications.send({
62
+ title: "Your digest is ready",
63
+ body: "Open the digest to review the important items.",
64
+ channels: ["feed", "webpush"],
65
+ target: { href: "/assistant?agent=concierge&entry=digest" },
66
+ throttle: { key: "concierge-digest", minInterval: "4 hours" }
67
+ });
68
+ ```
69
+
70
+ When the route creates the conversation, pass the returned notification id as
71
+ `entry.notificationId`; do not copy notification or URL content into an inline
72
+ payload. Raybase verifies the current user is a recipient before giving the
73
+ Agent app-attributed notification context. See `raybase-ai` for the entry
74
+ declaration and hidden kickoff rules.
75
+
76
+ ## Adapters
77
+
78
+ ```ts
79
+ import { defineNotifications, webhookInboundAdapter, webhookOutboundAdapter } from "@raybase/core";
80
+
81
+ export const notifications = defineNotifications({
82
+ channels: {
83
+ slack: webhookOutboundAdapter({
84
+ channel: "slack",
85
+ name: "ops-slack",
86
+ url: (env) => env.SLACK_WEBHOOK_URL,
87
+ signingSecret: (env) => env.SLACK_WEBHOOK_SIGNING_SECRET
88
+ })
89
+ },
90
+ inbound: {
91
+ payments: webhookInboundAdapter({
92
+ name: "payments",
93
+ path: "/webhooks/payments",
94
+ signingSecret: (env) => env.PAYMENT_WEBHOOK_SECRET
95
+ })
96
+ }
97
+ });
98
+ ```
99
+
100
+ Pass `notifications` to `createRaybaseApp`. External sends are skipped in
101
+ local development by default and show as skipped delivery evidence. Use
102
+ `allowLocalSend: true` only in explicit local/test fixtures.
103
+
104
+ ## Web Push
105
+
106
+ Web Push is a reserved built-in channel. Feed remains the source of truth;
107
+ push is encrypted, best-effort, evidence-logged delivery to a user's active
108
+ devices. Enable it with `raybase webpush enable`, configure
109
+ `appConfig.notifications.webpush.enabled` plus a `mailto:` or `https:` VAPID
110
+ subject, run `raybase jobs enable`, store both generated VAPID values as Worker
111
+ secrets, and run `raybase doctor`.
112
+
113
+ Always pair Agent-reachable Web Push sends with a mechanical throttle whose key
114
+ is a code literal. Permission prompts must happen only after a user gesture,
115
+ never on initial page load. The TanStack helper and service worker are inert
116
+ when Web Push is disabled. Subscription management works in local development,
117
+ but delivery remains `skipped_local` unless `allowLocalSend: true` is explicitly
118
+ set for a localhost push test. Astro/EmDash public sites and apps embedded in
119
+ another platform's admin iframe do not support this v1 template wiring.
120
+
121
+ ## Security
122
+
123
+ - Secrets live in Worker env/secrets, never source, runtime settings, app rows,
124
+ docs, or prompt examples.
125
+ - Signed inbound webhooks are required before trusting provider payloads.
126
+ - Never impersonate users from webhook bodies. Resolve users/operators from
127
+ trusted app state or provider identity.
128
+ - Do not fetch Slack, Teams, email, SMS, or webhook providers directly when a
129
+ notification adapter exists. Use Raybase so retries, audit, and `/admin`
130
+ evidence stay intact.
131
+ Direct provider calls lose the delivery ledger that operators use to debug
132
+ retries and missed sends.
133
+ - Do not expose broad recipient lists, raw webhook URLs, auth headers, signing
134
+ secrets, or provider tokens in UI or logs.
135
+
136
+ Run `raybase doctor` after changing notification config. Fix notification and
137
+ Web Push key, subject, queue, service-worker, throttle, public-route,
138
+ route-shadow, local-send, and provider-bypass findings before deploy.
@@ -0,0 +1,28 @@
1
+ ---
2
+ name: raybase-pro-migration
3
+ description: Point Raybase Core app owners to the correct Pro upgrade skills and migration constraints.
4
+ ---
5
+
6
+ # Raybase Pro Migration Pointer
7
+
8
+ Use this skill when a Raybase core app owner asks about upgrading to Raybase Pro.
9
+
10
+ Raybase Pro can be installed while the product remains single-tenant. Do not assume Pro means multi-org.
11
+ That matters because the first migration changes identity and infrastructure
12
+ without changing the product's organization model. `org_default` is the
13
+ compatibility bridge that lets existing owner columns and `owns()` policies keep
14
+ working while users re-authenticate into Pro sessions.
15
+
16
+ Recommended next steps:
17
+
18
+ 1. Install or update the Raybase Pro package.
19
+ 2. In the app, run `raybase pro skills install`.
20
+ 3. Use the installed `raybase-core-to-pro-single` skill for a core-to-Pro infrastructure upgrade.
21
+ 4. Use `raybase-pro-single-to-multi` only later, when the app owner explicitly wants a multi-tenant product migration.
22
+
23
+ Important constraints:
24
+
25
+ - Core-to-Pro single upgrades must use `org_default`.
26
+ - Old sessions are not migrated; users and API clients must re-authenticate.
27
+ - App data owner columns should not be rewritten during the core-to-Pro migration.
28
+ - Multi-org conversion is a separate product and data-model migration.
@@ -0,0 +1,241 @@
1
+ ---
2
+ name: raybase-react-router
3
+ description: Build and change Raybase apps built on the react-router framework. Use with raybase-building for route layout, loaders and actions, the Worker entry that puts Raybase ahead of the router, React UI, local dev, and React Router-specific verification.
4
+ ---
5
+
6
+ # Raybase React Router Skill
7
+
8
+ Use this skill for projects whose `package.json` has
9
+ `raybase.framework: "react-router"`. The generic Raybase skills still own the
10
+ runtime rules: spec first, policies on every table, no custom auth, no raw R2,
11
+ no raw Workers AI, and no `unsafeDb`. This skill owns the React Router file
12
+ layout and framework seams.
13
+
14
+ ## Read Order
15
+
16
+ 1. Read `.agents/skills/raybase-building/SKILL.md` for the implementation
17
+ sequence.
18
+ 2. Read this skill before editing routes, components, loaders or actions,
19
+ `app/raybase.server.ts`, `workers/app.ts`, or generated app UI.
20
+ 3. Read `.agents/skills/raybase-react-router-design/SKILL.md` before
21
+ designing or restyling app screens.
22
+ 4. Run `.agents/skills/raybase-react-router-security-review/SKILL.md` before
23
+ marking the app ready.
24
+
25
+ If the project was created from an outside starter, also read the skills that
26
+ starter installed and its section of `AGENTS.md`; they describe what the
27
+ starter adds on top of the layout below.
28
+
29
+ ## How Requests Flow
30
+
31
+ One Cloudflare Worker serves both Raybase and the React Router app.
32
+ `workers/app.ts` checks each request with `isRaybaseRequest(url)` from
33
+ `app/raybase.server.ts`:
34
+
35
+ - Paths under the prefixes in `raybasePathPrefixes` (`/admin`, `/api`,
36
+ `/login`, `/signup`, `/setup`, `/invite`, the password-reset and
37
+ email-verification pages, `/mcp`, `/.well-known`) go to the Raybase handler.
38
+ - Everything else goes to React Router's `createRequestHandler`, with
39
+ `{ cloudflare: { env, ctx } }` as the load context, and the response passes
40
+ through `withRaybaseLocalDevChrome`, which adds Core's local dev chrome in
41
+ local development and does nothing elsewhere.
42
+
43
+ Consequences:
44
+
45
+ - Raybase owns sign-in, owner setup, invites, the admin panel, its API and MCP.
46
+ Do not build app routes for those pages, and do not create app routes under a
47
+ Raybase prefix: the router never sees them.
48
+ - App routes are not behind Raybase's auth wall. Every loader and action that
49
+ serves signed-in content must ask Raybase who is there (below).
50
+ - Do not add a path to `raybasePathPrefixes` unless Raybase actually serves it.
51
+
52
+ ## Important Paths
53
+
54
+ - `app/db/schema.ts` declares `appConfig` (app name, business roles, auth
55
+ signup mode, public routes, MCP, realtime, AI and feature config) and the app
56
+ tables and policies.
57
+ - `app/db/seed.ts` holds idempotent local demo data and seed variants.
58
+ - `app/raybase.server.ts` creates the Raybase runtime app (`createRaybaseApp`)
59
+ and registers config, schema, migrations, seed, search and modules. It also
60
+ exports `isRaybaseRequest`, `handleRaybaseRequest` and `currentUser`. Keep the
61
+ `raybase:modules:start` / `raybase:modules:end` markers; module installs edit
62
+ between them.
63
+ - `workers/app.ts` is the Cloudflare Worker entry. It must keep exporting
64
+ `RaybaseDatabaseObject`, `RaybaseAIChatAgentObject`, `default.fetch`, `queue`,
65
+ and `scheduled`.
66
+ - `app/routes.ts` uses `flatRoutes()` from `@react-router/fs-routes`;
67
+ `app/routes/` holds the route modules.
68
+ - `app/root.tsx` is the document shell. Keep the `raybase:guide-widget` markers;
69
+ enabling Guide mounts its widget there.
70
+ - `app/components/ui/` is the small Tailwind UI kit; `app/app.css` is the
71
+ Tailwind entry and holds its tokens.
72
+ - Raybase search indexes are declared in `app/raybase.server.ts` (`search`);
73
+ the starter has none until the app has tables to index.
74
+ - `app/guide/` and `app/components/guide-widget.tsx` hold Guide configuration
75
+ when Guide is enabled.
76
+ - `content/docs/` plus `app/routes/docs*.ts(x)` and `app/lib/source.ts` are the
77
+ docs site when Docs is enabled. Docs are public by default
78
+ (`Docs exposure: public`): the docs routes do not check sign-in. If the
79
+ builder chooses `Docs exposure: signed-in only`, add the `currentUser()`
80
+ check to the loaders of `docs.tsx`, `docs.$.tsx` and `docs.api.search.ts`
81
+ (redirect pages to `/login`, answer search with 401).
82
+ - `env.d.ts` holds hand-maintained Worker `Env` types. Keep it in sync with
83
+ `wrangler.jsonc` vars and bindings and `.dev.vars`.
84
+ - `tests/raybase-patterns.test.ts` holds the starter's checks.
85
+
86
+ Generated files are not hand-edit targets. Do not edit
87
+ `app/db/migrations.gen.ts`, `.react-router/types/`, or `.source/` directly.
88
+
89
+ ## Routes, Loaders And Actions
90
+
91
+ - Route files follow `flatRoutes()` naming: `.` separates URL segments,
92
+ `$name` is a dynamic segment, a trailing `$` is a splat, `_index` is the
93
+ index route, and a parent file such as `projects.tsx` with `<Outlet />` is the
94
+ layout for `projects.*.tsx`. Examples in the starter: `_index.tsx`,
95
+ `docs.tsx`, `docs.$.tsx`, `docs.api.search.ts`.
96
+ - Loaders and actions run on the server, inside the Worker. Read bindings from
97
+ `context.cloudflare.env` and the execution context from
98
+ `context.cloudflare.ctx`. Never import `app/raybase.server.ts` or other
99
+ `*.server.ts` modules into code that runs in the browser.
100
+ - Gate signed-in pages in the loader, as `app/routes/_index.tsx` does:
101
+
102
+ ```ts
103
+ const user = await currentUser(request, context.cloudflare.env, context.cloudflare.ctx);
104
+ if (!user) throw redirect(`/login?next=${encodeURIComponent(new URL(request.url).pathname)}`);
105
+ ```
106
+
107
+ Repeat the check in every action; an action is a separate POST endpoint and
108
+ does not inherit the loader's check. Keep writes out of loaders: loaders run
109
+ on GET, including links and prefetches. React Router aborts an action whose
110
+ `Origin` names another origin (widen that only with `allowedActionOrigins` in
111
+ `react-router.config.ts`), and Raybase's session cookie is `SameSite=Lax`. `currentUser` returns
112
+ `{ id, name, email, isOperator }` from Raybase's `/api/account/me`.
113
+ - Read and change app data through Raybase so policies run as the signed-in
114
+ user, not through raw SQL. From a loader or action, call Raybase's own API
115
+ through `handleRaybaseRequest` with a `Request` built on the incoming URL that
116
+ carries the incoming `cookie` header, the same pattern `currentUser` uses:
117
+
118
+ ```ts
119
+ function toRaybase(request: Request, path: string, init: { method?: string; body?: unknown } = {}) {
120
+ const headers = new Headers({ accept: "application/json" });
121
+ for (const name of ["cookie", "origin", "referer"]) {
122
+ const value = request.headers.get(name);
123
+ if (value) headers.set(name, value);
124
+ }
125
+ if (init.body !== undefined) headers.set("content-type", "application/json");
126
+ return new Request(new URL(path, request.url), {
127
+ method: init.method ?? "GET",
128
+ headers,
129
+ body: init.body === undefined ? undefined : JSON.stringify(init.body)
130
+ });
131
+ }
132
+ // in a loader: await handleRaybaseRequest(toRaybase(request, "/api/data/notes"), env, ctx)
133
+ // in an action: await handleRaybaseRequest(toRaybase(request, "/api/actions/notes.create", { method: "POST", body: { title } }), env, ctx)
134
+ ```
135
+
136
+ `GET /api/data/<table>` returns `{ rows, total }` and `POST /api/data/<table>`
137
+ creates a row, both under the table's policies. `POST /api/actions/<name>`
138
+ exists only for actions exposed with `actionRoute()` in
139
+ `createRaybaseApp({ actions, api: { actions: [actionRoute(actions.x)] } })`;
140
+ an action passed only as `actions` has no HTTP route (404). Forward the
141
+ browser's own `Origin`/`Referer` on POSTs: Raybase refuses a POST without a
142
+ same-host one (`403 CSRF check failed`). Never set `Origin` yourself. From the
143
+ browser, `fetch` the same paths directly.
144
+ - Use Raybase `defineAction()` for business mutations that may be shared by UI,
145
+ MCP, jobs, Guide, Agents, or API. Do not encode workflow transitions only in
146
+ client state, in a route action, or in raw CRUD calls. A route action should
147
+ validate its form input, then call the declared action.
148
+ - When replacing starter actions or workflow tables, replace
149
+ `tests/raybase-patterns.test.ts` with focused tests for the new actions. Use
150
+ `@raybase/core/test` for action policy, row policy, ownership, invalid input,
151
+ and invalid state cases.
152
+ - Validate route params, search params, and form data before they cross a
153
+ policy, object, file, external fetch, AI, or state-transition boundary.
154
+ - Conversation deep links remain app-owned. If an assistant route supports
155
+ `?agent=<name>&entry=<kind>&n=<notificationId>`, allowlist the agent and entry
156
+ kind, then pass the notification id to the Agent conversation-create API.
157
+ Never turn arbitrary search-param text into a prompt or kickoff message.
158
+
159
+ ## UI Conventions
160
+
161
+ - Use React components and Tailwind utilities for app UI.
162
+ - Keep `app/app.css` as the Tailwind entry and global token/base layer, not as a
163
+ component stylesheet.
164
+ - Navigate between app routes with React Router's `Link`, `NavLink`, `Form`,
165
+ `useFetcher` and `redirect`. Raybase-owned pages (`/admin`, `/login`,
166
+ `/api/...`) are not router routes: link to them with a plain `<a href>` (or
167
+ `reloadDocument`) so the browser makes a full request, and sign out with a
168
+ `<form method="post" action="/api/auth/logout">`, as the starter's home page
169
+ does. The starter also links `/docs` with a plain `<a>`.
170
+ - Show an `/admin` link only when `currentUser` returned `isOperator: true`. Do
171
+ not inspect raw `operatorRole`, auth tables, app roles, sessions, or provider
172
+ accounts.
173
+ - Do not add app-owned local dev persona switchers. Use
174
+ `appConfig.auth.devUser` or `appConfig.auth.devUsers`; Core renders the
175
+ local-only chrome and login-page persona buttons.
176
+ - Never request notification permission on page load; ask only from a user
177
+ gesture.
178
+
179
+ ## Local Dev And Verification
180
+
181
+ Run the normal app verification from `raybase-building`:
182
+
183
+ ```bash
184
+ raybase migrate
185
+ pnpm run typecheck
186
+ pnpm test
187
+ raybase kits doctor
188
+ raybase doctor
189
+ raybase check
190
+ raybase dev
191
+ ```
192
+
193
+ `pnpm run typecheck` runs `react-router typegen && tsc --noEmit`; route type
194
+ errors after renaming a route file usually mean typegen has not run.
195
+ `pnpm run check` adds the admin-asset sync and a production build.
196
+
197
+ `raybase dev` syncs admin assets, applies local migrations, then starts
198
+ `react-router dev --host 127.0.0.1 --port <port> --strictPort` (Vite with the
199
+ SSR environment in workerd through `@cloudflare/vite-plugin`). The port is
200
+ 3000 unless you pass `--port`; when 3000 is taken it moves to a free port and
201
+ says so. It also writes `RAYBASE_SPINE_ORIGIN` and `BETTER_AUTH_URL` in
202
+ `.dev.vars` to `http://127.0.0.1:<port>` on every start; use that printed origin,
203
+ and do not mix `localhost` and `127.0.0.1` within one test flow.
204
+
205
+ If a long-running Vite/workerd dev session starts returning unexplained
206
+ `fetch failed` 500s after many HMR updates, restart `raybase dev` before
207
+ debugging application logic.
208
+
209
+ A **restart** — a `vite.config.ts` or `wrangler.jsonc` edit, a `.env` change,
210
+ a watchdog repair — ends the isolate and every agent turn and job run inside
211
+ it. An interrupted turn is not retried: it stays `running` until Core's
212
+ five-minute staleness horizon fails it, so the member sees a spinner and then
213
+ nothing. Keep `raybaseDevRestartGuard()` from `@raybase/core/vite` last in the
214
+ plugins array in `vite.config.ts` (the starter ships it); a restart then waits
215
+ for the work to land and restarts itself. Plain source edits never needed this.
216
+ `curl localhost:<port>/api/dev/activity` is the same answer by hand.
217
+
218
+ `raybase dev` keeps Miniflare's local trace store off; pass
219
+ `raybase dev --observability` for one run when you need the `/__debug` logs
220
+ view, since the store is uncapped. The `observability` block in
221
+ `wrangler.jsonc` is a deploy-time setting and does not affect local dev. Do not
222
+ delete `.wrangler` while its dev server is running; stop the process first,
223
+ then restart it.
224
+
225
+ Before handoff, verify:
226
+
227
+ - `/` redirects a signed-out visitor to `/login` and renders the app once
228
+ signed in.
229
+ - `/admin` loads for a Raybase Operator Admin/local owner persona.
230
+ - `/docs` loads when Docs is enabled, `/docs/api/search` answers, and both
231
+ match the spec's `Docs exposure` line for signed-out visitors.
232
+ - normal users do not see `/admin` links and do not need `/admin` for ordinary
233
+ workflows.
234
+ - the Raybase Operator Admin/local owner persona can see the `/admin` link.
235
+
236
+ ## Security Review
237
+
238
+ Before declaring the app ready, read and follow
239
+ `.agents/skills/raybase-react-router-security-review/SKILL.md`. Fix any
240
+ high-confidence findings, then rerun `raybase doctor`, `raybase check`, and the
241
+ focused review.
@@ -0,0 +1,60 @@
1
+ Substantial portions of this skill are adapted from Impeccable Design
2
+ (https://impeccable.style/), used under the Apache License, Version 2.0,
3
+ whose text follows. The adapted passages were rewritten for Raybase apps;
4
+ the files that carry them say so where they begin or end.
5
+
6
+ Apache License
7
+
8
+ Version 2.0, January 2004
9
+
10
+ http://www.apache.org/licenses/
11
+
12
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
13
+
14
+ 1. Definitions.
15
+
16
+ "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
17
+
18
+ "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
19
+
20
+ "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
21
+
22
+ "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
23
+
24
+ "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
25
+
26
+ "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
27
+
28
+ "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
29
+
30
+ "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
31
+
32
+ "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
33
+
34
+ "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
35
+
36
+ 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
37
+
38
+ 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
39
+
40
+ 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
41
+
42
+ You must give any other recipients of the Work or Derivative Works a copy of this License; and
43
+
44
+ You must cause any modified files to carry prominent notices stating that You changed the files; and
45
+
46
+ You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
47
+
48
+ If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
49
+
50
+ 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
51
+
52
+ 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
53
+
54
+ 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
55
+
56
+ 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
57
+
58
+ 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
59
+
60
+ END OF TERMS AND CONDITIONS
@@ -0,0 +1,135 @@
1
+ ---
2
+ name: raybase-react-router-design
3
+ description: Design beautiful, usable web-app UI in a Raybase React Router app — typography, color, layout, motion, interaction states, UX copy, delight, and final polish. Read before building or restyling any React Router screen. Not for apps embedded in another platform's admin, which follow that platform's design system.
4
+ ---
5
+
6
+ # Raybase React Router Design Skill
7
+
8
+ Design serves the product. Raybase apps are tools — dashboards, tables, forms, settings, workflows — places where the user is in a task. The bar is **earned familiarity with a signature**: an interface a user fluent in the category's best tools (Linear, Stripe, Notion, Raycast) would sit down and trust, with one or two deliberate choices that make it unmistakably this app.
9
+
10
+ App UI's failure mode isn't flatness, it's strangeness without purpose: over-decorated buttons, mismatched form controls, gratuitous motion, display fonts where labels should be, invented affordances for standard tasks. The tool should disappear into the task.
11
+
12
+ ## Process
13
+
14
+ 1. **Read what's there.** Before designing, read the project's existing tokens, theme, and a representative component or screen (`app/app.css`, `app/components/`, one route under `app/routes/`). Reuse what works. Never introduce a second icon set, a second font, or a parallel component vocabulary.
15
+ 2. **Commit to a small system** and record it in `DESIGN.md` (below). Palette, type scale, spacing/radius scale, canonical layouts. Decide once; every screen draws from it.
16
+ 3. **Know which pages are yours.** Sign-in, sign-up, owner setup, invites, password reset, email verification and `/admin` are rendered by Raybase ahead of the router, not by app routes. They show `appConfig.appName` and its first letter as the mark; there is no hook to restyle them. Design the app's own pages and leave those to Raybase.
17
+ 4. **Build with full state coverage.** Default, hover, focus-visible, active, disabled, loading, error, success, empty, long-text. Half-finished states are the difference between a demo and a product.
18
+ 5. **Look at it.** Screenshot or open the running app at mobile and desktop widths before calling anything done. A screenshot you didn't read doesn't count.
19
+
20
+ ## DESIGN.md
21
+
22
+ Keep one short `DESIGN.md` at the project root — create it the first time you make design decisions, update it when a decision changes. One page, four sections, nothing more:
23
+
24
+ - **Palette** — token names with values: bg, surface, ink, muted, accent, plus semantic success/warning/error/info.
25
+ - **Typography** — the family (or families), the rem scale, which weight plays which role.
26
+ - **Spacing & shape** — spacing scale, radius scale, shadow/elevation steps.
27
+ - **Canonical layouts** — the 2–4 page shapes this app uses (e.g. "list page: page header + filter bar + table", "detail page: content left, meta rail right") so every new screen matches one instead of inventing a new shape.
28
+
29
+ That is the entire documentation process. No brand books, no per-feature briefs.
30
+
31
+ ## Tooling
32
+
33
+ The built-in React Router starter ships Tailwind CSS v4 and a small hand-written UI kit in `app/components/ui/` (`button`, `card`, `separator`), styled through shadcn-style tokens in `app/app.css` and joined with the `cn()` helper from `app/lib/utils.ts`. Default to Tailwind utilities and the kit; grow the kit when the app needs more components — neither is mandatory, but don't substitute something else without a reason.
34
+
35
+ - **Tailwind**: style with utilities. `app/app.css` imports Tailwind, defines
36
+ the palette variables (`--background`, `--foreground`, `--primary`,
37
+ `--muted`, `--destructive`, `--border`, `--ring`, …) in one `:root` block,
38
+ and maps them to utilities in `@theme inline`. Change the palette in that
39
+ `:root` block; keep `@theme inline` as the mapping. Don't scatter arbitrary
40
+ values (`p-[13px]`, `text-[#4a4a4a]`) — if a value recurs, it's a token.
41
+ - **More components**: hand-write them in `app/components/ui/` in the kit's style — native elements, Tailwind utilities on the tokens, `cn()` from `@/lib/utils` for class merging, `React.forwardRef` where a parent needs the element. Overlays, menus and comboboxes need real focus and keyboard handling; use the Popover API and `<dialog>` before reaching for a library. Do not run `shadcn add` against this project: with the starter's `components.json` it imports `cn` from an unrelated npm package named `cn` instead of `@/lib/utils`, adds that package as a dependency, and emits classes for tokens the starter does not define (`bg-accent`, `ring-offset-background`). If you port a shadcn component by hand, fix its imports and add any tokens it uses to `app/app.css`. Keep one copy of each component and restyle it through the tokens — never restyle one copy differently per screen, and never ship the stock neutral look as the final design.
42
+ - **Docs**: `app/app.css` also imports Fumadocs' `neutral.css` and `preset.css`
43
+ for the `/docs` site. Theme the app through the app tokens; restyle `/docs`
44
+ only through Fumadocs' own variables.
45
+ - Icons: the starter declares lucide (`lucide-react`). Use it everywhere.
46
+
47
+ ## Hard rules
48
+
49
+ These apply to every screen. The references go deeper; these are the floor.
50
+
51
+ **Color**
52
+ - Body text ≥ 4.5:1 contrast against its background; large text (≥18px, or bold ≥14px) ≥ 3:1; placeholders need 4.5:1 too. The most common failure is muted gray body text on a tinted near-white — when in doubt, darken the text.
53
+ - Never gray text on a colored background — it looks washed out. Use a darker shade of the background's own hue, or a transparency of the text color.
54
+ - The accent color marks primary actions, current selection, and state. Not decoration.
55
+
56
+ **Typography**
57
+ - One well-tuned family usually carries the whole app. Fixed `rem` scale, 1.125–1.2 ratio between steps — never fluid `clamp()` type inside app UI.
58
+ - Body text ≥ 16px. Prose line length 65–75ch; tables and dense UI can run wider and tighter.
59
+ - No display fonts in labels, buttons, or data. `text-wrap: balance` on headings.
60
+
61
+ **Layout**
62
+ - All spacing from a scale (Tailwind's is fine). Vary it for rhythm: tight within groups, generous between sections.
63
+ - Cards are the lazy answer — use them only when content is truly distinct and actionable. Nested cards are always wrong.
64
+ - Flexbox for 1D, Grid for 2D. Build a semantic z-index scale (dropdown → sticky → backdrop → modal → toast → tooltip); never 999.
65
+
66
+ **Motion**
67
+ - 150–250ms for most transitions. Motion conveys state — feedback, reveal, loading — never decoration. No page-load choreography; users load into a task.
68
+ - Ease out with exponential curves (quart/quint/expo). No bounce, no elastic.
69
+ - `prefers-reduced-motion` support is not optional.
70
+
71
+ **Interaction**
72
+ - Every interactive element designs all its states (see [reference/interaction.md](reference/interaction.md)).
73
+ - Skeletons over spinners; empty states teach the interface; never `outline: none` without a `:focus-visible` replacement.
74
+ - Dropdowns positioned `absolute` inside `overflow: hidden/auto` containers get clipped — use the Popover API, `position: fixed`, or a portal.
75
+
76
+ ## Make it individual
77
+
78
+ Familiar ≠ generic. Give the app a signature, then spend the rest of the budget on consistency:
79
+
80
+ - **Pick the accent hue deliberately.** Not default blue, not purple-blue gradient territory. If someone could guess the palette from the app's category alone ("finance → navy", "AI → purple"), push one notch further.
81
+ - **Tint the neutrals toward the accent** (0.005–0.015 chroma in OKLCH) instead of pure gray, so surfaces and brand cohere.
82
+ - **Choose one or two signature moves** — a distinctive-but-readable UI face, an unusually confident density, a consistent radius language, one earned delight moment — and execute them everywhere. One committed decision beats five decorative ones.
83
+ - Dark vs light is a decision, not a default. Write one sentence about who uses this app, where, in what light. If the sentence doesn't force the answer, add detail until it does.
84
+
85
+ ## Absolute bans
86
+
87
+ If you're about to write any of these, rewrite the element with different structure:
88
+
89
+ - **Side-stripe borders** — `border-left/right` > 1px as a colored accent on cards, list items, or alerts. Use a full hairline border, a background tint, or a leading icon.
90
+ - **Gradient text** (`background-clip: text`). Solid color; emphasis via weight or size.
91
+ - **Glassmorphism as default.** Blur/glass used decoratively. Rare and purposeful, or nothing.
92
+ - **The ghost card** — `border: 1px solid` paired with a wide soft `box-shadow` (blur ≥ 16px) on the same element. Pick one.
93
+ - **Over-rounding** — cards and inputs top out at 12–16px radius. Full-pill is for tags and buttons only.
94
+ - **The hero-metric template** — big number, small label, gradient accent — unless it displays real user data.
95
+ - **Identical card grids** — same-sized icon + heading + text cards, repeated endlessly.
96
+ - **Nested cards.** Always wrong.
97
+ - **Purple-blue gradients** and `repeating-linear-gradient` stripe backgrounds.
98
+ - **Tiny uppercase tracked eyebrows / numbered section markers (01 · 02 · 03) as scaffolding** above every heading. Numbers earn their place only when the content really is a sequence.
99
+ - **Hand-drawn / sketchy SVG illustrations** as fallback art. If you can't render a scene with real assets, ship no illustration.
100
+ - **Inconsistent component vocabulary.** If the save button looks different on two screens, one of them is wrong.
101
+ - **Reinvented standard affordances** — custom scrollbars, weird form controls, non-standard modals.
102
+ - **Modal as first thought.** Modals are usually laziness; exhaust inline and progressive alternatives first.
103
+ - **Decorative motion** that conveys no state.
104
+
105
+ ## App-UI permissions
106
+
107
+ Things app UI can afford that marketing surfaces can't — use them without guilt:
108
+
109
+ - System fonts and familiar sans defaults (Inter, system-ui stacks) when performance beats personality.
110
+ - Standard navigation patterns: top bar + side nav, breadcrumbs, tabs, command palettes.
111
+ - Density. Tables with many rows, panels with many labels — when users need the information.
112
+ - Consistency over surprise. The same vocabulary screen to screen is a virtue; save delight for moments, not pages.
113
+
114
+ ## App identity assets
115
+
116
+ The starter ships only `public/favicon.ico`. During the design pass, replace it with the app's mark. If the app needs an install surface (a web manifest and app icons), add it under `public/` and link it from `app/root.tsx`; keep `short_name` under ~12 characters and set `theme_color`/`background_color` to the app's tokens.
117
+
118
+ ## Reference files
119
+
120
+ Read the relevant file before working in its area — they hold the depth this file deliberately omits:
121
+
122
+ | File | Read when |
123
+ |---|---|
124
+ | [reference/typography.md](reference/typography.md) | choosing fonts, building the type scale, fixing hierarchy or readability |
125
+ | [reference/color.md](reference/color.md) | building the palette, theming the UI kit, dark mode, contrast questions |
126
+ | [reference/layout.md](reference/layout.md) | page structure, spacing rhythm, hierarchy, responsive behavior |
127
+ | [reference/motion.md](reference/motion.md) | adding any animation or transition |
128
+ | [reference/interaction.md](reference/interaction.md) | forms, focus, dropdowns/overlays, keyboard support, loading patterns |
129
+ | [reference/copy.md](reference/copy.md) | writing labels, errors, empty states, confirmations |
130
+ | [reference/delight.md](reference/delight.md) | adding personality or memorable moments |
131
+ | [reference/polish.md](reference/polish.md) | the final pass before any screen ships — includes the hardening checklist |
132
+
133
+ ## Credits
134
+
135
+ Substantial portions of this skill are adapted from [Impeccable Design](https://impeccable.style/), used under the Apache License 2.0. If you want the full system — live browser iteration, critique scoring, detector rules, brand-register design — use Impeccable directly.