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