@raybase/create 0.0.1 → 0.3.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +2351 -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,409 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: raybase-building
|
|
3
|
+
description: Build a new Raybase app from the installed template. Use for the generic Raybase implementation sequence after create-raybase; pair with the installed template-specific skill for file layout, framework, design, and security review details.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Raybase Building Skill
|
|
7
|
+
|
|
8
|
+
Follow this sequence exactly.
|
|
9
|
+
|
|
10
|
+
If the raybase skill already ran the interview, wrote the planning files, and
|
|
11
|
+
the human approved `dev/SPEC.md`, skip steps 1–2 and continue from step 3.
|
|
12
|
+
|
|
13
|
+
## Why This Sequence Exists
|
|
14
|
+
|
|
15
|
+
The order protects the owner intent and the runtime boundary:
|
|
16
|
+
|
|
17
|
+
- Spec first keeps the business outcome, roles, signup mode, workflows, and
|
|
18
|
+
Store-app fit from being guessed after code exists.
|
|
19
|
+
- Schema and policies before UI prevent screens that look complete but have no
|
|
20
|
+
reviewed authorization model.
|
|
21
|
+
- Seed data makes role-specific paths testable instead of relying on empty
|
|
22
|
+
happy paths.
|
|
23
|
+
- Docs and Guide stay useful only when tied to implemented behavior, not the
|
|
24
|
+
original chat.
|
|
25
|
+
- `raybase doctor`, `raybase check`, kit doctor, browser checks, and the
|
|
26
|
+
security review own the deterministic checks that skill prose should not try
|
|
27
|
+
to reimplement.
|
|
28
|
+
|
|
29
|
+
Deviate only when the request is already fully specified or a named Store
|
|
30
|
+
app has been approved as-is; still write down the spec and run the same
|
|
31
|
+
verification owners.
|
|
32
|
+
|
|
33
|
+
Before step 1, read `dev/SPEC.md`, `.raybase/store-app.json` when present, and
|
|
34
|
+
the installed template skill:
|
|
35
|
+
|
|
36
|
+
- TanStack Start: `.agents/skills/raybase-tanstack-start/SKILL.md`
|
|
37
|
+
- Astro/EmDash (Raybase Sites): `.agents/skills/raybase-astro-emdash/SKILL.md`
|
|
38
|
+
- React Router: `.agents/skills/raybase-react-router/SKILL.md`
|
|
39
|
+
- Created from an outside starter: also read the skills the starter installed
|
|
40
|
+
and its section of `AGENTS.md`.
|
|
41
|
+
|
|
42
|
+
Treat a draft placeholder, starter/template content, or a spec that does not
|
|
43
|
+
cover users, data, permissions, workflows, and the exact signup line as
|
|
44
|
+
unapproved. The signup line must be exactly `Signup mode: invite-only`,
|
|
45
|
+
`Signup mode: public self-signup`, or `Signup mode: provider-only self-signup`, and the Access section must also contain
|
|
46
|
+
`Cloudflare email capability`, `Auth email features`, `Invite delivery`, and
|
|
47
|
+
`Password recovery` lines. Ask the interview questions and stop before schema
|
|
48
|
+
or screens in non-interactive contexts. If the spec's why or success criteria
|
|
49
|
+
are unclear, ask a targeted follow-up before making product tradeoffs, but do
|
|
50
|
+
not invalidate an otherwise approved spec solely because it lacks a dedicated
|
|
51
|
+
value heading.
|
|
52
|
+
|
|
53
|
+
## Living Planning Docs
|
|
54
|
+
|
|
55
|
+
`dev/SPEC.md` is authoritative. Also read `dev/SPEC-OVERVIEW.md` and
|
|
56
|
+
`dev/CODEBASE-MAP.md` when present before substantial design, architecture,
|
|
57
|
+
schema, route, integration, workflow, AI/MCP, or data-model work. When to
|
|
58
|
+
update each doc, when to skip churn, and the feature-proposal archive rule
|
|
59
|
+
are in [references/planning-docs.md](references/planning-docs.md). Report in
|
|
60
|
+
handoff what planning docs changed, or state that no planning-doc update was
|
|
61
|
+
needed.
|
|
62
|
+
|
|
63
|
+
If `.raybase/store-app.json` identifies the `asset-manager` Store app,
|
|
64
|
+
treat its `dev/SPEC.md` as an approved canonical baseline only when the prompt or
|
|
65
|
+
conversation clearly approved that baseline as-is. Otherwise ask whether to
|
|
66
|
+
accept the canonical baseline or revise `dev/SPEC.md` with approved deltas before
|
|
67
|
+
changing code.
|
|
68
|
+
|
|
69
|
+
Do not silently keep starter roles such as `project-manager`, demo tables, or
|
|
70
|
+
placeholder policies when building a new business domain.
|
|
71
|
+
|
|
72
|
+
1. Interview in plain language. Follow the interview script in
|
|
73
|
+
[references/interview-and-spec.md](references/interview-and-spec.md): it
|
|
74
|
+
owns the required invitation to share extra materials, the
|
|
75
|
+
review-materials-before-drafting rule, and the question list, including
|
|
76
|
+
understanding the app's why. Do not draft the spec until supplied
|
|
77
|
+
materials have been reviewed.
|
|
78
|
+
|
|
79
|
+
2. Write `dev/SPEC.md` and `dev/SPEC-OVERVIEW.md` together, following the
|
|
80
|
+
same [references/interview-and-spec.md](references/interview-and-spec.md):
|
|
81
|
+
it owns the required Access-section lines, the public-signup and
|
|
82
|
+
transactional-email prerequisites, the SPEC-OVERVIEW voice, and the exact
|
|
83
|
+
approval-message format. Ask the human to approve the draft or tell you
|
|
84
|
+
what to change before you build.
|
|
85
|
+
|
|
86
|
+
3. Run `raybase --help`.
|
|
87
|
+
- Read the current command list and template guidance before building.
|
|
88
|
+
- If the project did not start from a Store app, inspect the Raybase
|
|
89
|
+
Store app index before heavy implementation. Use the hosted index at
|
|
90
|
+
`https://registry.raybase.dev/store/v1/index.json`, then read plausible
|
|
91
|
+
listings. Store apps are online-only. If a verified Store app
|
|
92
|
+
covers most of the spec and would save significant reimplementation, stop
|
|
93
|
+
and ask whether to restart from `--from <store-id>` instead of
|
|
94
|
+
custom-building over the blank scaffold.
|
|
95
|
+
- Use Raybase Kits for technical capabilities, not domain-specific business
|
|
96
|
+
workflows. Good Kit searches are things like `slack`, `email`,
|
|
97
|
+
`data grid`, `charts`, `files`, `ai chat`, or provider integrations. Do
|
|
98
|
+
not search Kits expecting employee leave, approval queues, procurement,
|
|
99
|
+
recruiting, or other business-domain apps; implement those in app code
|
|
100
|
+
unless a Store app fits. For a plausible technical capability, run
|
|
101
|
+
`raybase kits search <capability>` and `raybase kits info <kit-id>` before
|
|
102
|
+
writing source from scratch. Kits are copied into the app and become
|
|
103
|
+
app-owned source; they are not runtime plugins.
|
|
104
|
+
|
|
105
|
+
Before screen work, turn `dev/SPEC.md` into a workflow matrix: persona, data
|
|
106
|
+
touched, allowed actions, required UI path, and operator-only exceptions. Use
|
|
107
|
+
that matrix to keep app roles, policies, and screens aligned.
|
|
108
|
+
|
|
109
|
+
4. Model data in the template's schema file.
|
|
110
|
+
- Use Raybase helpers from `@raybase/core`.
|
|
111
|
+
- Schema changes happen in source code and migrations. Do not mutate app
|
|
112
|
+
schema through raw SQL, runtime DDL, app routes, MCP tools, admin
|
|
113
|
+
shortcuts, or model-generated SQL.
|
|
114
|
+
- Use the installed template skill for exact paths. For example, TanStack
|
|
115
|
+
Start and astro-emdash apps use `src/db/schema.ts` (the astro-emdash
|
|
116
|
+
spine follows the TanStack Start layout), while React Router apps use
|
|
117
|
+
`app/db/schema.ts`.
|
|
118
|
+
- Destructive migrations require human approval, rollback or backup
|
|
119
|
+
awareness, and verification of what data will be dropped before using
|
|
120
|
+
`--allow-destructive`.
|
|
121
|
+
- If changing auth, invites, password reset, magic links, or auth email,
|
|
122
|
+
read and follow `.agents/skills/raybase-auth/SKILL.md`. Keep account
|
|
123
|
+
creation closed to owner setup and invites unless the approved spec uses
|
|
124
|
+
public signup with transactional email verification.
|
|
125
|
+
- First, set template app config roles to the business roles from the spec
|
|
126
|
+
(starter roles are placeholders). Define them once with
|
|
127
|
+
`export const appRoles = defineRoles([...] as const)`, set
|
|
128
|
+
`roles: appRoles`, and use `role(appRoles, "...")` in policies/actions so
|
|
129
|
+
misspelled role names fail at compile time. Config roles drive role-based
|
|
130
|
+
policies and the invite Role dropdown in `/admin`; if the app needs no
|
|
131
|
+
roles beyond `user`, use `defineRoles([] as const)` and set
|
|
132
|
+
`roles: appRoles`.
|
|
133
|
+
- Also set template app config `auth.signupMode` to match `dev/SPEC.md`
|
|
134
|
+
before schema or screen work. Use `"invite-only"` for `Signup mode:
|
|
135
|
+
invite-only`, `"public"` for `Signup mode: public self-signup`, and
|
|
136
|
+
`"provider-only"` for `Signup mode: provider-only self-signup`.
|
|
137
|
+
- Every table must have `read`, `create`, `update`, and `delete` policies.
|
|
138
|
+
- Prefer `createdBy()`, `createdAt()`, and `updatedAt()` audit columns.
|
|
139
|
+
- Use `userRef()` when app data points at a signed-in Raybase user. It
|
|
140
|
+
stores the Raybase user id for relationships such as requester, employee,
|
|
141
|
+
manager, approver, owner, or assignee.
|
|
142
|
+
- Do not read Core auth user tables, Better Auth tables, sessions, accounts,
|
|
143
|
+
invites, or `operatorRole` from generated app code. If the people are not
|
|
144
|
+
Raybase login identities, model them as app-owned domain rows instead.
|
|
145
|
+
- File buckets must use Raybase storage helpers and explicit policies. Store
|
|
146
|
+
Raybase file IDs, not raw R2 keys or presigned URLs.
|
|
147
|
+
- Policies speak only about business roles. Admin access to `/admin` is not an app role.
|
|
148
|
+
- Non-admin create, update, delete, and state-transition permissions must
|
|
149
|
+
correspond to visible main-app workflows. If a role should not have a UI
|
|
150
|
+
path for a mutation, tighten the policy rather than relying on `/admin`.
|
|
151
|
+
- For workflow-sensitive tables such as approvals, reviews, requests,
|
|
152
|
+
cancellations, assignments, reservations, or inventory movements, prefer
|
|
153
|
+
generic read plus module-only writes: set table `create`, `update`, and
|
|
154
|
+
`delete` to `denyAll` (a frozen constant, not a function — no
|
|
155
|
+
parentheses), then implement validated domain routes/actions
|
|
156
|
+
that enforce ownership, role gates, field allowlists, and allowed state
|
|
157
|
+
transitions before using an audited service context for the write.
|
|
158
|
+
- Multi-tenancy, one app installed by many customer organizations, and SSO across apps are provided by Raybase Pro. Core is single-tenant by design; converting it yourself means re-architecting the control plane and is not a supported path.
|
|
159
|
+
- Keep `mcp: { enabled: true }` unless the human explicitly disables AI
|
|
160
|
+
client access. If adding MCP tools, resources, or MCP Apps UI, read and
|
|
161
|
+
follow the `raybase-mcp` skill before implementing that slice.
|
|
162
|
+
- Read and follow `raybase-settings` before adding runtime settings.
|
|
163
|
+
- Mechanics for version checks (`raybase check-updates`), `raybaseSchema`
|
|
164
|
+
keys, user pickers for login identities, app-owned OIDC login buttons,
|
|
165
|
+
MCP config variants and Operator MCP scopes, file uploads, and runtime
|
|
166
|
+
settings are in
|
|
167
|
+
[references/schema-and-config.md](references/schema-and-config.md).
|
|
168
|
+
|
|
169
|
+
5. Add believable demo data in the template's seed file.
|
|
170
|
+
- Empty apps demo poorly. Seed data is mandatory.
|
|
171
|
+
- Seed every relationship or routing table that the workflow depends on,
|
|
172
|
+
such as team assignments, project memberships, approver routing, or queue
|
|
173
|
+
ownership. If a workflow routes work to a role-holder, the local seed must
|
|
174
|
+
create at least one routed item so that role-specific UI is reachable.
|
|
175
|
+
- If the app declares multiple business roles, configure local dev personas
|
|
176
|
+
with `auth.devUsers` or clearly state which roles could not be exercised.
|
|
177
|
+
Raybase Core owns local dev session creation, login-page persona buttons,
|
|
178
|
+
and the local app-page dev chrome for switching personas. When configuring
|
|
179
|
+
custom local personas, keep a Raybase Operator Admin persona first
|
|
180
|
+
(`role: "owner"` or `role: "admin"`) so local `/admin` access is always
|
|
181
|
+
available and clearly distinct from app business roles.
|
|
182
|
+
- Make seed idempotent.
|
|
183
|
+
|
|
184
|
+
6. Build screens in app-owned files.
|
|
185
|
+
- Read the installed template skill before screen work. It owns the route,
|
|
186
|
+
component, styling-entry, local dev, and framework-specific server seams.
|
|
187
|
+
- Read the installed template design skill before designing screens. It owns
|
|
188
|
+
template-appropriate typography, color, layout, motion, states, copy, and
|
|
189
|
+
polish.
|
|
190
|
+
- Treat the auth door's copy and look as part of the design pass. Start with
|
|
191
|
+
the app-owned `src/auth-door.ts`, and freely replace
|
|
192
|
+
`src/components/auth-shell.tsx` when the product needs a different door;
|
|
193
|
+
Raybase config continues to own auth routes and behavior.
|
|
194
|
+
- Use the template's established component and styling system. Do not
|
|
195
|
+
introduce a parallel UI framework without an explicit reason.
|
|
196
|
+
- Do not edit `@raybase/core` admin UI in generated apps.
|
|
197
|
+
- Implement every non-admin create, update, delete, and state-transition
|
|
198
|
+
workflow through the main app UI with domain-specific forms, buttons, and
|
|
199
|
+
server-side handlers, Raybase actions, or Raybase data API calls that
|
|
200
|
+
respect policies.
|
|
201
|
+
- Do not rely on `/admin`, `/admin/data`, generated table editing, CSV
|
|
202
|
+
import/export, or MCP tools as the required path for ordinary human users.
|
|
203
|
+
- Preserve the template's account/current-user affordance when replacing
|
|
204
|
+
starter UI. In templates that call `/api/account/me`, it is normally
|
|
205
|
+
appropriate for that menu to include an `/admin` link only when the
|
|
206
|
+
returned summary has `isOperator: true`. Do not inspect raw
|
|
207
|
+
`operatorRole`, auth tables, app roles, sessions, or provider accounts to
|
|
208
|
+
decide this.
|
|
209
|
+
- Provide normal signed-in navigation: app sections, Docs when enabled, and
|
|
210
|
+
sign-out via `POST /api/auth/logout`. Add account/current-user
|
|
211
|
+
affordances only when an existing supported primitive supplies the needed
|
|
212
|
+
data.
|
|
213
|
+
- Do not add app-owned local-mode persona switchers, product-header dev
|
|
214
|
+
persona dropdowns, app-owned auto-session helpers, `ensureLocalSession`,
|
|
215
|
+
or app screen calls to `/api/dev/session` or `/api/dev/session/status`. Use
|
|
216
|
+
`appConfig.auth.devUser` or `appConfig.auth.devUsers`; include at least
|
|
217
|
+
one Raybase Operator Admin persona (`role: "owner"` or `role: "admin"`)
|
|
218
|
+
when customizing them. Core renders the local-only chrome and login-page
|
|
219
|
+
buttons.
|
|
220
|
+
- Use `/admin/data` for operator CSV import/export and break-glass data
|
|
221
|
+
repair. Do not build user-facing import screens unless the approved spec
|
|
222
|
+
explicitly asks for a domain-specific import workflow.
|
|
223
|
+
- Keep the app UI consistent with the owner’s domain.
|
|
224
|
+
- When users do something with business rules, implement it once as a
|
|
225
|
+
server-side workflow/action and call that from UI. Do not encode state
|
|
226
|
+
transitions only in client code or rely on raw CRUD for workflows.
|
|
227
|
+
- When a business mutation should be shared by UI, MCP, jobs, Guide, Agents,
|
|
228
|
+
or the optional API, read and follow `raybase-actions` and implement it
|
|
229
|
+
once as `defineAction()`. Parameterize actions that use app data as
|
|
230
|
+
`defineActions<RaybaseEnv, typeof schema>({ ... })`, and declare `output`
|
|
231
|
+
for every action exposed to Guide, generic Agents, or external API routes.
|
|
232
|
+
- If the requested feature includes alerts, reminders, mentions, approvals,
|
|
233
|
+
job completion/failure messages, support captures, external callbacks, or
|
|
234
|
+
operator escalation, read and follow the `raybase-notifications` skill
|
|
235
|
+
before implementing that slice. Use Raybase notifications instead of
|
|
236
|
+
bespoke outbox tables, direct provider fetches, or custom websocket feeds.
|
|
237
|
+
- If the requested feature includes keyword search, table search, docs/help
|
|
238
|
+
search, or exact search grounding for AI, read and follow the
|
|
239
|
+
`raybase-search` skill before implementing that slice.
|
|
240
|
+
- If the requested feature includes live lists, table subscriptions,
|
|
241
|
+
presence, feed updates, or websocket behavior, read
|
|
242
|
+
and follow the `raybase-realtime` skill before implementing that slice.
|
|
243
|
+
Do not set `appConfig.realtime.enabled` to true unless the app actually
|
|
244
|
+
has a live-update surface.
|
|
245
|
+
- If a Raybase Kit fits the requested feature, install it with
|
|
246
|
+
`raybase add <kit-id> --accept-risk`, review the copied source, and adapt
|
|
247
|
+
it in the app. Run `raybase kits doctor` after install.
|
|
248
|
+
- If the requested feature includes AI, Agents, chat, summaries,
|
|
249
|
+
classification, extraction, semantic search, or RAG, read and follow the
|
|
250
|
+
`raybase-ai` skill before implementing that slice.
|
|
251
|
+
|
|
252
|
+
7. Keep Docs current when Docs are enabled.
|
|
253
|
+
- If `.agents/skills/raybase-docs-writing/SKILL.md` is installed, read it
|
|
254
|
+
and update the active docs root before declaring the app ready. Resolve
|
|
255
|
+
docs placement from `dev/SPEC.md`, `package.json`
|
|
256
|
+
`raybase.modules.docs.placement`, and `.raybase/modules.json`
|
|
257
|
+
`modules.docs.placement`; use `content/docs` for `spine` and
|
|
258
|
+
`site/content/docs` for `site`.
|
|
259
|
+
- Treat app-specific docs as a deliverable alongside screens, schema,
|
|
260
|
+
policies, seed data, and verification.
|
|
261
|
+
- Replace starter placeholder pages with documentation for the real user,
|
|
262
|
+
operator, and API workflows that now exist. Do not document future or
|
|
263
|
+
unimplemented behavior as fact.
|
|
264
|
+
- If Docs are disabled because the human requested that, say so in the
|
|
265
|
+
handoff instead of creating a parallel docs system.
|
|
266
|
+
|
|
267
|
+
8. Keep public-surface docs architecture explicit in `dev/SPEC.md`.
|
|
268
|
+
- Infer private in-app docs for internal tools, dashboards, invite-only apps,
|
|
269
|
+
operational apps, back-office workflows, and internal developer tools.
|
|
270
|
+
- Infer public Astro/EmDash site plus public docs when the app has an
|
|
271
|
+
external customer/developer audience, API/SDK docs, a documentation site,
|
|
272
|
+
launch/marketing site, public product, template, or storefront.
|
|
273
|
+
- Ask only when a public-facing app/site is clear but docs audience remains
|
|
274
|
+
architecture-changing ambiguity.
|
|
275
|
+
- Keep these exact structured lines present:
|
|
276
|
+
`Public surface: ...`, `Documentation: ...`, and
|
|
277
|
+
`Docs exposure: ...`.
|
|
278
|
+
- `Docs exposure: public` is the default and what the starters do. Write
|
|
279
|
+
`signed-in only` only when the builder chooses it, and in the same change
|
|
280
|
+
add the sign-in check to the docs routes as the framework skill
|
|
281
|
+
describes.
|
|
282
|
+
|
|
283
|
+
If the approved spec requires the Core web operator panel to be absent, set
|
|
284
|
+
`admin: { enabled: false }` in source-owned `appConfig`, then rebuild and
|
|
285
|
+
redeploy. Do not implement this by hiding links or adding custom 404 routes.
|
|
286
|
+
The config switch owns `/admin`, admin docs, `/api/admin/*`,
|
|
287
|
+
`/raybase-admin/*`, and the admin-mode data/file transports. It is not a table
|
|
288
|
+
policy or `operatorVisible` setting. Consider Operator MCP separately and set
|
|
289
|
+
`mcp.operator.enabled: false` as well when the product requires that surface
|
|
290
|
+
removed. Note that `raybase export` remains tied to the admin data browser,
|
|
291
|
+
while backup/restore lifecycle commands continue through deployment routes.
|
|
292
|
+
|
|
293
|
+
For disabled deployments, verify every removed route family returns 404 and
|
|
294
|
+
that no `raybase-admin` JS/CSS is present in built client output. For the
|
|
295
|
+
default/enabled mode, keep the normal signed-in `/admin` verification below.
|
|
296
|
+
|
|
297
|
+
9. Run:
|
|
298
|
+
|
|
299
|
+
```bash
|
|
300
|
+
raybase migrate
|
|
301
|
+
pnpm test
|
|
302
|
+
raybase kits doctor
|
|
303
|
+
raybase doctor
|
|
304
|
+
raybase check
|
|
305
|
+
raybase dev
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
Start `raybase dev` yourself in a long-running local session; do not present it
|
|
309
|
+
as a command for the owner to run. Keep the server available through browser
|
|
310
|
+
verification and the user-facing handoff unless the local environment makes
|
|
311
|
+
that impossible. If a blocker prevents local startup, report the blocker and
|
|
312
|
+
the exact command or human-owned step needed before the app can be reviewed.
|
|
313
|
+
|
|
314
|
+
Make every time-dependent test deterministic. Inject a clock or explicit
|
|
315
|
+
`now` value into domain logic and freeze it for the test; no assertion may
|
|
316
|
+
depend on the real wall clock. For local runtime workflow checks, set the app
|
|
317
|
+
clock through the Core-owned dev chrome or local-only `/api/dev/time`
|
|
318
|
+
endpoint, but keep test expectations fixed. Review expected strings as product
|
|
319
|
+
output: an expectation containing an obvious grammar, pluralization, or
|
|
320
|
+
formatting defect is a review blocker, not a reason to preserve the defect.
|
|
321
|
+
|
|
322
|
+
10. Run the installed template security review.
|
|
323
|
+
- TanStack Start: read
|
|
324
|
+
`.agents/skills/raybase-tanstack-start-security-review/SKILL.md`.
|
|
325
|
+
- Astro/EmDash: read
|
|
326
|
+
`.agents/skills/raybase-astro-emdash-security-review/SKILL.md`.
|
|
327
|
+
- React Router: read
|
|
328
|
+
`.agents/skills/raybase-react-router-security-review/SKILL.md`.
|
|
329
|
+
- Created from an outside starter: also run the security review skill the
|
|
330
|
+
starter installed, if any.
|
|
331
|
+
- Follow the applicable review before declaring the app ready.
|
|
332
|
+
- Fix high-confidence findings, then rerun `raybase doctor`, `raybase check`,
|
|
333
|
+
and the focused review.
|
|
334
|
+
|
|
335
|
+
11. Open the template-specific local URL from the installed template skill and verify:
|
|
336
|
+
- The app's main route shows the app.
|
|
337
|
+
- `/admin` loads without errors and shows the admin panel, including data
|
|
338
|
+
and users. Authenticate with the Raybase Operator Admin/local owner
|
|
339
|
+
persona for this check; the persona is only the prerequisite for verifying
|
|
340
|
+
the admin panel loads.
|
|
341
|
+
- `/docs` loads with current app-specific docs when Docs are enabled.
|
|
342
|
+
- A non-admin persona cannot perform admin actions when tested.
|
|
343
|
+
- Each declared business role has at least one seeded, exercisable workflow
|
|
344
|
+
path. For example, a manager sees at least one review item and people ops
|
|
345
|
+
can load the oversight view. Record any role that remains unverified and
|
|
346
|
+
why.
|
|
347
|
+
- Non-admin app users do not see generated `/admin` links or need `/admin`,
|
|
348
|
+
generated data editing, CSV import/export, or MCP to complete ordinary
|
|
349
|
+
workflows.
|
|
350
|
+
- Where the template exposes an account/current-user menu, the Raybase
|
|
351
|
+
Operator Admin/local owner persona can see the `/admin` link there. A
|
|
352
|
+
normal user persona cannot see that link in the same menu.
|
|
353
|
+
- Local app pages show the Core-owned local dev chrome when `raybase dev`
|
|
354
|
+
is running, and app product headers do not contain local dev persona UI.
|
|
355
|
+
- Every hard product gate has a documented local-development path to the UI
|
|
356
|
+
behind it. If a fresh local browser cannot satisfy a prerequisite such as
|
|
357
|
+
a device capability or external subscription, provide a deterministic
|
|
358
|
+
local-only fixture, config path, or bypass, verify that it is unavailable
|
|
359
|
+
in production, and document how QA activates it.
|
|
360
|
+
|
|
361
|
+
Before the final handoff, perform one last reachability check against the exact
|
|
362
|
+
local URL you will give the user. Use `curl -sS -o /dev/null -w "%{http_code}"`
|
|
363
|
+
or browser tooling after all edits, verification, screenshots, cleanup, and log
|
|
364
|
+
updates are done. If the URL is unreachable, returns an unexpected 4xx/5xx, or
|
|
365
|
+
the dev process appears stale, do not hand off the stale URL: stop the old dev
|
|
366
|
+
process if needed, start a fresh `raybase dev`, poll until the app responds,
|
|
367
|
+
and report that fresh URL. Do not delete or clean live runtime directories such as
|
|
368
|
+
`.wrangler` while their dev server is still running; stop the process first and
|
|
369
|
+
restart it after cleanup.
|
|
370
|
+
|
|
371
|
+
For the first presentation after the initial build, include the verified local
|
|
372
|
+
app URL and any relevant local persona/setup details the owner needs to click
|
|
373
|
+
through the app immediately. Do not hand back only a summary of files changed or
|
|
374
|
+
a list of commands while a local run is feasible.
|
|
375
|
+
|
|
376
|
+
End the handoff by offering to set the app live next. Do not deploy
|
|
377
|
+
automatically; ask for explicit confirmation and, if the human says yes, follow
|
|
378
|
+
`.agents/skills/raybase-deploy/SKILL.md`.
|
|
379
|
+
|
|
380
|
+
Forbidden:
|
|
381
|
+
- Do not skip `dev/SPEC.md`.
|
|
382
|
+
- Do not add custom auth.
|
|
383
|
+
- Do not call Better Auth APIs directly. Use Raybase helpers, the
|
|
384
|
+
template's provider configuration seam, and core-owned
|
|
385
|
+
`/api/auth/*` handlers.
|
|
386
|
+
- Do not expose signup by adding `/signup`, `/api/auth/signup`, `/api/auth/*`,
|
|
387
|
+
or broad API paths to `auth.publicRoutes`; public signup is controlled by
|
|
388
|
+
`appConfig.auth.signupMode`.
|
|
389
|
+
- Do not add `/api/raybase/session`, `/api/raybase/admin-status`, `/api/me`,
|
|
390
|
+
`/api/current-user`, hidden `/admin` probes, hidden `/api/admin/app` probes,
|
|
391
|
+
or app-facing user-directory endpoints as shortcuts for navigation or
|
|
392
|
+
permissions.
|
|
393
|
+
- Do not add app-owned local-mode persona switchers, product-header dev
|
|
394
|
+
persona dropdowns, app-owned auto-session helpers, `ensureLocalSession`, or
|
|
395
|
+
app screen calls to `/api/dev/session` or `/api/dev/session/status`.
|
|
396
|
+
- Do not configure only app-role local personas. Custom `auth.devUser` or
|
|
397
|
+
`auth.devUsers` must include a Raybase Operator Admin persona with
|
|
398
|
+
`role: "owner"` or `role: "admin"` for local `/admin` access.
|
|
399
|
+
- Do not import or use `unsafeDb`.
|
|
400
|
+
- Do not call `env.RAYBASE_FILES.get/put/delete/list` from app code. Raybase
|
|
401
|
+
file APIs keep bytes behind auth, policies, audit, and attachment-safe
|
|
402
|
+
downloads.
|
|
403
|
+
- Do not change schema through runtime endpoints or admin UI. Edit the
|
|
404
|
+
template's schema source file, then run `raybase migrate`.
|
|
405
|
+
- Do not call `env.AI.run` directly from app code. Use Raybase AI helpers so
|
|
406
|
+
budgets, audit, Gateway metadata, and user-scoped action policies apply.
|
|
407
|
+
- Do not add new top-level dependencies without flagging why.
|
|
408
|
+
- Do not request or create runtime "plugin packages" for app capabilities when
|
|
409
|
+
a Raybase Kit or app-owned source module is the right shape.
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# Interview And Spec Writing
|
|
2
|
+
|
|
3
|
+
Detail for raybase-building steps 1–2. The invitation wording, the
|
|
4
|
+
review-materials-before-drafting rule, the exact Access-section lines, and the
|
|
5
|
+
approval-message format below are requirements, not suggestions. If the
|
|
6
|
+
raybase skill already ran the interview and the human approved `dev/SPEC.md`,
|
|
7
|
+
none of this file applies.
|
|
8
|
+
|
|
9
|
+
## Interview In Plain Language
|
|
10
|
+
|
|
11
|
+
Frame questions around what you need to understand to draft an accurate spec;
|
|
12
|
+
do not lead with "Raybase requires..." or platform policy recitations. Make
|
|
13
|
+
sure you understand the app's why when it is not already clear: what problem
|
|
14
|
+
it solves, why that matters, and what success would look like. Tell the user
|
|
15
|
+
they can answer briefly or provide any extra context they want, such as
|
|
16
|
+
existing docs, manuals, spreadsheets, screenshots, PDFs, or links to
|
|
17
|
+
apps/workflows they want to resemble. The first visible spec-discovery message
|
|
18
|
+
must include this invitation; do not shorten it to only "You can answer
|
|
19
|
+
briefly." It must also say that if the user shares links or files, you will
|
|
20
|
+
review them and synthesize the relevant details before drafting. If the user
|
|
21
|
+
provides links, PDFs, screenshots, documents, spreadsheets, or other files,
|
|
22
|
+
gather that context before drafting `dev/SPEC.md`. Use available subagents
|
|
23
|
+
when helpful to visit links, inspect files, and extract relevant requirements,
|
|
24
|
+
terminology, workflows, roles, permissions, data fields, edge cases, and
|
|
25
|
+
constraints, or inspect the materials directly. Synthesize the gathered
|
|
26
|
+
context yourself before asking follow-up questions or writing the draft. Do
|
|
27
|
+
not draft the spec until those supplied materials have been reviewed.
|
|
28
|
+
|
|
29
|
+
- What does the app do?
|
|
30
|
+
- What problem does it solve, why does that matter, and what would success look like?
|
|
31
|
+
- Who uses it?
|
|
32
|
+
- What data does it track?
|
|
33
|
+
- Who can see, create, update, and delete each kind of data?
|
|
34
|
+
- Should the app use invite-only signup, public provider-and-password signup,
|
|
35
|
+
or provider-only self-signup with password signup closed?
|
|
36
|
+
- Does the app need auth email features such as password reset, emailed
|
|
37
|
+
invites, welcome email, public signup email verification, or magic links?
|
|
38
|
+
If yes, has the owner confirmed Workers Paid plus Cloudflare Email
|
|
39
|
+
Sending/domain onboarding?
|
|
40
|
+
- What business roles exist? Use names like `manager`, `approver`, or `operations`; do not use generic `admin` as an app role.
|
|
41
|
+
|
|
42
|
+
## Write dev/SPEC.md And dev/SPEC-OVERVIEW.md Together
|
|
43
|
+
|
|
44
|
+
- Keep it readable by a non-technical owner.
|
|
45
|
+
- Include an access section with exactly `Signup mode: invite-only`, `Signup
|
|
46
|
+
mode: public self-signup`, or `Signup mode: provider-only self-signup`.
|
|
47
|
+
- Include `Cloudflare email capability`, `Auth email features`, `Invite
|
|
48
|
+
delivery`, and `Password recovery` lines in the same Access section.
|
|
49
|
+
Default to `Cloudflare email capability: free-compatible`, `Auth email
|
|
50
|
+
features: none`, `Invite delivery: admin-shared links`, and `Password
|
|
51
|
+
recovery: admin-assisted`.
|
|
52
|
+
- Invite-only remains the default placeholder. Public self-signup is allowed
|
|
53
|
+
only when explicitly approved, creates normal `user` users only, never
|
|
54
|
+
creates Raybase operators/admins, and leaves Raybase `/admin`
|
|
55
|
+
invite/operator-only. `"public"` opens provider and password signup and
|
|
56
|
+
requires owner-confirmed Workers Paid plus Cloudflare Email Sending/domain
|
|
57
|
+
onboarding, `Cloudflare email capability: transactional-email`, and public
|
|
58
|
+
signup email verification. `"provider-only"` opens configured providers and
|
|
59
|
+
closes password signup, so it needs no auth email; password sign-in remains
|
|
60
|
+
available to existing accounts.
|
|
61
|
+
- Use `Cloudflare email capability: transactional-email` only after the
|
|
62
|
+
owner confirms the paid transactional-email prerequisite. Cloudflare
|
|
63
|
+
verified destination addresses are only for operator/admin notifications
|
|
64
|
+
or intentional test sends, not end-user auth verification, password reset,
|
|
65
|
+
invite email, welcome email, magic-link auth, or public signup.
|
|
66
|
+
- Write `dev/SPEC-OVERVIEW.md` from the same draft facts. It should be both
|
|
67
|
+
useful and entertaining: a warm, witty, owner-readable product story that
|
|
68
|
+
explains what the app does, why it matters, who it helps, the workflow arc,
|
|
69
|
+
real tradeoffs, and what is deliberately out of scope. It can sound like
|
|
70
|
+
someone competent has seen the spreadsheet hellmouth and come back with
|
|
71
|
+
boundaries. It must not invent facts or scope beyond `dev/SPEC.md`. Keep
|
|
72
|
+
it concise enough to read comfortably in the approval message, usually
|
|
73
|
+
200-400 words unless the app needs unusual nuance.
|
|
74
|
+
- Ask the human to approve the draft or tell you what to change before you
|
|
75
|
+
build. Open with owner-facing copy such as: "Here's the overview I've
|
|
76
|
+
drafted." Then render the contents of `dev/SPEC-OVERVIEW.md` directly in
|
|
77
|
+
the message as normal Markdown, not inside a code block. After the
|
|
78
|
+
overview, link `dev/SPEC.md` with copy such as: "Here's the full spec if
|
|
79
|
+
you'd like to review the details." Close with approval or feedback copy
|
|
80
|
+
such as: "If this looks right, reply `approved` and I'll build the app. If
|
|
81
|
+
anything needs changing, tell me what to adjust and I'll revise the files
|
|
82
|
+
before building." A quiet note that the overview is saved to
|
|
83
|
+
`dev/SPEC-OVERVIEW.md` is fine, but a separate overview link is optional
|
|
84
|
+
because the content is already in the message. If the draft is revised,
|
|
85
|
+
repeat the same pattern with the updated overview content.
|
|
86
|
+
- Do not end the spec draft with a technical implementation inventory such
|
|
87
|
+
as schema, seed data, workflows, screens, docs/design notes, or checks.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Living Planning Docs
|
|
2
|
+
|
|
3
|
+
When to update `dev/SPEC.md`, `dev/SPEC-OVERVIEW.md`, and
|
|
4
|
+
`dev/CODEBASE-MAP.md`, and when to skip churn. `dev/SPEC.md` is
|
|
5
|
+
authoritative.
|
|
6
|
+
|
|
7
|
+
- Update `dev/SPEC.md` when approved product behavior, business goals, success
|
|
8
|
+
criteria, access mode, roles, data, permissions, workflows, integrations,
|
|
9
|
+
AI/MCP, docs expectations, or non-goals change.
|
|
10
|
+
- Update `dev/SPEC-OVERVIEW.md` when the product story, business outcome,
|
|
11
|
+
target user, workflow feel, important tradeoffs, or explicit exclusions
|
|
12
|
+
change.
|
|
13
|
+
- Update `dev/CODEBASE-MAP.md` when substantial route boundaries, schema/data
|
|
14
|
+
ownership, integrations, runtime handlers, app modules, generated files, or
|
|
15
|
+
architectural workflows change.
|
|
16
|
+
- Skip planning-doc churn for tiny bug fixes, pure styling polish, copy tweaks,
|
|
17
|
+
refactors that do not change boundaries, dependency bumps with no app behavior
|
|
18
|
+
change, or generated-file noise.
|
|
19
|
+
- Do not keep feature proposal docs alive forever. When implemented, archive
|
|
20
|
+
`dev/features/<feature-slug>/` under `dev/features/archive/` after folding
|
|
21
|
+
durable facts into `dev/SPEC.md`, `dev/SPEC-OVERVIEW.md`, and
|
|
22
|
+
`dev/CODEBASE-MAP.md`.
|
|
23
|
+
- Report in handoff what planning docs changed, or state that no planning-doc
|
|
24
|
+
update was needed.
|
|
25
|
+
- Tone/style customizations may affect overview voice later, but never facts,
|
|
26
|
+
scope, or acceptance criteria.
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# Schema And App Config Mechanics
|
|
2
|
+
|
|
3
|
+
Detail for raybase-building step 4. The schema invariants and the
|
|
4
|
+
capability-skill routing stay in SKILL.md; read this file when actually doing
|
|
5
|
+
the slice.
|
|
6
|
+
|
|
7
|
+
## Version Checks
|
|
8
|
+
|
|
9
|
+
Before serious schema work, run `raybase check-updates` and apply printed
|
|
10
|
+
Raybase updates when relevant. If the release index cannot be fetched, treat
|
|
11
|
+
the check as inconclusive rather than proof that everything is current; note
|
|
12
|
+
the warning in handoff and continue only when no version-sensitive fix is
|
|
13
|
+
needed.
|
|
14
|
+
|
|
15
|
+
## raybaseSchema Keys
|
|
16
|
+
|
|
17
|
+
In `raybaseSchema({ ... })`, use each table's actual Raybase table name as
|
|
18
|
+
the object key. If the table is `raybaseTable("leave_requests", ...)`,
|
|
19
|
+
register it as `raybaseSchema({ leave_requests: leaveRequests })`, not
|
|
20
|
+
`raybaseSchema({ leaveRequests })`.
|
|
21
|
+
|
|
22
|
+
## user pickers For Login Identities
|
|
23
|
+
|
|
24
|
+
If the app needs a picker/search for invited login identities, wrap
|
|
25
|
+
`listAppUsers()` in an explicit read-only `defineAction()` with a
|
|
26
|
+
product-specific policy and fixed `appRoles` filter, then register it with
|
|
27
|
+
`actionRoute()`. Use `getAppUserById()` or `getAppUserByEmail()` at
|
|
28
|
+
mutation time to verify the selected person still has the required app
|
|
29
|
+
role before storing the id in a `userRef()` column.
|
|
30
|
+
|
|
31
|
+
## App-Owned OIDC Login Buttons
|
|
32
|
+
|
|
33
|
+
If the app needs Google, Google Workspace, Microsoft Entra, GitHub, Apple,
|
|
34
|
+
Okta, Auth0, Keycloak, or another OIDC login button, keep it app-owned and
|
|
35
|
+
invite-only: add metadata to the template's Raybase config, configure
|
|
36
|
+
Better Auth provider options through the template's provider seam, store
|
|
37
|
+
credentials in Worker secrets or local `.dev.vars`, and run
|
|
38
|
+
`raybase doctor`. Do not add custom Better Auth handlers, custom
|
|
39
|
+
user/session/account tables, broad public routes, provider tokens in audit
|
|
40
|
+
metadata, domain auto-provisioning, SAML/SCIM, directory groups, or
|
|
41
|
+
group-to-role mapping in Core.
|
|
42
|
+
|
|
43
|
+
## MCP Configuration
|
|
44
|
+
|
|
45
|
+
Keeping `mcp: { enabled: true }` exposes app MCP at `/mcp` and Operator MCP at
|
|
46
|
+
`/mcp/operator` for authorized operators. Operator MCP grants are scoped:
|
|
47
|
+
read grants expose production evidence, while narrow write grants expose
|
|
48
|
+
only typed, audited app-data, app-setting, invite, and user-lifecycle
|
|
49
|
+
operations. Business workflow mutations should still be declared app
|
|
50
|
+
actions rather than generic table writes.
|
|
51
|
+
Disable all MCP with `mcp: { enabled: false }`; keep app MCP but disable
|
|
52
|
+
only Operator MCP with
|
|
53
|
+
`mcp: { enabled: true, operator: { enabled: false } }`.
|
|
54
|
+
|
|
55
|
+
## File Uploads
|
|
56
|
+
|
|
57
|
+
If the app needs uploads, declare buckets in the template's storage file
|
|
58
|
+
with `raybaseBucket()` and `raybaseStorage()`, pass `storage` to the
|
|
59
|
+
Raybase runtime, and add a `RAYBASE_FILES` R2 binding. Use `/api/files` or
|
|
60
|
+
`createRaybaseStorage()`, never raw R2.
|
|
61
|
+
|
|
62
|
+
## Runtime Settings
|
|
63
|
+
|
|
64
|
+
Use `defineSettings()` and `setting.*()` only for safe, non-secret
|
|
65
|
+
runtime values that admins may override, such as feature flags, support
|
|
66
|
+
email addresses, AI defaults, or user preferences. Pass the result as
|
|
67
|
+
`settings` to `createRaybaseApp`. Core supports `app` and `user`
|
|
68
|
+
scopes; `organization` scope requires Raybase Pro. Keep secrets,
|
|
69
|
+
Cloudflare bindings, auth route wiring, MCP endpoints, schema, and roles
|
|
70
|
+
in Wrangler/env vars or `RaybaseConfig`, not settings.
|