@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.
- package/LICENSE +21 -0
- package/THIRD_PARTY_NOTICES.md +38 -0
- package/assets/apple-touch-icons/0.png +0 -0
- package/assets/apple-touch-icons/1.png +0 -0
- package/assets/apple-touch-icons/2.png +0 -0
- package/assets/apple-touch-icons/3.png +0 -0
- package/assets/apple-touch-icons/4.png +0 -0
- package/assets/apple-touch-icons/5.png +0 -0
- package/assets/apple-touch-icons/6.png +0 -0
- package/assets/apple-touch-icons/7.png +0 -0
- package/assets/apple-touch-icons/8.png +0 -0
- package/assets/apple-touch-icons/9.png +0 -0
- package/assets/apple-touch-icons/A.png +0 -0
- package/assets/apple-touch-icons/B.png +0 -0
- package/assets/apple-touch-icons/C.png +0 -0
- package/assets/apple-touch-icons/D.png +0 -0
- package/assets/apple-touch-icons/E.png +0 -0
- package/assets/apple-touch-icons/F.png +0 -0
- package/assets/apple-touch-icons/G.png +0 -0
- package/assets/apple-touch-icons/H.png +0 -0
- package/assets/apple-touch-icons/I.png +0 -0
- package/assets/apple-touch-icons/J.png +0 -0
- package/assets/apple-touch-icons/K.png +0 -0
- package/assets/apple-touch-icons/L.png +0 -0
- package/assets/apple-touch-icons/M.png +0 -0
- package/assets/apple-touch-icons/N.png +0 -0
- package/assets/apple-touch-icons/O.png +0 -0
- package/assets/apple-touch-icons/P.png +0 -0
- package/assets/apple-touch-icons/Q.png +0 -0
- package/assets/apple-touch-icons/R.png +0 -0
- package/assets/apple-touch-icons/S.png +0 -0
- package/assets/apple-touch-icons/T.png +0 -0
- package/assets/apple-touch-icons/U.png +0 -0
- package/assets/apple-touch-icons/V.png +0 -0
- package/assets/apple-touch-icons/W.png +0 -0
- package/assets/apple-touch-icons/X.png +0 -0
- package/assets/apple-touch-icons/Y.png +0 -0
- package/assets/apple-touch-icons/Z.png +0 -0
- package/assets/apple-touch-icons/default.png +0 -0
- package/dist/.source-hash +1 -0
- package/dist/index.d.ts +56 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +2353 -0
- package/dist/index.js.map +1 -0
- package/dist/raybase-package-ranges.d.ts +11 -0
- package/dist/raybase-package-ranges.d.ts.map +1 -0
- package/dist/raybase-package-ranges.js +11 -0
- package/dist/raybase-package-ranges.js.map +1 -0
- package/dist/source-fetch.d.ts +91 -0
- package/dist/source-fetch.d.ts.map +1 -0
- package/dist/source-fetch.js +325 -0
- package/dist/source-fetch.js.map +1 -0
- package/dist/source-hash.d.ts +2 -0
- package/dist/source-hash.d.ts.map +1 -0
- package/dist/source-hash.js +23 -0
- package/dist/source-hash.js.map +1 -0
- package/dist/starter-description.d.ts +44 -0
- package/dist/starter-description.d.ts.map +1 -0
- package/dist/starter-description.js +273 -0
- package/dist/starter-description.js.map +1 -0
- package/dist/starter-source.d.ts +43 -0
- package/dist/starter-source.d.ts.map +1 -0
- package/dist/starter-source.js +156 -0
- package/dist/starter-source.js.map +1 -0
- package/dist/store-app-apply.d.ts +27 -0
- package/dist/store-app-apply.d.ts.map +1 -0
- package/dist/store-app-apply.js +100 -0
- package/dist/store-app-apply.js.map +1 -0
- package/dist/store-app-manifest.d.ts +86 -0
- package/dist/store-app-manifest.d.ts.map +1 -0
- package/dist/store-app-manifest.js +110 -0
- package/dist/store-app-manifest.js.map +1 -0
- package/dist/store-app-registry.d.ts +30 -0
- package/dist/store-app-registry.d.ts.map +1 -0
- package/dist/store-app-registry.js +232 -0
- package/dist/store-app-registry.js.map +1 -0
- package/models/recommended.json +42 -0
- package/modules/api/templates/react-router/app/api/operations.ts +8 -0
- package/modules/api/templates/tanstack-start/src/api/operations.ts +15 -0
- package/modules/docs/templates/astro-emdash/content/docs/getting-started.mdx +13 -0
- package/modules/docs/templates/astro-emdash/content/docs/index.mdx +13 -0
- package/modules/docs/templates/astro-emdash/content/docs/mcp.mdx +11 -0
- package/modules/docs/templates/astro-emdash/content/docs/meta.json +4 -0
- package/modules/docs/templates/astro-emdash/site/content/docs/getting-started.mdx +12 -0
- package/modules/docs/templates/astro-emdash/site/content/docs/index.mdx +12 -0
- package/modules/docs/templates/astro-emdash/site/content/docs/mcp.mdx +10 -0
- package/modules/docs/templates/astro-emdash/site/content/docs/meta.json +4 -0
- package/modules/docs/templates/astro-emdash/site/source.config.ts +10 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-assets.ts +1 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-client.tsx +22 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-data.ts +24 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-handler.tsx +105 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-layout.tsx +56 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-mdx.tsx +79 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-page-actions.tsx +146 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-page.tsx +70 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/llm-text.ts +61 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/source.ts +7 -0
- package/modules/docs/templates/astro-emdash/site/src/pages/docs/[...slug].ts +6 -0
- package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/markdown.ts +4 -0
- package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/search.ts +4 -0
- package/modules/docs/templates/astro-emdash/site/src/pages/llms.txt.ts +8 -0
- package/modules/docs/templates/astro-emdash/site/src/styles-docs.css +3 -0
- package/modules/docs/templates/astro-emdash/source.config.ts +10 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-data.ts +24 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
- package/modules/docs/templates/astro-emdash/src/docs/llm-text.ts +61 -0
- package/modules/docs/templates/astro-emdash/src/docs/source.ts +7 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs.tsx +22 -0
- package/modules/docs/templates/astro-emdash/src/styles-docs.css +3 -0
- package/modules/docs/templates/react-router/app/components/mdx.tsx +79 -0
- package/modules/docs/templates/react-router/app/lib/layout.shared.tsx +54 -0
- package/modules/docs/templates/react-router/app/lib/source.ts +7 -0
- package/modules/docs/templates/react-router/app/routes/docs.$.tsx +49 -0
- package/modules/docs/templates/react-router/app/routes/docs.api.search.ts +10 -0
- package/modules/docs/templates/react-router/app/routes/docs.tsx +13 -0
- package/modules/docs/templates/react-router/content/docs/getting-started.mdx +8 -0
- package/modules/docs/templates/react-router/content/docs/index.mdx +8 -0
- package/modules/docs/templates/react-router/content/docs/mcp.mdx +121 -0
- package/modules/docs/templates/react-router/content/docs/meta.json +4 -0
- package/modules/docs/templates/react-router/source.config.ts +5 -0
- package/modules/docs/templates/tanstack-start/content/docs/getting-started.mdx +10 -0
- package/modules/docs/templates/tanstack-start/content/docs/index.mdx +8 -0
- package/modules/docs/templates/tanstack-start/content/docs/mcp.mdx +121 -0
- package/modules/docs/templates/tanstack-start/content/docs/meta.json +4 -0
- package/modules/docs/templates/tanstack-start/source.config.ts +10 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-data.ts +24 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
- package/modules/docs/templates/tanstack-start/src/docs/llm-text.ts +61 -0
- package/modules/docs/templates/tanstack-start/src/docs/source.ts +7 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs.tsx +22 -0
- package/modules/docs/templates/tanstack-start/src/styles-docs.css +3 -0
- package/modules/guide/templates/astro-emdash/content/guide/capability-map.md +17 -0
- package/modules/guide/templates/astro-emdash/src/components/guide-widget.tsx +41 -0
- package/modules/guide/templates/astro-emdash/src/guide/actions.ts +8 -0
- package/modules/guide/templates/astro-emdash/src/guide/config.ts +21 -0
- package/modules/guide/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
- package/modules/guide/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
- package/modules/guide/templates/astro-emdash/src/guide/corpus.ts +4 -0
- package/modules/guide/templates/astro-emdash/src/guide/resources.json +4 -0
- package/modules/guide/templates/react-router/app/components/guide-widget.tsx +29 -0
- package/modules/guide/templates/react-router/app/guide/actions.ts +3 -0
- package/modules/guide/templates/react-router/app/guide/config.ts +21 -0
- package/modules/guide/templates/react-router/app/guide/corpus.gen.ts +4 -0
- package/modules/guide/templates/react-router/app/guide/corpus.manifest.json +22 -0
- package/modules/guide/templates/react-router/app/guide/corpus.ts +4 -0
- package/modules/guide/templates/react-router/app/guide/resources.json +4 -0
- package/modules/guide/templates/react-router/content/guide/capability-map.md +13 -0
- package/modules/guide/templates/tanstack-start/content/guide/capability-map.md +17 -0
- package/modules/guide/templates/tanstack-start/src/components/guide-widget.tsx +41 -0
- package/modules/guide/templates/tanstack-start/src/guide/actions.ts +17 -0
- package/modules/guide/templates/tanstack-start/src/guide/config.ts +21 -0
- package/modules/guide/templates/tanstack-start/src/guide/corpus.gen.ts +4 -0
- package/modules/guide/templates/tanstack-start/src/guide/corpus.manifest.json +22 -0
- package/modules/guide/templates/tanstack-start/src/guide/corpus.ts +4 -0
- package/modules/guide/templates/tanstack-start/src/guide/resources.json +4 -0
- package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
- package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
- package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
- package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
- package/modules/openai-subscription/templates/astro-emdash/src/openai-subscription.ts +11 -0
- package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
- package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
- package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
- package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
- package/modules/openai-subscription/templates/react-router/app/openai-subscription.ts +11 -0
- package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
- package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
- package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
- package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
- package/modules/openai-subscription/templates/tanstack-start/src/openai-subscription.ts +11 -0
- package/package.json +34 -8
- package/skills/README.md +122 -0
- package/skills/raybase-actions/SKILL.md +223 -0
- package/skills/raybase-actions/references/action-patterns.md +190 -0
- package/skills/raybase-actions/references/adapting-actions.md +93 -0
- package/skills/raybase-actions/references/testing-actions.md +48 -0
- package/skills/raybase-agent-debugging/SKILL.md +230 -0
- package/skills/raybase-ai/SKILL.md +1310 -0
- package/skills/raybase-api/SKILL.md +45 -0
- package/skills/raybase-astro-emdash/SKILL.md +143 -0
- package/skills/raybase-astro-emdash-content-model/SKILL.md +217 -0
- package/skills/raybase-astro-emdash-content-model/references/LICENSE-emdash +9 -0
- package/skills/raybase-astro-emdash-content-model/references/emdash-collections.md +265 -0
- package/skills/raybase-astro-emdash-design/LICENSE-impeccable +60 -0
- package/skills/raybase-astro-emdash-design/SKILL.md +170 -0
- package/skills/raybase-astro-emdash-design/reference/color.md +91 -0
- package/skills/raybase-astro-emdash-design/reference/copy.md +73 -0
- package/skills/raybase-astro-emdash-design/reference/direction.md +115 -0
- package/skills/raybase-astro-emdash-design/reference/imagery.md +84 -0
- package/skills/raybase-astro-emdash-design/reference/layout.md +69 -0
- package/skills/raybase-astro-emdash-design/reference/motion.md +75 -0
- package/skills/raybase-astro-emdash-design/reference/polish.md +75 -0
- package/skills/raybase-astro-emdash-design/reference/typography.md +72 -0
- package/skills/raybase-astro-emdash-galley/SKILL.md +265 -0
- package/skills/raybase-astro-emdash-migration/SKILL.md +218 -0
- package/skills/raybase-astro-emdash-migration/references/inventory-and-conversion.md +242 -0
- package/skills/raybase-astro-emdash-security-review/SKILL.md +68 -0
- package/skills/raybase-astro-emdash-theme-selection/SKILL.md +216 -0
- package/skills/raybase-auth/SKILL.md +358 -0
- package/skills/raybase-background-jobs/SKILL.md +774 -0
- package/skills/raybase-building/SKILL.md +409 -0
- package/skills/raybase-building/references/interview-and-spec.md +87 -0
- package/skills/raybase-building/references/planning-docs.md +26 -0
- package/skills/raybase-building/references/schema-and-config.md +70 -0
- package/skills/raybase-changing-a-live-app/SKILL.md +119 -0
- package/skills/raybase-data-and-policies/SKILL.md +377 -0
- package/skills/raybase-deploy/SKILL.md +136 -0
- package/skills/raybase-docs-writing/SKILL.md +119 -0
- package/skills/raybase-guide/SKILL.md +235 -0
- package/skills/raybase-mcp/SKILL.md +309 -0
- package/skills/raybase-mcp/agents/openai.yaml +4 -0
- package/skills/raybase-notifications/SKILL.md +138 -0
- package/skills/raybase-pro-migration/SKILL.md +28 -0
- package/skills/raybase-react-router/SKILL.md +241 -0
- package/skills/raybase-react-router-design/LICENSE-impeccable +60 -0
- package/skills/raybase-react-router-design/SKILL.md +135 -0
- package/skills/raybase-react-router-design/reference/color.md +87 -0
- package/skills/raybase-react-router-design/reference/copy.md +83 -0
- package/skills/raybase-react-router-design/reference/delight.md +48 -0
- package/skills/raybase-react-router-design/reference/interaction.md +91 -0
- package/skills/raybase-react-router-design/reference/layout.md +82 -0
- package/skills/raybase-react-router-design/reference/motion.md +86 -0
- package/skills/raybase-react-router-design/reference/polish.md +79 -0
- package/skills/raybase-react-router-design/reference/typography.md +71 -0
- package/skills/raybase-react-router-security-review/LICENSE +22 -0
- package/skills/raybase-react-router-security-review/SKILL.md +190 -0
- package/skills/raybase-react-router-security-review/agents/openai.yaml +4 -0
- package/skills/raybase-react-router-security-review/references/api-security.md +519 -0
- package/skills/raybase-react-router-security-review/references/authentication.md +353 -0
- package/skills/raybase-react-router-security-review/references/authorization.md +372 -0
- package/skills/raybase-react-router-security-review/references/business-logic.md +443 -0
- package/skills/raybase-react-router-security-review/references/cryptography.md +329 -0
- package/skills/raybase-react-router-security-review/references/csrf.md +398 -0
- package/skills/raybase-react-router-security-review/references/data-protection.md +378 -0
- package/skills/raybase-react-router-security-review/references/deserialization.md +410 -0
- package/skills/raybase-react-router-security-review/references/error-handling.md +436 -0
- package/skills/raybase-react-router-security-review/references/file-security.md +457 -0
- package/skills/raybase-react-router-security-review/references/injection.md +259 -0
- package/skills/raybase-react-router-security-review/references/logging.md +433 -0
- package/skills/raybase-react-router-security-review/references/misconfiguration.md +435 -0
- package/skills/raybase-react-router-security-review/references/modern-threats.md +475 -0
- package/skills/raybase-react-router-security-review/references/raybase-react-router-security.md +235 -0
- package/skills/raybase-react-router-security-review/references/ssrf.md +413 -0
- package/skills/raybase-react-router-security-review/references/supply-chain.md +405 -0
- package/skills/raybase-react-router-security-review/references/xss.md +336 -0
- package/skills/raybase-realtime/SKILL.md +158 -0
- package/skills/raybase-realtime/agents/openai.yaml +4 -0
- package/skills/raybase-schema/SKILL.md +209 -0
- package/skills/raybase-search/SKILL.md +137 -0
- package/skills/raybase-search/agents/openai.yaml +4 -0
- package/skills/raybase-settings/SKILL.md +139 -0
- package/skills/raybase-settings/agents/openai.yaml +4 -0
- package/skills/raybase-tanstack-start/SKILL.md +166 -0
- package/skills/raybase-tanstack-start-design/LICENSE-impeccable +60 -0
- package/skills/raybase-tanstack-start-design/SKILL.md +140 -0
- package/skills/raybase-tanstack-start-design/reference/color.md +80 -0
- package/skills/raybase-tanstack-start-design/reference/copy.md +83 -0
- package/skills/raybase-tanstack-start-design/reference/delight.md +48 -0
- package/skills/raybase-tanstack-start-design/reference/interaction.md +91 -0
- package/skills/raybase-tanstack-start-design/reference/layout.md +82 -0
- package/skills/raybase-tanstack-start-design/reference/motion.md +86 -0
- package/skills/raybase-tanstack-start-design/reference/polish.md +79 -0
- package/skills/raybase-tanstack-start-design/reference/typography.md +71 -0
- package/skills/raybase-tanstack-start-security-review/LICENSE +22 -0
- package/skills/raybase-tanstack-start-security-review/SKILL.md +194 -0
- package/skills/raybase-tanstack-start-security-review/agents/openai.yaml +4 -0
- package/skills/raybase-tanstack-start-security-review/references/api-security.md +519 -0
- package/skills/raybase-tanstack-start-security-review/references/authentication.md +353 -0
- package/skills/raybase-tanstack-start-security-review/references/authorization.md +372 -0
- package/skills/raybase-tanstack-start-security-review/references/business-logic.md +443 -0
- package/skills/raybase-tanstack-start-security-review/references/cryptography.md +329 -0
- package/skills/raybase-tanstack-start-security-review/references/csrf.md +398 -0
- package/skills/raybase-tanstack-start-security-review/references/data-protection.md +378 -0
- package/skills/raybase-tanstack-start-security-review/references/deserialization.md +410 -0
- package/skills/raybase-tanstack-start-security-review/references/error-handling.md +436 -0
- package/skills/raybase-tanstack-start-security-review/references/file-security.md +457 -0
- package/skills/raybase-tanstack-start-security-review/references/injection.md +259 -0
- package/skills/raybase-tanstack-start-security-review/references/logging.md +433 -0
- package/skills/raybase-tanstack-start-security-review/references/misconfiguration.md +435 -0
- package/skills/raybase-tanstack-start-security-review/references/modern-threats.md +475 -0
- package/skills/raybase-tanstack-start-security-review/references/raybase-tanstack-security.md +208 -0
- package/skills/raybase-tanstack-start-security-review/references/ssrf.md +413 -0
- package/skills/raybase-tanstack-start-security-review/references/supply-chain.md +405 -0
- package/skills/raybase-tanstack-start-security-review/references/xss.md +336 -0
- package/skills-manifest.json +41 -0
- package/templates/astro-emdash/.dev.vars.example +7 -0
- package/templates/astro-emdash/AGENTS.md +122 -0
- package/templates/astro-emdash/DESIGN.md +90 -0
- package/templates/astro-emdash/components.json +21 -0
- package/templates/astro-emdash/content/docs/getting-started.mdx +20 -0
- package/templates/astro-emdash/content/docs/index.mdx +13 -0
- package/templates/astro-emdash/content/docs/mcp.mdx +11 -0
- package/templates/astro-emdash/content/docs/meta.json +4 -0
- package/templates/astro-emdash/content/docs/site-templates.mdx +62 -0
- package/templates/astro-emdash/dev/CODEBASE-MAP.md +46 -0
- package/templates/astro-emdash/dev/SPEC-OVERVIEW.md +15 -0
- package/templates/astro-emdash/dev/SPEC.md +84 -0
- package/templates/astro-emdash/dev/features/archive/.gitkeep +1 -0
- package/templates/astro-emdash/docs/theme-previews/base.svg +24 -0
- package/templates/astro-emdash/docs/theme-previews/steel.svg +24 -0
- package/templates/astro-emdash/docs/theme-previews/zen.svg +24 -0
- package/templates/astro-emdash/docs/themes.md +106 -0
- package/templates/astro-emdash/drizzle.config.ts +5 -0
- package/templates/astro-emdash/gitignore +11 -0
- package/templates/astro-emdash/migrations/app/meta/_journal.json +5 -0
- package/templates/astro-emdash/package.json +79 -0
- package/templates/astro-emdash/pnpm-workspace.yaml +71 -0
- package/templates/astro-emdash/public/_headers +4 -0
- package/templates/astro-emdash/site/astro.config.mjs +120 -0
- package/templates/astro-emdash/site/demo/README.md +72 -0
- package/templates/astro-emdash/site/demo/content/collection.json +43 -0
- package/templates/astro-emdash/site/demo/content/entries.json +120 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-card/manifest.json +51 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-card/sample-content.json +5 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-card/template.liquid +48 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-page/host.json +9 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-page/manifest.json +38 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-page/sample-content.json +34 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-page/template.liquid +84 -0
- package/templates/astro-emdash/site/demo/templates/demo-articles-index/manifest.json +64 -0
- package/templates/astro-emdash/site/demo/templates/demo-articles-index/page.json +7 -0
- package/templates/astro-emdash/site/demo/templates/demo-articles-index/sample-content.json +24 -0
- package/templates/astro-emdash/site/demo/templates/demo-articles-index/template.liquid +100 -0
- package/templates/astro-emdash/site/demo/templates/demo-menu-nav/manifest.json +51 -0
- package/templates/astro-emdash/site/demo/templates/demo-menu-nav/sample-content.json +5 -0
- package/templates/astro-emdash/site/demo/templates/demo-menu-nav/template.liquid +70 -0
- package/templates/astro-emdash/site/gitignore +1 -0
- package/templates/astro-emdash/site/package.json +56 -0
- package/templates/astro-emdash/site/scripts/apply-site-templates.mjs +560 -0
- package/templates/astro-emdash/site/scripts/galley-demo.mjs +298 -0
- package/templates/astro-emdash/site/scripts/seed-galley-starter.mjs +360 -0
- package/templates/astro-emdash/site/scripts/site-origin.mjs +45 -0
- package/templates/astro-emdash/site/seed/seed.json +154 -0
- package/templates/astro-emdash/site/seed/templates/.gitkeep +1 -0
- package/templates/astro-emdash/site/src/components/RaybaseSignedInMenu.astro +163 -0
- package/templates/astro-emdash/site/src/components/blocks/RaybaseActionIsland.astro +41 -0
- package/templates/astro-emdash/site/src/content-door/raybase-routes.ts +738 -0
- package/templates/astro-emdash/site/src/content-door/resolve-page.ts +142 -0
- package/templates/astro-emdash/site/src/content-door/seed.ts +85 -0
- package/templates/astro-emdash/site/src/env.d.ts +12 -0
- package/templates/astro-emdash/site/src/layouts/SiteLayout.astro +68 -0
- package/templates/astro-emdash/site/src/lib/palettes.gen.ts +7 -0
- package/templates/astro-emdash/site/src/lib/site-motion.ts +169 -0
- package/templates/astro-emdash/site/src/lib/site-shell.ts +294 -0
- package/templates/astro-emdash/site/src/live.config.ts +8 -0
- package/templates/astro-emdash/site/src/middleware.ts +20 -0
- package/templates/astro-emdash/site/src/pages/[...slug].astro +113 -0
- package/templates/astro-emdash/site/src/pages/_raybase/handoff/consume.ts +6 -0
- package/templates/astro-emdash/site/src/pages/_raybase/islands/action.ts +8 -0
- package/templates/astro-emdash/site/src/pages/_raybase/sign-out/index.ts +6 -0
- package/templates/astro-emdash/site/src/styles/palette-fonts.gen.css +1 -0
- package/templates/astro-emdash/site/src/styles/palettes.gen.css +3 -0
- package/templates/astro-emdash/site/src/styles.css +607 -0
- package/templates/astro-emdash/site/tsconfig.json +12 -0
- package/templates/astro-emdash/site/wrangler.jsonc +34 -0
- package/templates/astro-emdash/source.config.ts +10 -0
- package/templates/astro-emdash/src/actions.ts +58 -0
- package/templates/astro-emdash/src/ai/agents.ts +20 -0
- package/templates/astro-emdash/src/ai/retrieval.ts +36 -0
- package/templates/astro-emdash/src/auth-door.ts +18 -0
- package/templates/astro-emdash/src/client.tsx +25 -0
- package/templates/astro-emdash/src/components/.gitkeep +1 -0
- package/templates/astro-emdash/src/components/account-menu.tsx +91 -0
- package/templates/astro-emdash/src/components/auth-shell.tsx +69 -0
- package/templates/astro-emdash/src/components/mode-toggle.tsx +32 -0
- package/templates/astro-emdash/src/components/search-command-palette.tsx +107 -0
- package/templates/astro-emdash/src/components/setup-token-page.tsx +196 -0
- package/templates/astro-emdash/src/components/ui/avatar.tsx +107 -0
- package/templates/astro-emdash/src/components/ui/badge.tsx +52 -0
- package/templates/astro-emdash/src/components/ui/button.tsx +69 -0
- package/templates/astro-emdash/src/components/ui/checkbox.tsx +29 -0
- package/templates/astro-emdash/src/components/ui/dialog.tsx +158 -0
- package/templates/astro-emdash/src/components/ui/dropdown-menu.tsx +303 -0
- package/templates/astro-emdash/src/components/ui/input.tsx +20 -0
- package/templates/astro-emdash/src/components/ui/label.tsx +20 -0
- package/templates/astro-emdash/src/components/ui/scroll-area.tsx +53 -0
- package/templates/astro-emdash/src/components/ui/select.tsx +215 -0
- package/templates/astro-emdash/src/components/ui/separator.tsx +23 -0
- package/templates/astro-emdash/src/components/ui/sheet.tsx +138 -0
- package/templates/astro-emdash/src/components/ui/sidebar.tsx +728 -0
- package/templates/astro-emdash/src/components/ui/skeleton.tsx +13 -0
- package/templates/astro-emdash/src/components/ui/textarea.tsx +18 -0
- package/templates/astro-emdash/src/components/ui/tooltip.tsx +66 -0
- package/templates/astro-emdash/src/db/migrations.gen.ts +6 -0
- package/templates/astro-emdash/src/db/schema.ts +6 -0
- package/templates/astro-emdash/src/db/seed.ts +16 -0
- package/templates/astro-emdash/src/db/storage.ts +32 -0
- package/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
- package/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
- package/templates/astro-emdash/src/docs/docs-data.ts +24 -0
- package/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
- package/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
- package/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
- package/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
- package/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
- package/templates/astro-emdash/src/docs/llm-text.ts +61 -0
- package/templates/astro-emdash/src/docs/source.ts +7 -0
- package/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
- package/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
- package/templates/astro-emdash/src/hooks/use-mobile.ts +19 -0
- package/templates/astro-emdash/src/jobs.example.ts +48 -0
- package/templates/astro-emdash/src/lib/account.ts +12 -0
- package/templates/astro-emdash/src/lib/auth-client.ts +181 -0
- package/templates/astro-emdash/src/lib/utils.ts +6 -0
- package/templates/astro-emdash/src/mcp-app.ts +57 -0
- package/templates/astro-emdash/src/notifications.example.ts +37 -0
- package/templates/astro-emdash/src/raybase.auth.ts +70 -0
- package/templates/astro-emdash/src/raybase.config.ts +49 -0
- package/templates/astro-emdash/src/raybase.server.ts +56 -0
- package/templates/astro-emdash/src/realtime.example.ts +18 -0
- package/templates/astro-emdash/src/router.tsx +19 -0
- package/templates/astro-emdash/src/routes/__root.tsx +56 -0
- package/templates/astro-emdash/src/routes/_app/admin.tsx +13 -0
- package/templates/astro-emdash/src/routes/_app/forgot-password.tsx +97 -0
- package/templates/astro-emdash/src/routes/_app/index.tsx +169 -0
- package/templates/astro-emdash/src/routes/_app/invite.$token.tsx +11 -0
- package/templates/astro-emdash/src/routes/_app/login.tsx +193 -0
- package/templates/astro-emdash/src/routes/_app/profile.tsx +98 -0
- package/templates/astro-emdash/src/routes/_app/reset-password.$token.tsx +15 -0
- package/templates/astro-emdash/src/routes/_app/reset-password.tsx +115 -0
- package/templates/astro-emdash/src/routes/_app/setup.$token.tsx +11 -0
- package/templates/astro-emdash/src/routes/_app/signup.tsx +141 -0
- package/templates/astro-emdash/src/routes/_app/verify-email.$token.tsx +15 -0
- package/templates/astro-emdash/src/routes/_app/verify-email.tsx +154 -0
- package/templates/astro-emdash/src/routes/_app.tsx +33 -0
- package/templates/astro-emdash/src/routes/admin/$.ts +20 -0
- package/templates/astro-emdash/src/routes/api/$.ts +19 -0
- package/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
- package/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
- package/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
- package/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
- package/templates/astro-emdash/src/routes/docs.tsx +22 -0
- package/templates/astro-emdash/src/search.ts +6 -0
- package/templates/astro-emdash/src/settings.ts +12 -0
- package/templates/astro-emdash/src/styles-docs.css +3 -0
- package/templates/astro-emdash/src/styles.css +101 -0
- package/templates/astro-emdash/src/themes/base.css +76 -0
- package/templates/astro-emdash/src/themes/carbon.css +76 -0
- package/templates/astro-emdash/src/themes/fonts.css +25 -0
- package/templates/astro-emdash/src/themes/sage.css +76 -0
- package/templates/astro-emdash/src/themes/sand.css +76 -0
- package/templates/astro-emdash/src/themes/slate.css +81 -0
- package/templates/astro-emdash/src/themes/ultra.css +76 -0
- package/templates/astro-emdash/src/themes/zen.css +76 -0
- package/templates/astro-emdash/src/worker-entry.ts +31 -0
- package/templates/astro-emdash/tests/raybase-patterns.test.ts +29 -0
- package/templates/astro-emdash/tsconfig.json +36 -0
- package/templates/astro-emdash/vite.config.ts +130 -0
- package/templates/astro-emdash/vitest.config.ts +8 -0
- package/templates/astro-emdash/wrangler.jsonc +112 -0
- package/templates/react-router/.dev.vars.example +5 -0
- package/templates/react-router/.editorconfig +15 -0
- package/templates/react-router/AGENTS.md +54 -0
- package/templates/react-router/README.md +52 -0
- package/templates/react-router/app/app.css +44 -0
- package/templates/react-router/app/components/mdx.tsx +79 -0
- package/templates/react-router/app/components/ui/button.tsx +45 -0
- package/templates/react-router/app/components/ui/card.tsx +87 -0
- package/templates/react-router/app/components/ui/separator.tsx +22 -0
- package/templates/react-router/app/db/migrations.gen.ts +6 -0
- package/templates/react-router/app/db/schema.ts +56 -0
- package/templates/react-router/app/db/seed.ts +14 -0
- package/templates/react-router/app/entry.server.tsx +41 -0
- package/templates/react-router/app/globals.d.ts +1 -0
- package/templates/react-router/app/lib/layout.shared.tsx +52 -0
- package/templates/react-router/app/lib/source.ts +7 -0
- package/templates/react-router/app/lib/utils.ts +6 -0
- package/templates/react-router/app/raybase.server.ts +65 -0
- package/templates/react-router/app/root.tsx +23 -0
- package/templates/react-router/app/routes/_index.tsx +53 -0
- package/templates/react-router/app/routes/docs.$.tsx +49 -0
- package/templates/react-router/app/routes/docs.api.search.ts +10 -0
- package/templates/react-router/app/routes/docs.tsx +13 -0
- package/templates/react-router/app/routes.ts +3 -0
- package/templates/react-router/components.json +22 -0
- package/templates/react-router/content/docs/getting-started.mdx +15 -0
- package/templates/react-router/content/docs/index.mdx +8 -0
- package/templates/react-router/content/docs/mcp.mdx +121 -0
- package/templates/react-router/content/docs/meta.json +4 -0
- package/templates/react-router/dev/CODEBASE-MAP.md +48 -0
- package/templates/react-router/dev/SPEC-OVERVIEW.md +35 -0
- package/templates/react-router/dev/SPEC.md +93 -0
- package/templates/react-router/dev/features/archive/.gitkeep +1 -0
- package/templates/react-router/drizzle.config.ts +5 -0
- package/templates/react-router/env.d.ts +53 -0
- package/templates/react-router/gitignore +23 -0
- package/templates/react-router/migrations/app/meta/_journal.json +1 -0
- package/templates/react-router/package.json +70 -0
- package/templates/react-router/public/_headers +4 -0
- package/templates/react-router/public/favicon.ico +0 -0
- package/templates/react-router/react-router.config.ts +9 -0
- package/templates/react-router/source.config.ts +5 -0
- package/templates/react-router/tests/raybase-patterns.test.ts +23 -0
- package/templates/react-router/tsconfig.json +27 -0
- package/templates/react-router/vite.config.ts +59 -0
- package/templates/react-router/vitest.config.ts +8 -0
- package/templates/react-router/workers/app.ts +40 -0
- package/templates/react-router/wrangler.jsonc +111 -0
- package/templates/tanstack-start/.dev.vars.example +5 -0
- package/templates/tanstack-start/AGENTS.md +95 -0
- package/templates/tanstack-start/DESIGN.md +65 -0
- package/templates/tanstack-start/components.json +21 -0
- package/templates/tanstack-start/content/docs/getting-started.mdx +65 -0
- package/templates/tanstack-start/content/docs/index.mdx +10 -0
- package/templates/tanstack-start/content/docs/mcp.mdx +122 -0
- package/templates/tanstack-start/content/docs/meta.json +4 -0
- package/templates/tanstack-start/dev/CODEBASE-MAP.md +84 -0
- package/templates/tanstack-start/dev/SPEC-OVERVIEW.md +46 -0
- package/templates/tanstack-start/dev/SPEC.md +213 -0
- package/templates/tanstack-start/dev/features/archive/.gitkeep +1 -0
- package/templates/tanstack-start/docs/theme-previews/base.svg +24 -0
- package/templates/tanstack-start/docs/theme-previews/steel.svg +24 -0
- package/templates/tanstack-start/docs/theme-previews/zen.svg +24 -0
- package/templates/tanstack-start/docs/themes.md +116 -0
- package/templates/tanstack-start/drizzle.config.ts +5 -0
- package/templates/tanstack-start/gitignore +11 -0
- package/templates/tanstack-start/migrations/app/0000_low_karen_page.sql +26 -0
- package/templates/tanstack-start/migrations/app/meta/0000_snapshot.json +196 -0
- package/templates/tanstack-start/migrations/app/meta/_journal.json +13 -0
- package/templates/tanstack-start/package.json +77 -0
- package/templates/tanstack-start/public/_headers +8 -0
- package/templates/tanstack-start/public/icons/app-icon-maskable.svg +1 -0
- package/templates/tanstack-start/public/icons/app-icon.svg +1 -0
- package/templates/tanstack-start/public/icons/apple-touch-icon.png +0 -0
- package/templates/tanstack-start/public/manifest.webmanifest +14 -0
- package/templates/tanstack-start/public/raybase-push-sw.js +32 -0
- package/templates/tanstack-start/source.config.ts +10 -0
- package/templates/tanstack-start/src/actions.ts +560 -0
- package/templates/tanstack-start/src/ai/agents.ts +78 -0
- package/templates/tanstack-start/src/ai/retrieval.ts +36 -0
- package/templates/tanstack-start/src/auth-door.ts +18 -0
- package/templates/tanstack-start/src/client.tsx +25 -0
- package/templates/tanstack-start/src/components/.gitkeep +1 -0
- package/templates/tanstack-start/src/components/account-menu.tsx +127 -0
- package/templates/tanstack-start/src/components/auth-shell.tsx +69 -0
- package/templates/tanstack-start/src/components/install-app.tsx +35 -0
- package/templates/tanstack-start/src/components/mode-toggle.tsx +32 -0
- package/templates/tanstack-start/src/components/search-command-palette.tsx +107 -0
- package/templates/tanstack-start/src/components/setup-token-page.tsx +197 -0
- package/templates/tanstack-start/src/components/ui/avatar.tsx +107 -0
- package/templates/tanstack-start/src/components/ui/badge.tsx +52 -0
- package/templates/tanstack-start/src/components/ui/button.tsx +69 -0
- package/templates/tanstack-start/src/components/ui/checkbox.tsx +29 -0
- package/templates/tanstack-start/src/components/ui/dialog.tsx +158 -0
- package/templates/tanstack-start/src/components/ui/dropdown-menu.tsx +303 -0
- package/templates/tanstack-start/src/components/ui/input.tsx +20 -0
- package/templates/tanstack-start/src/components/ui/label.tsx +20 -0
- package/templates/tanstack-start/src/components/ui/scroll-area.tsx +53 -0
- package/templates/tanstack-start/src/components/ui/select.tsx +215 -0
- package/templates/tanstack-start/src/components/ui/separator.tsx +23 -0
- package/templates/tanstack-start/src/components/ui/sheet.tsx +138 -0
- package/templates/tanstack-start/src/components/ui/sidebar.tsx +728 -0
- package/templates/tanstack-start/src/components/ui/skeleton.tsx +13 -0
- package/templates/tanstack-start/src/components/ui/textarea.tsx +18 -0
- package/templates/tanstack-start/src/components/ui/tooltip.tsx +66 -0
- package/templates/tanstack-start/src/db/migrations.gen.ts +6 -0
- package/templates/tanstack-start/src/db/schema.ts +90 -0
- package/templates/tanstack-start/src/db/seed.ts +106 -0
- package/templates/tanstack-start/src/db/storage.ts +32 -0
- package/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
- package/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
- package/templates/tanstack-start/src/docs/docs-data.ts +24 -0
- package/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
- package/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
- package/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
- package/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
- package/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
- package/templates/tanstack-start/src/docs/llm-text.ts +61 -0
- package/templates/tanstack-start/src/docs/source.ts +7 -0
- package/templates/tanstack-start/src/hooks/use-mobile.ts +19 -0
- package/templates/tanstack-start/src/hooks/use-pwa-install.ts +77 -0
- package/templates/tanstack-start/src/jobs.example.ts +56 -0
- package/templates/tanstack-start/src/lib/account.ts +13 -0
- package/templates/tanstack-start/src/lib/auth-client.ts +187 -0
- package/templates/tanstack-start/src/lib/push-client.ts +98 -0
- package/templates/tanstack-start/src/lib/utils.ts +6 -0
- package/templates/tanstack-start/src/mcp-app.ts +74 -0
- package/templates/tanstack-start/src/notifications.example.ts +37 -0
- package/templates/tanstack-start/src/raybase.auth.ts +86 -0
- package/templates/tanstack-start/src/raybase.config.ts +86 -0
- package/templates/tanstack-start/src/raybase.server.ts +155 -0
- package/templates/tanstack-start/src/realtime.example.ts +46 -0
- package/templates/tanstack-start/src/router.tsx +19 -0
- package/templates/tanstack-start/src/routes/__root.tsx +73 -0
- package/templates/tanstack-start/src/routes/_app/admin.tsx +13 -0
- package/templates/tanstack-start/src/routes/_app/forgot-password.tsx +97 -0
- package/templates/tanstack-start/src/routes/_app/index.tsx +1316 -0
- package/templates/tanstack-start/src/routes/_app/invite.$token.tsx +11 -0
- package/templates/tanstack-start/src/routes/_app/login.tsx +193 -0
- package/templates/tanstack-start/src/routes/_app/profile.tsx +98 -0
- package/templates/tanstack-start/src/routes/_app/reset-password.$token.tsx +16 -0
- package/templates/tanstack-start/src/routes/_app/reset-password.tsx +115 -0
- package/templates/tanstack-start/src/routes/_app/setup.$token.tsx +11 -0
- package/templates/tanstack-start/src/routes/_app/signup.tsx +141 -0
- package/templates/tanstack-start/src/routes/_app/verify-email.$token.tsx +15 -0
- package/templates/tanstack-start/src/routes/_app/verify-email.tsx +154 -0
- package/templates/tanstack-start/src/routes/_app.tsx +33 -0
- package/templates/tanstack-start/src/routes/admin/$.ts +20 -0
- package/templates/tanstack-start/src/routes/api/$.ts +19 -0
- package/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
- package/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
- package/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
- package/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
- package/templates/tanstack-start/src/routes/docs.tsx +22 -0
- package/templates/tanstack-start/src/search.ts +26 -0
- package/templates/tanstack-start/src/settings.ts +12 -0
- package/templates/tanstack-start/src/styles-docs.css +3 -0
- package/templates/tanstack-start/src/styles.css +73 -0
- package/templates/tanstack-start/src/themes/base.css +76 -0
- package/templates/tanstack-start/src/themes/carbon.css +76 -0
- package/templates/tanstack-start/src/themes/fonts.css +18 -0
- package/templates/tanstack-start/src/themes/sage.css +76 -0
- package/templates/tanstack-start/src/themes/sand.css +76 -0
- package/templates/tanstack-start/src/themes/slate.css +76 -0
- package/templates/tanstack-start/src/themes/ultra.css +76 -0
- package/templates/tanstack-start/src/themes/zen.css +76 -0
- package/templates/tanstack-start/src/worker-entry.ts +30 -0
- package/templates/tanstack-start/tests/raybase-patterns.test.ts +247 -0
- package/templates/tanstack-start/tsconfig.json +33 -0
- package/templates/tanstack-start/vite.config.ts +132 -0
- package/templates/tanstack-start/vitest.config.ts +8 -0
- package/templates/tanstack-start/wrangler.jsonc +112 -0
- package/README.md +0 -3
|
@@ -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
|
+
## Self-hosted fonts (Fontsource)
|
|
54
|
+
|
|
55
|
+
Each palette snippet sets `--app-font-sans` / `--app-font-serif` / `--app-font-mono`; `@theme inline` maps Tailwind's `font-sans`/`-serif`/`-mono` to them, so the single active palette import decides the typeface. Fonts are self-hosted via [Fontsource](https://fontsource.org) (no Google Fonts, no runtime network): `src/themes/fonts.css` `@import`s the packages and is imported from the **client entry** (`src/client.tsx`).
|
|
56
|
+
|
|
57
|
+
- Import `fonts.css` from the client entry, **not** `styles.css`. `styles.css` is imported on the server too; font binaries referenced there get emitted into the server bundle and 404 at runtime.
|
|
58
|
+
- Switch or add a font: `pnpm add @fontsource-variable/<font>`, add an `@import` to `fonts.css`, then point `--app-font-sans` (or `-mono`) at the family. 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
|
+
- A plain `install` only fetches already-declared deps — pulling a *new* font requires `pnpm add` (or hand-adding it to `package.json`).
|
|
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).
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
This skill adapts process guidance from Sentry's security-review skill. The
|
|
2
|
+
bundled issue-class references under `references/` are derived from the OWASP
|
|
3
|
+
Cheat Sheet Series, as packaged by Sentry's security-review skill.
|
|
4
|
+
|
|
5
|
+
Sources:
|
|
6
|
+
- Sentry security-review skill packaging (the getsentry/skills repository
|
|
7
|
+
is under the Apache License 2.0; its security-review references are
|
|
8
|
+
under CC BY-SA 4.0, below):
|
|
9
|
+
https://github.com/getsentry/skills/tree/main/skills/security-review
|
|
10
|
+
- OWASP Cheat Sheet Series reference material:
|
|
11
|
+
https://cheatsheetseries.owasp.org/
|
|
12
|
+
- OWASP Foundation:
|
|
13
|
+
https://owasp.org/
|
|
14
|
+
|
|
15
|
+
The OWASP-derived reference material is licensed under:
|
|
16
|
+
|
|
17
|
+
Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
|
|
18
|
+
https://creativecommons.org/licenses/by-sa/4.0/
|
|
19
|
+
|
|
20
|
+
You are free to share and adapt the material, including commercially, under
|
|
21
|
+
the terms of that license. Raybase-specific overlay material has been added
|
|
22
|
+
for generated Raybase TanStack Start applications.
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: raybase-tanstack-start-security-review
|
|
3
|
+
description: Security review for Raybase TanStack Start internal apps. Use after changing routes, server functions, schema, policies, storage, AI, MCP, config, or deploy wiring; before marking an app ready or deploying; and when asked to audit a Raybase TanStack app for injection, XSS, auth, authorization, data exposure, SSRF, file, AI, MCP, or Cloudflare Worker security issues.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Raybase TanStack Start Security Review
|
|
7
|
+
|
|
8
|
+
Identify exploitable vulnerabilities in Raybase TanStack Start apps. Report only high-confidence findings: a vulnerable pattern plus confirmed attacker-controlled input or a confirmed bypass of Raybase's security boundary.
|
|
9
|
+
|
|
10
|
+
Adapted from Sentry's `security-review` skill and OWASP Cheat Sheet reference material; see `LICENSE`.
|
|
11
|
+
|
|
12
|
+
## Required Reference
|
|
13
|
+
|
|
14
|
+
Read `references/raybase-tanstack-security.md` before reviewing. It defines Raybase/TanStack-specific trust boundaries, false positives, and how to apply the broader reference template to generated Raybase apps.
|
|
15
|
+
|
|
16
|
+
If the change uses AI, MCP, storage, background jobs, notifications, or realtime, also read the matching installed Raybase skill before judging that area:
|
|
17
|
+
|
|
18
|
+
- `.agents/skills/raybase-ai/SKILL.md`
|
|
19
|
+
- `.agents/skills/raybase-data-and-policies/SKILL.md`
|
|
20
|
+
- `.agents/skills/raybase-background-jobs/SKILL.md`
|
|
21
|
+
- `.agents/skills/raybase-notifications/SKILL.md`
|
|
22
|
+
|
|
23
|
+
## Reference Pack
|
|
24
|
+
|
|
25
|
+
The issue-class references in `references/` are OWASP Cheat Sheet-derived material from Sentry's security-review skill packaging. Use them for depth; do not rely only on the Raybase summary.
|
|
26
|
+
|
|
27
|
+
For broad app reviews, load the full issue-class reference set unless a file is clearly irrelevant to the app. At minimum, cover:
|
|
28
|
+
|
|
29
|
+
- `authorization.md`
|
|
30
|
+
- `authentication.md`
|
|
31
|
+
- `api-security.md`
|
|
32
|
+
- `business-logic.md`
|
|
33
|
+
- `data-protection.md`
|
|
34
|
+
- `injection.md`
|
|
35
|
+
- `xss.md`
|
|
36
|
+
- `file-security.md`
|
|
37
|
+
- `modern-threats.md`
|
|
38
|
+
- `ssrf.md`
|
|
39
|
+
- `csrf.md`
|
|
40
|
+
- `error-handling.md`
|
|
41
|
+
- `logging.md`
|
|
42
|
+
- `misconfiguration.md`
|
|
43
|
+
- `supply-chain.md`
|
|
44
|
+
|
|
45
|
+
Also load `cryptography.md`, `deserialization.md`, or any other reference when the app touches that domain. If uncertain, load the reference; the goal is comprehensive review with high-confidence reporting, not a tiny checklist.
|
|
46
|
+
|
|
47
|
+
For focused reviews, load every reference whose trigger appears in the diff:
|
|
48
|
+
|
|
49
|
+
| Trigger | References |
|
|
50
|
+
| --- | --- |
|
|
51
|
+
| Auth, sessions, invites, passkeys, Better Auth, login/setup routes | `authentication.md`, `error-handling.md`, `data-protection.md` |
|
|
52
|
+
| Roles, policies, object ids, route params, server functions, admin-like flows | `authorization.md`, `api-security.md`, `business-logic.md` |
|
|
53
|
+
| Server functions, server routes, raw `Request`, GraphQL/REST, webhooks, notification callbacks | `api-security.md`, `csrf.md`, `error-handling.md` |
|
|
54
|
+
| SQL, raw executors, filters, search, shell commands, template rendering | `injection.md` |
|
|
55
|
+
| React output, rich text, markdown/HTML, URLs, redirects, DOM code | `xss.md`, `misconfiguration.md` |
|
|
56
|
+
| Uploads, R2, file names, archives, XML, imports/exports, downloads | `file-security.md`, `data-protection.md` |
|
|
57
|
+
| External URLs, server-side `fetch`, previews, webhooks, callbacks, notification providers | `ssrf.md`, `api-security.md` |
|
|
58
|
+
| AI, MCP, generated tools, realtime/WebSockets, object merge helpers | `modern-threats.md`, `business-logic.md`, `authorization.md` |
|
|
59
|
+
| Secrets, env vars, logs, audit, backups, exports, PII | `data-protection.md`, `logging.md`, `cryptography.md` |
|
|
60
|
+
| Dependencies, package scripts, CI, registry/npm config | `supply-chain.md` |
|
|
61
|
+
| JSON/YAML/XML/custom serialized blobs | `deserialization.md`, `file-security.md` |
|
|
62
|
+
| Headers, CORS, cookies, CSP, debug/dev-only paths, Cloudflare config | `misconfiguration.md`, `csrf.md`, `data-protection.md` |
|
|
63
|
+
|
|
64
|
+
## Scope
|
|
65
|
+
|
|
66
|
+
- Report on the requested files, feature, or diff.
|
|
67
|
+
- Research the whole app as needed to establish exploitability.
|
|
68
|
+
- If no scope is given, review app-owned changes from `git status --short` and `git diff`, plus any generated schema, migration, config, route, or server files those changes depend on.
|
|
69
|
+
- For a first build with no meaningful diff, review `dev/SPEC.md`, `src/`, `wrangler.jsonc`, `package.json`, and any app-owned config.
|
|
70
|
+
|
|
71
|
+
Do not report by pattern matching alone. Trace data flow from the attacker-controlled source to the sink, then confirm whether Raybase, TanStack Start, React, or upstream validation actually blocks it.
|
|
72
|
+
|
|
73
|
+
## Baseline Commands
|
|
74
|
+
|
|
75
|
+
Run these when available and include failures in the review context:
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
raybase doctor
|
|
79
|
+
pnpm run check
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
`raybase doctor` is not a replacement for this review. It catches deterministic template violations; this skill catches contextual vulnerabilities in the app logic.
|
|
83
|
+
|
|
84
|
+
## Review Workflow
|
|
85
|
+
|
|
86
|
+
1. Establish the framework is TanStack Start: `package.json` has `raybase.framework` as `tanstack-start`, app code lives under `src/`, and Raybase handlers are in `src/raybase.server.ts`.
|
|
87
|
+
2. Identify entry points: route params/search, form submissions, `createServerFn` input, server route `Request` objects, uploaded files, AI/tool input, MCP requests, WebSocket messages, user-controlled database rows, and third-party webhook/API responses.
|
|
88
|
+
3. Trace each potential issue to its authority boundary: Raybase auth, Raybase table policies, storage policies, MCP OAuth, AI action policies, Cloudflare bindings, and TanStack server-function middleware.
|
|
89
|
+
4. Load the relevant domain references from the table above and apply their checklists to the changed code and dependent call paths.
|
|
90
|
+
5. Check whether the changed code bypasses Raybase primitives with custom auth, `unsafeDb`, raw SQL/D1, raw R2, raw Workers AI, raw notification provider fetches, runtime DDL, direct Better Auth calls, or public routes.
|
|
91
|
+
6. Check local-dev auth boundaries. App-owned routes/components must not render
|
|
92
|
+
local-mode persona switchers, product-header dev persona dropdowns, or
|
|
93
|
+
hidden dev auth controls; they must not call `/api/dev/session` or
|
|
94
|
+
`/api/dev/session/status`; and production/non-local app HTML must not leak
|
|
95
|
+
Core local dev chrome, persona payloads, auto-session scripts, or session
|
|
96
|
+
shortcuts. Local dev personas belong in `appConfig.auth.devUser` or
|
|
97
|
+
`appConfig.auth.devUsers`, with Core owning login-page buttons and
|
|
98
|
+
app-page local dev chrome. Custom local persona config must include a
|
|
99
|
+
Raybase Operator Admin persona (`role: "owner"` or `role: "admin"`) and
|
|
100
|
+
must keep that distinct from app business roles.
|
|
101
|
+
7. For notifications, flag provider secrets in settings/source, unsigned inbound
|
|
102
|
+
webhook handlers, user impersonation from webhook bodies, direct provider
|
|
103
|
+
fetches that bypass Raybase delivery logging, and public routes shadowing
|
|
104
|
+
`/api/notifications`.
|
|
105
|
+
8. Check stored third-party credentials. API, access, and refresh tokens kept in `text()`, `longText()`, or `json()` columns belong in `secret()` columns. Report a `revealSecret()` result that is returned from an action, written to another row, a job input, logs, settings, or AI/MCP output, and a table holding secrets whose read policy lets any member reveal another member's credential.
|
|
106
|
+
9. Check docs exposure. Docs are public by default; when `dev/SPEC.md` says
|
|
107
|
+
`Docs exposure: signed-in only`, report docs routes (`src/routes/docs*`,
|
|
108
|
+
all served through `handleDocsRequest`) that answer a signed-out request.
|
|
109
|
+
Public docs under the default `Docs exposure: public` are not a finding.
|
|
110
|
+
10. Check React/TanStack-specific sinks: `dangerouslySetInnerHTML`, DOM `innerHTML`, unvalidated `href`/`src`, client-imported secrets, server logic in isomorphic modules, server functions without validation/auth, and public server routes with side effects.
|
|
111
|
+
11. Check product/admin boundary leakage. Non-admin users should not see
|
|
112
|
+
generated `/admin` links, hidden `/admin` or `/api/admin/app` probes, or
|
|
113
|
+
docs/Guide/search instructions that send normal workflows to `/admin`,
|
|
114
|
+
`/admin/data`, CSV import/export, generated table editing, or MCP. Keep
|
|
115
|
+
runtime checks that `/admin` and `/api/admin/*` return 403 for non-admins
|
|
116
|
+
as separate verification.
|
|
117
|
+
12. Report only confirmed vulnerabilities. Put unclear but plausible issues under "Needs Verification"; skip low-confidence and best-practice-only notes.
|
|
118
|
+
|
|
119
|
+
## Do Not Flag
|
|
120
|
+
|
|
121
|
+
- Normal JSX interpolation such as `<div>{value}</div>`; React escapes it.
|
|
122
|
+
- Raybase-owned `/admin`, `/setup/$token`, `/invite/$token`, `/api/auth/*`, `/api/files`, `/api/ai`, `/mcp`, and migration routes when they delegate unchanged to the `raybaseHandler` produced by `createRaybaseApp`.
|
|
123
|
+
- Raybase Core-owned local dev chrome and login-page persona buttons when they
|
|
124
|
+
are gated to `RAYBASE_ENV=local` and generated through Core helpers rather
|
|
125
|
+
than app-owned route/component code.
|
|
126
|
+
- Server-controlled values from `wrangler.jsonc`, `.dev.vars`, Cloudflare bindings, `src/raybase.config.ts`, hardcoded constants, or package metadata unless they are exposed to the client or writable by an attacker.
|
|
127
|
+
- Code paths that merely require authentication. Report only if an authenticated user can cross a role, owner, policy, object, or data boundary they should not cross.
|
|
128
|
+
- `raybase doctor` findings as new security-review findings unless the app also has an exploitable path or the deterministic check is being bypassed.
|
|
129
|
+
- Test fixtures, dead code, comments, docs, and generated files unless the user explicitly asks to review those.
|
|
130
|
+
|
|
131
|
+
## Severity
|
|
132
|
+
|
|
133
|
+
- Critical: unauthenticated auth bypass, command execution, SQL injection exposing or mutating protected data, secrets shipped to the browser, public wildcard access to app APIs.
|
|
134
|
+
- High: policy or `unsafeDb` bypass exposing another user's data, stored XSS, raw R2 object exposure, SSRF to sensitive internal/metadata endpoints, AI/MCP tool path that performs unauthorized side effects.
|
|
135
|
+
- Medium: reflected/DOM XSS with user interaction, path traversal, CSRF or cross-origin state change not covered by TanStack/Raybase protections, constrained data exposure.
|
|
136
|
+
- Low: defense-in-depth gaps. Do not report low severity unless the user explicitly asks for hardening notes.
|
|
137
|
+
|
|
138
|
+
## Output
|
|
139
|
+
|
|
140
|
+
Use this format:
|
|
141
|
+
|
|
142
|
+
```markdown
|
|
143
|
+
## Security Review: Raybase TanStack Start
|
|
144
|
+
|
|
145
|
+
### Summary
|
|
146
|
+
- Findings: X (Critical: A, High: B, Medium: C)
|
|
147
|
+
- Risk level: Critical/High/Medium/Low
|
|
148
|
+
- Scope reviewed: [diff/files/feature]
|
|
149
|
+
- Commands: [raybase doctor result, pnpm run check result, or not run]
|
|
150
|
+
|
|
151
|
+
### Findings
|
|
152
|
+
|
|
153
|
+
#### VULN-001: [type] ([severity])
|
|
154
|
+
- Location: `path:line`
|
|
155
|
+
- Confidence: High
|
|
156
|
+
- Issue: [confirmed vulnerable data flow]
|
|
157
|
+
- Impact: [what an attacker can do]
|
|
158
|
+
- Evidence: [short snippet or trace]
|
|
159
|
+
- Fix: [specific remediation]
|
|
160
|
+
|
|
161
|
+
### Needs Verification
|
|
162
|
+
|
|
163
|
+
#### VERIFY-001: [potential issue]
|
|
164
|
+
- Location: `path:line`
|
|
165
|
+
- Question: [what must be confirmed]
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
If no high-confidence vulnerabilities are found, say: `No high-confidence vulnerabilities identified.`
|
|
169
|
+
|
|
170
|
+
## Scan Metadata
|
|
171
|
+
|
|
172
|
+
After the review, update `.raybase/security-scans.json` if the local filesystem permits it. Create `.raybase/` if needed. Keep only the latest 20 scans. This is local, gitignored advisory memory for future agents; it is not a pass/fail signal.
|
|
173
|
+
|
|
174
|
+
Use this shape:
|
|
175
|
+
|
|
176
|
+
```json
|
|
177
|
+
{
|
|
178
|
+
"scans": [
|
|
179
|
+
{
|
|
180
|
+
"framework": "tanstack-start",
|
|
181
|
+
"skill": "raybase-tanstack-start-security-review",
|
|
182
|
+
"skillVersion": 1,
|
|
183
|
+
"ranAt": "2026-06-15T00:00:00.000Z",
|
|
184
|
+
"headCommit": "abc1234",
|
|
185
|
+
"workingTreeDirty": true,
|
|
186
|
+
"scope": "git diff --stat or short description",
|
|
187
|
+
"result": "pass|findings|needs-verification",
|
|
188
|
+
"summary": "No high-confidence vulnerabilities identified."
|
|
189
|
+
}
|
|
190
|
+
]
|
|
191
|
+
}
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
Do not fail the review if metadata cannot be written. Mention that it was skipped.
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
interface:
|
|
2
|
+
display_name: "Raybase TanStack Start Security Review"
|
|
3
|
+
short_description: "Review Raybase TanStack Start app security."
|
|
4
|
+
default_prompt: "Use $raybase-tanstack-start-security-review to review this Raybase TanStack Start app for high-confidence security vulnerabilities."
|