@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,242 @@
|
|
|
1
|
+
# Migration Inventory And Conversion Reference
|
|
2
|
+
|
|
3
|
+
Use this reference with the migration skill. Keep `SKILL.md` focused on
|
|
4
|
+
sequence; put working tables, mappings, and migration notes here.
|
|
5
|
+
|
|
6
|
+
## `dev/migration/inventory.md` Template
|
|
7
|
+
|
|
8
|
+
Create this file in the generated app before content modeling starts:
|
|
9
|
+
|
|
10
|
+
```md
|
|
11
|
+
# Migration Inventory
|
|
12
|
+
|
|
13
|
+
Source site: <https://example.com/>
|
|
14
|
+
Inventory date: YYYY-MM-DD
|
|
15
|
+
Migration stance: redesign | faithful reproduction approved by owner
|
|
16
|
+
Owner URL preference: preserve slugs | preserve where practical | rename
|
|
17
|
+
|
|
18
|
+
## Discovery Notes
|
|
19
|
+
|
|
20
|
+
- Public discovery surfaces checked:
|
|
21
|
+
- Browser tooling used:
|
|
22
|
+
- Limitations:
|
|
23
|
+
|
|
24
|
+
## Page Inventory
|
|
25
|
+
|
|
26
|
+
| Old URL | Title | Purpose | Content summary | Media slots | Recommendation | New URL |
|
|
27
|
+
| --- | --- | --- | --- | ---: | --- | --- |
|
|
28
|
+
| / | Home | Primary landing page | ... | 3 | keep | / |
|
|
29
|
+
|
|
30
|
+
## Repeated Content Types
|
|
31
|
+
|
|
32
|
+
| Type | Count observed | Source URLs | Proposed EmDash collection | Public detail URL pattern | Notes |
|
|
33
|
+
| --- | ---: | --- | --- | --- | --- |
|
|
34
|
+
| Articles | 12 | /blog/... | articles | /articles/{slug} | Long-form Portable Text |
|
|
35
|
+
|
|
36
|
+
## Media Inventory
|
|
37
|
+
|
|
38
|
+
| Slot | Used by | Current source URL | Highest-resolution URL | Destination | Alt text | Status |
|
|
39
|
+
| --- | --- | --- | --- | --- | --- | --- |
|
|
40
|
+
| Home hero | / | https://... | https://... | pages.home design data | Needs authored alt | old-site media |
|
|
41
|
+
|
|
42
|
+
Status values:
|
|
43
|
+
|
|
44
|
+
- `old-site media`: real media migrated from the source site.
|
|
45
|
+
- `owner-supplied`: new owner asset supplied outside the old site.
|
|
46
|
+
- `stock stand-in`: new stand-in, named in the handoff.
|
|
47
|
+
- `none`: no image should fill this slot.
|
|
48
|
+
- `blocked`: source inaccessible; record the limitation.
|
|
49
|
+
|
|
50
|
+
## Navigation And Footer
|
|
51
|
+
|
|
52
|
+
Primary nav:
|
|
53
|
+
|
|
54
|
+
- Top-level count:
|
|
55
|
+
- Depth: flat | dropdown | mega
|
|
56
|
+
- CTA:
|
|
57
|
+
- Items:
|
|
58
|
+
|
|
59
|
+
Footer:
|
|
60
|
+
|
|
61
|
+
- Link count:
|
|
62
|
+
- Column groups:
|
|
63
|
+
- Items:
|
|
64
|
+
|
|
65
|
+
## Old To New URL Map
|
|
66
|
+
|
|
67
|
+
| Old URL | Action | New URL | Redirect needed | Notes |
|
|
68
|
+
| --- | --- | --- | --- | --- |
|
|
69
|
+
| /about-us | keep | /about-us | no | Preserved slug |
|
|
70
|
+
|
|
71
|
+
Actions: `keep`, `merge`, `drop`, `rename`.
|
|
72
|
+
|
|
73
|
+
## Content Conversion Notes
|
|
74
|
+
|
|
75
|
+
- Copy preserved as-is:
|
|
76
|
+
- Copy improvements proposed separately:
|
|
77
|
+
- Collections needing search:
|
|
78
|
+
- Pages or entries needing owner review:
|
|
79
|
+
|
|
80
|
+
## Verification Checklist
|
|
81
|
+
|
|
82
|
+
- [ ] Every kept page resolves at its new URL.
|
|
83
|
+
- [ ] Collection counts match the observed counts or differences are recorded.
|
|
84
|
+
- [ ] First-request logs have no unresolved `$media` failures.
|
|
85
|
+
- [ ] No stock stand-in replaced usable old-site media without owner approval.
|
|
86
|
+
- [ ] Old to new URL map is honored.
|
|
87
|
+
- [ ] Search returns migrated entries when search is enabled.
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Browser-Only Discovery
|
|
91
|
+
|
|
92
|
+
Allowed discovery surfaces are public web surfaces you can inspect through the
|
|
93
|
+
browser or fetch tooling: rendered pages, nav/footer links, search pages, public
|
|
94
|
+
RSS/Atom feeds, public JSON that the rendered app requests, and `/sitemap.xml`
|
|
95
|
+
when it exists. Treat the live rendered navigation as the IA ground truth when
|
|
96
|
+
it disagrees with an automated list.
|
|
97
|
+
|
|
98
|
+
Do not use platform-specific migration paths: no WordPress WXR/XML exports,
|
|
99
|
+
Squarespace exports, Webflow exports, CMS admin APIs, database dumps, private
|
|
100
|
+
admin sessions, or owner credentials. If the owner offers an export anyway,
|
|
101
|
+
record that this skill does not depend on it and continue from the public
|
|
102
|
+
browser inventory unless the project gets a separate owner-approved migration
|
|
103
|
+
implementation plan.
|
|
104
|
+
|
|
105
|
+
For JavaScript-rendered sites, wait for hydration, inspect the rendered DOM,
|
|
106
|
+
and use network entries for data/media URLs when the visible page depends on
|
|
107
|
+
client-side JSON. Do not conclude "no content" from an app-shell HTML response.
|
|
108
|
+
|
|
109
|
+
## HTML To Portable Text Mapping
|
|
110
|
+
|
|
111
|
+
Use this mapping for long-form content that belongs in a page-backing
|
|
112
|
+
collection's `content` field.
|
|
113
|
+
|
|
114
|
+
| Source HTML | Portable Text shape | Notes |
|
|
115
|
+
| --- | --- | --- |
|
|
116
|
+
| `h1`-`h6` | block with `style: "h1"` through `"h6"` | Preserve hierarchy where it is meaningful; avoid multiple `h1`s inside article bodies unless the source genuinely has them. |
|
|
117
|
+
| `p` | block with `style: "normal"` | Preserve inline links and marks. Drop empty spacer paragraphs. |
|
|
118
|
+
| `strong`, `b` | span mark `strong` | Use marks on spans, not nested block hacks. |
|
|
119
|
+
| `em`, `i` | span mark `em` | Preserve only meaningful emphasis. |
|
|
120
|
+
| `a[href]` | span with link markDef | Keep absolute external URLs; normalize internal links through the URL map. |
|
|
121
|
+
| `blockquote` | block with `style: "blockquote"` | Preserve quote text; model citation separately only when the collection needs it. |
|
|
122
|
+
| `ul`, `ol`, `li` | list blocks with `listItem` and `level` | Preserve order and nesting where supported by the renderer. |
|
|
123
|
+
| `img` in article body | image field, Galley block, or referenced media near the relevant text | Prefer collection image fields for featured images; avoid stuffing raw HTML into Portable Text. |
|
|
124
|
+
| `figure` / `figcaption` | media plus caption field or nearby caption text | Keep captions when they carry meaning or attribution. |
|
|
125
|
+
| `table` | bespoke data modeling or simplified prose | Portable Text table support is not assumed. If the table is important, model it deliberately. |
|
|
126
|
+
| `iframe`, embeds, scripts | Deviation or replacement section | Do not copy arbitrary embeds. Rebuild only approved embeds in starter-native code/templates. |
|
|
127
|
+
| Builder wrappers / layout divs | no output | Drop wrappers, spacer divs, animation classes, and inline style debris. |
|
|
128
|
+
|
|
129
|
+
Every block and child span needs a stable `_key`. A readable pattern is
|
|
130
|
+
`<slug>-<section>-<index>` for blocks and
|
|
131
|
+
`<slug>-<section>-<index>-span-<n>` for children. Keep keys stable across
|
|
132
|
+
manual edits so Galley and EmDash edit context do not churn.
|
|
133
|
+
|
|
134
|
+
Example:
|
|
135
|
+
|
|
136
|
+
```json
|
|
137
|
+
{
|
|
138
|
+
"_type": "block",
|
|
139
|
+
"_key": "field-guide-intro-01",
|
|
140
|
+
"style": "normal",
|
|
141
|
+
"markDefs": [
|
|
142
|
+
{ "_key": "field-guide-link-01", "_type": "link", "href": "https://example.com/source" }
|
|
143
|
+
],
|
|
144
|
+
"children": [
|
|
145
|
+
{
|
|
146
|
+
"_type": "span",
|
|
147
|
+
"_key": "field-guide-intro-01-span-01",
|
|
148
|
+
"text": "Opening paragraph with a link.",
|
|
149
|
+
"marks": ["field-guide-link-01"]
|
|
150
|
+
}
|
|
151
|
+
]
|
|
152
|
+
}
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
## Marketing Page Conversion
|
|
156
|
+
|
|
157
|
+
Marketing pages usually should not become one huge Portable Text blob. Convert
|
|
158
|
+
them into the chosen theme's page starter and Galley section vocabulary:
|
|
159
|
+
|
|
160
|
+
- Hero copy becomes page-starter data or the first hero section's Galley data.
|
|
161
|
+
- Feature bands become theme sections, collection-bound sections, or bespoke
|
|
162
|
+
Galley templates only when the theme lacks the needed pattern.
|
|
163
|
+
- Testimonials, team members, projects, books, products, services, and FAQs
|
|
164
|
+
usually become section-data collections when editors will maintain them.
|
|
165
|
+
- Calls to action become the shell/page sections' CTA fields and must point at
|
|
166
|
+
the new URL map.
|
|
167
|
+
- Keep old page order only when it serves the new design direction. Redesign
|
|
168
|
+
can improve rhythm; it cannot drop owner-approved content silently.
|
|
169
|
+
|
|
170
|
+
## Media Harvest Notes
|
|
171
|
+
|
|
172
|
+
Record the media URL the page actually renders and the highest-resolution URL
|
|
173
|
+
you verified. For responsive images, inspect `srcset`, `<picture>` sources,
|
|
174
|
+
CSS background images, and network requests. Prefer the largest useful asset,
|
|
175
|
+
then resize locally before upload when performance requires it.
|
|
176
|
+
|
|
177
|
+
When stripping CDN resizing parameters, verify the stripped URL returns the
|
|
178
|
+
same intended asset. Some hosts require signed query params or transform path
|
|
179
|
+
segments; if the original cannot be fetched cleanly, keep the served URL or
|
|
180
|
+
download locally and upload through EmDash.
|
|
181
|
+
|
|
182
|
+
Fresh seed image example:
|
|
183
|
+
|
|
184
|
+
```json
|
|
185
|
+
{
|
|
186
|
+
"featured_image": {
|
|
187
|
+
"$media": {
|
|
188
|
+
"url": "https://source-site.example/cdn/book-cover.jpg",
|
|
189
|
+
"alt": "Paperback cover of The Field Guide on a blue table",
|
|
190
|
+
"filename": "field-guide-cover.jpg"
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
Live upload command:
|
|
197
|
+
|
|
198
|
+
```bash
|
|
199
|
+
pnpm --dir site exec emdash media upload ./field-guide-cover.jpg --alt "Paperback cover of The Field Guide on a blue table" --json
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
The upload response includes a relative
|
|
203
|
+
`/_emdash/api/media/file/{storageKey}` URL. For Galley URL fields, use the
|
|
204
|
+
site-origin-qualified URL. For collection `image` fields, store the media
|
|
205
|
+
object/id shape that EmDash returns or that the admin writes. In pinned EmDash
|
|
206
|
+
0.23, direct CLI upload accepts `--alt`/`--caption` but may not persist them;
|
|
207
|
+
after upload, verify alt text in the admin or stored entry and correct it if
|
|
208
|
+
needed.
|
|
209
|
+
|
|
210
|
+
Keep the original external source URL in migration seeds. Do not rely on
|
|
211
|
+
`emdash export-seed --with-content` to reproduce remote media URLs, because
|
|
212
|
+
round-tripped media can point at site-local storage instead. EmDash direct
|
|
213
|
+
uploads reject oversized files above the starter's current route limit, observed
|
|
214
|
+
as `413` around 50 MB; downscale locally before upload.
|
|
215
|
+
|
|
216
|
+
For built Cloudflare/Wrangler local previews, seed `$media` can populate D1
|
|
217
|
+
media rows and `site/uploads` while Miniflare R2 remains empty. Always fetch
|
|
218
|
+
the rendered `/_emdash/api/media/file/{storageKey}` URLs. If they 404 locally,
|
|
219
|
+
hydrate R2 from the upload directory or upload through the API before marking
|
|
220
|
+
the media checklist complete.
|
|
221
|
+
|
|
222
|
+
## Redirects
|
|
223
|
+
|
|
224
|
+
The Astro/EmDash template does not ship a redirect-map facility. The preferred
|
|
225
|
+
migration tactic is preserving slugs with page slugs and collection
|
|
226
|
+
`urlPattern`s. When the owner accepts renamed or dropped URLs, record them in
|
|
227
|
+
the URL map and in the handoff.
|
|
228
|
+
|
|
229
|
+
If redirects are required for launch, implement a small explicit map in
|
|
230
|
+
`site/src/middleware.ts`, record it as a Deviation, and browser-verify each
|
|
231
|
+
old URL. Keep redirect behavior narrow: static old paths to safe relative new
|
|
232
|
+
paths, no user-controlled destination parameter.
|
|
233
|
+
|
|
234
|
+
## Handoff Sentence For Old-Site Imagery
|
|
235
|
+
|
|
236
|
+
Use this exact idea once, plainly:
|
|
237
|
+
|
|
238
|
+
> Imagery from the old site was republished as-is; confirm you hold the rights
|
|
239
|
+
> before publish.
|
|
240
|
+
|
|
241
|
+
Do not turn this into a rights audit. The agent's migration task is content
|
|
242
|
+
parity and technical verification; licensing remains the owner's call.
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: raybase-astro-emdash-security-review
|
|
3
|
+
description: Security review checklist for astro-emdash apps covering handoff token signing, JWKS, EmDash auth, cookies, Server Island proxying, staged Template publishing and activation, behavior sidecars, the dev-session content door, and deployment secrets.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Raybase Astro/EmDash Security Review
|
|
7
|
+
|
|
8
|
+
Run this before handoff or deploy review for an `astro-emdash` app.
|
|
9
|
+
|
|
10
|
+
## Handoff Tokens
|
|
11
|
+
|
|
12
|
+
- `RAYBASE_HANDOFF_PRIVATE_JWK` is an ES256 private JWK and is stored as a secret in production.
|
|
13
|
+
- `/.well-known/jwks.json` returns only public JWK fields and does not expose `d`.
|
|
14
|
+
- `/api/handoff/authorize` and `/api/handoff/token` both require a signed-in Raybase session.
|
|
15
|
+
- Token TTL is short, normally five minutes and never more than fifteen minutes.
|
|
16
|
+
- Token claims include issuer, audience, subject, app id, resource, kind, roles, expiry, and a unique id.
|
|
17
|
+
- Audit records `handoff.issued` metadata but never the raw token.
|
|
18
|
+
- A session on the far side expires rather than being revoked; the review records that lag rather than assuming instant offboarding.
|
|
19
|
+
|
|
20
|
+
## Consume Route And Gate
|
|
21
|
+
|
|
22
|
+
- `site/src/pages/_raybase/handoff/consume.ts` mounts `consumeHandoff`, which verifies the signature, issuer, audience, and resource.
|
|
23
|
+
- The return URL accepts only safe relative paths.
|
|
24
|
+
- The handoff cookie is HttpOnly, SameSite=Lax, Secure, scoped to `/`, and expires with the token.
|
|
25
|
+
- `site/src/middleware.ts` mounts `requireHandoff` on `/_emdash/admin*`; a CMS reachable without it is the finding.
|
|
26
|
+
- The bounce is state-bound: the gate sets a `raybase_handoff_state` nonce cookie, consume requires it to match the `state` in the URL and clears it, so a consume URL is useless in another browser.
|
|
27
|
+
- The issuer list pins `kinds: ["sso"]` for the spine, in `site/astro.config.mjs` and in the content door's consumer config; a CMS that accepts pass kinds is the finding.
|
|
28
|
+
- Return paths go through the shared sanitiser: control characters are refused, not just CR/LF, because the URL parser strips TAB/CR/LF and turns them into an open redirect.
|
|
29
|
+
- Error responses use `cache-control: no-store` and do not leak token contents.
|
|
30
|
+
|
|
31
|
+
## Server Island Proxy
|
|
32
|
+
|
|
33
|
+
- `allowedActions` is a fixed set.
|
|
34
|
+
- The proxy builds the Raybase action URL from trusted configuration and `encodeURIComponent(action)`.
|
|
35
|
+
- The proxy does not accept arbitrary URLs, methods, headers, or credentials from public input.
|
|
36
|
+
- Public Raybase actions declare `audience: "public"` and an explicit policy.
|
|
37
|
+
|
|
38
|
+
## Site Assembly And Templates
|
|
39
|
+
|
|
40
|
+
- Staged registry content under `site/seed/templates/**` (Liquid, sample
|
|
41
|
+
data, page seeds, and any behavior sidecars) has been reviewed before
|
|
42
|
+
`pnpm --dir site run templates:apply` publishes it. Apply flips drafts to
|
|
43
|
+
published, and a `shell add --activate` work order also swaps the active
|
|
44
|
+
public shell (layout pointer and palette).
|
|
45
|
+
- Template provenance comes from the intended registry: `.raybase/templates.json`
|
|
46
|
+
and per-template `provenance.json` integrity hashes match what was staged;
|
|
47
|
+
no unreviewed edits rode along.
|
|
48
|
+
- Behavior sidecars ship JavaScript that runs on the public site under the
|
|
49
|
+
current permissive CSP. Review sidecar sources like app code before
|
|
50
|
+
publish; do not publish third-party behavior you have not read.
|
|
51
|
+
- The dev-session content door (`POST /_raybase/dev/session` in
|
|
52
|
+
`site/src/middleware.ts`) is local-dev-only. Verify it is inert or absent
|
|
53
|
+
in production builds and that the public site exposes no persona-switching
|
|
54
|
+
surface in production.
|
|
55
|
+
- When docs placement is `site`, the public docs and `llms.txt` surfaces
|
|
56
|
+
expose only content intended to be public.
|
|
57
|
+
- The Browser Verification recipe in
|
|
58
|
+
`.agents/skills/raybase-astro-emdash/SKILL.md` has been run: the signed-in
|
|
59
|
+
handoff, composed public shell, and Galley publish states were verified in
|
|
60
|
+
a real browser before sign-off.
|
|
61
|
+
|
|
62
|
+
## Deployment
|
|
63
|
+
|
|
64
|
+
- `raybase doctor` passes.
|
|
65
|
+
- Production site origin in `src/raybase.config.ts` is not a localhost placeholder.
|
|
66
|
+
- EmDash D1 and R2 bindings exist and point at the intended account resources.
|
|
67
|
+
- `site/wrangler.jsonc` does not contain secrets.
|
|
68
|
+
- Cross-origin fetches and redirects are limited to the configured spine and site origins.
|
|
@@ -0,0 +1,216 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: raybase-astro-emdash-theme-selection
|
|
3
|
+
description: Assemble a Raybase site in two explicit steps — a theme (voice + vocabulary — palettes, sections, page starters) then a shell (the layout with its welded nav + footer, chosen by capacity), plus page seeds, activation, and verification.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Raybase Astro/EmDash Theme Selection Skill
|
|
7
|
+
|
|
8
|
+
Use this skill when a generated `astro-emdash` app needs a public site assembled from the Raybase Templates registry rather than bespoke Astro sections.
|
|
9
|
+
|
|
10
|
+
A site is assembled from two artifacts, chosen in order:
|
|
11
|
+
|
|
12
|
+
1. **Theme** — voice and vocabulary: palettes, sections, page starters, guidance. Chosen on tone/density/scheme/starter coverage.
|
|
13
|
+
2. **Shell** — the IA's frame: a layout with its nav and footer welded into its Liquid, selected by **capacity** (does the nav hold your top-level links? does the footer make your IA findable?) then ranked by voice-fit with the theme.
|
|
14
|
+
|
|
15
|
+
The theme owns how the site *sounds and looks*; the shell owns how the IA is *framed*. They are separate registry artifacts and separate commands.
|
|
16
|
+
|
|
17
|
+
## Read Order
|
|
18
|
+
|
|
19
|
+
1. Read `.agents/skills/raybase-astro-emdash/SKILL.md`.
|
|
20
|
+
2. Read `.agents/skills/raybase-astro-emdash-galley/SKILL.md`.
|
|
21
|
+
3. Read `dev/SPEC.md`, `dev/SPEC-OVERVIEW.md`, `dev/CODEBASE-MAP.md`, and any current page/content notes.
|
|
22
|
+
4. Inspect the app's EmDash collections, existing pages (`design` and `content` fields), and any staged Template lock files before choosing.
|
|
23
|
+
|
|
24
|
+
## Selection Loop
|
|
25
|
+
|
|
26
|
+
Inputs: before searching, have the approved page inventory, **named menu plan
|
|
27
|
+
with nav/footer counts and depth**, content-type list, and binding plan
|
|
28
|
+
from the `Site plan` section of `dev/SPEC.md` in hand - produced by
|
|
29
|
+
`.agents/skills/raybase-astro-emdash-content-model/SKILL.md` - plus the
|
|
30
|
+
design direction recorded in `DESIGN.md` by
|
|
31
|
+
`.agents/skills/raybase-astro-emdash-design/SKILL.md`. Selection consumes a
|
|
32
|
+
site plan and a design direction; it does not invent them.
|
|
33
|
+
|
|
34
|
+
### Step 1 — Theme (voice + vocabulary)
|
|
35
|
+
|
|
36
|
+
- Compile the direction into a **faceted match**, don't liquify it into a vibe:
|
|
37
|
+
`raybase templates match "<audience tone page needs>" --tone "<voice words>" --density <low|medium|high> --scheme <light|dark> --pages <role,keys> [--anti "<anti-reference>"] --json`.
|
|
38
|
+
`match` pulls a semantic candidate pool then scores each theme **per facet** — tone overlap, density distance, scheme support, starter coverage, section vocabulary, and its best shell match — and returns a **tradeoff matrix**, not a bare rank ("vela — tone ✓, density ✗ airy, covers 6/7 pages, best shell vela-site-layout 0.8"). The anti-reference from `DESIGN.md` enters as a negative constraint. Read the matrix and choose with the tradeoffs named.
|
|
39
|
+
- Use registry-supported page roles in `--pages`, not domain nouns you wish
|
|
40
|
+
existed. For example, a publisher with book detail routes may still match on
|
|
41
|
+
`onePage`, `article`, `blog`, `visual`, or other roles that `templates info`
|
|
42
|
+
exposes; do not invent roles like `bookDetail` unless the registry entry
|
|
43
|
+
actually declares them.
|
|
44
|
+
- Inspect the finalists with `raybase templates info <theme-id>` for the palette metadata, required bindings, and the "Shells — best fits" list. Optionally corroborate the look with `raybase templates search "<query>" --kind theme --has-screenshots --json` (theme entries carry captures derived from their page-starter members).
|
|
45
|
+
- Choose explicitly. Do not let hidden heuristics pick the theme, palette, or page starters. `--palette` is **required when the theme lists more than one palette** — an ambiguous palette errors (colors get the same explicit-choice rule as layouts). Record the chosen theme, palette, and rationale in the site section of `DESIGN.md`.
|
|
46
|
+
- Prefer one coherent theme over mixing families for voice. Add individual sections only when the theme lacks a needed band.
|
|
47
|
+
- Map collection bindings with model judgement from the app schema and user goals. Do not string-scan field names as the binding engine.
|
|
48
|
+
|
|
49
|
+
### Step 2 — Shell (the IA's frame, chosen by capacity)
|
|
50
|
+
|
|
51
|
+
The nav is the IA's priorities; the footer is the IA's completeness. Both are born from the site plan's named menus — so the shell is the first choice in the system that is **mechanically verifiable**.
|
|
52
|
+
|
|
53
|
+
- Turn the site plan's menu shapes into a capacity query and rank shells:
|
|
54
|
+
`raybase templates shell match --nav-items <N> --nav-depth flat|dropdown|mega --footer-links <N> --footer-columns <N> [--cta] --theme <theme-id> --json`.
|
|
55
|
+
`shell match` hard-filters on capacity (a shell that can't hold your nav is excluded) then ranks the survivors by voice-compat with the theme (density, type, family prior). The output is dimensional — "matches density + type; clashes on motion" — never a bare rank.
|
|
56
|
+
- Count `primary` top-level items for `--nav-items`; choose
|
|
57
|
+
`--nav-depth flat|dropdown|mega` from the `primary` menu hierarchy; count
|
|
58
|
+
all footer child links for `--footer-links`; count top-level `footer` items
|
|
59
|
+
as columns for `--footer-columns`. Social and legal menus do not inflate the
|
|
60
|
+
main footer column count unless the chosen shell renders them inside the
|
|
61
|
+
same footer grid.
|
|
62
|
+
- The shell need **not** be the theme's family: "same family" is a ranking prior, not a boundary. Pick the shell whose capacity fits and whose voice reads closest to the direction.
|
|
63
|
+
- Install and activate the chosen shell with `raybase templates shell add <layout-id> --activate --palette <name>`. The nav and footer install automatically via the requires-graph (they are welded to the layout) and should use the standard menu names (`primary`, `footer`, `social`, `legal`) by default. `--activate` is the go-live step: it stages the activation intent and publishes the theme's staged page drafts.
|
|
64
|
+
- If you install or adapt an individual menu-bound template outside the shell
|
|
65
|
+
graph, bind its menu source explicitly with `--bind alias=menu:<name>` on
|
|
66
|
+
`raybase templates add`. `raybase templates theme add` accepts the same
|
|
67
|
+
syntax for selected theme members. Rebinding a menu alias to a collection is
|
|
68
|
+
an error; use collection binds only for collection dataSources.
|
|
69
|
+
- Record the chosen shell in `DESIGN.md` (id + one line of capacity rationale: "duskwire-wide — 6 top-level links, sitemap footer for the deep resources IA").
|
|
70
|
+
|
|
71
|
+
## Golden Command Shape
|
|
72
|
+
|
|
73
|
+
Run from the generated app root with the Astro/EmDash site available for apply:
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
# 1. Theme — voice + vocabulary (faceted match, then inspect the finalist)
|
|
77
|
+
raybase templates match "studio services portfolio" --tone "polished direct crafted" --density medium --scheme light --pages onePage,resources --json
|
|
78
|
+
raybase templates info raybase/lumen-studio
|
|
79
|
+
raybase templates theme add raybase/lumen-studio \
|
|
80
|
+
--palette sage \
|
|
81
|
+
--page /=onePage \
|
|
82
|
+
--page /resources=resources \
|
|
83
|
+
--include-sections \
|
|
84
|
+
--stage-only
|
|
85
|
+
|
|
86
|
+
# 2. Shell — capacity match, then activate
|
|
87
|
+
raybase templates shell match --nav-items 5 --nav-depth flat --footer-links 12 --footer-columns 3 --cta --theme raybase/lumen-studio --json
|
|
88
|
+
raybase templates shell add lumen-site-layout --activate --stage-only
|
|
89
|
+
|
|
90
|
+
# 3. Apply + verify
|
|
91
|
+
pnpm --dir site run templates:apply
|
|
92
|
+
raybase templates doctor
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
`shell add` defaults `--palette` to the theme's selected palette (from the lock), so you usually omit it after `theme add`. Pass `--palette <name>` to override. Use `--registry <path-or-url>` for local registry development, and `--require-remote` on search to prove the hosted semantic registry rather than accepting offline fallback.
|
|
96
|
+
|
|
97
|
+
For a non-standard menu name on a standalone nav/footer template, use the same
|
|
98
|
+
binding vocabulary as collection sources with the `menu:` prefix:
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
raybase templates add raybase/example-nav --bind links=menu:primary --stage-only
|
|
102
|
+
raybase templates add raybase/example-footer --bind footerLinks=menu:footer --stage-only
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
If no shell satisfies the capacity, `shell match` says so: loosen the nav/footer requirements, split a nav into a dropdown, or (rarely) borrow a higher-capacity shell from another family — the shell is globally selectable.
|
|
106
|
+
|
|
107
|
+
**One-page sites** are a popular shape and adjust both steps:
|
|
108
|
+
|
|
109
|
+
- Step 1: the family's one-page starter *is* the product — read its composition before anything else; `--pages onePage` puts starter coverage in the match matrix.
|
|
110
|
+
- Step 2: query `shell match --anchor --nav-items <promoted-anchor-count>` — often `--nav-items 0`. A brand-bar shell (`navItems.min` 0) still renders the logo/header block and CTA with zero links; one-page sites usually want that brand block even without a nav. Expect `footerGrade` micro — the footer still carries contact and legal. One page ≠ one route: stage prose pages for `/privacy`/`/terms` alongside `--page /=onePage`.
|
|
111
|
+
- Anchor targets are the starter's job, not the shell's — follow the galley skill's one-page anchor convention before editing the starter's `{% render %}` composition.
|
|
112
|
+
|
|
113
|
+
**Palette is a design decision, not a menu pick.** Arbitrate between two
|
|
114
|
+
candidates and record which won and why:
|
|
115
|
+
|
|
116
|
+
1. **The brand's compiled palette.** Compile the direction's color-strategy line
|
|
117
|
+
into a candidate: `raybase palettes compile --strategy <restrained|committed|full|drenched> --hue <deg|name> --scheme <light|dark|both>`.
|
|
118
|
+
It emits an OKLCH shadcn-semantic-v1 palette with provenance and self-gates
|
|
119
|
+
on WCAG AA.
|
|
120
|
+
2. **The theme's signature palettes** — the family's own opinion, listed on its
|
|
121
|
+
registry entry (`raybase templates info`).
|
|
122
|
+
|
|
123
|
+
Choose one, then **gate it**: after `theme add`, run `raybase palettes check`
|
|
124
|
+
(WCAG contrast over every token pair, APCA advisory; also run inside `raybase
|
|
125
|
+
doctor`). "Verify with a checker, not your eyes" is now tooling — treat a
|
|
126
|
+
contrast failure as a defect, not a suggestion.
|
|
127
|
+
|
|
128
|
+
`--palette` is **required whenever the theme lists more than one palette**:
|
|
129
|
+
colors get the same explicit-choice rule as layouts, so an ambiguous palette
|
|
130
|
+
errors (`has multiple palettes. Choose one with --palette …`) instead of
|
|
131
|
+
silently falling back to the theme's `defaultPalette`. Single-palette themes
|
|
132
|
+
still resolve without the flag. It accepts the keys the theme's registry entry
|
|
133
|
+
lists under `palettes` (shown by `raybase templates info`). Inspect the
|
|
134
|
+
per-palette metadata there before choosing: `standard` palettes are shared
|
|
135
|
+
registry artifacts, `signature` palettes belong to one theme family, a
|
|
136
|
+
`colorScheme` of `dark` or `light` marks a single-scheme palette that
|
|
137
|
+
renders that scheme unconditionally (never add a light/dark mode toggle
|
|
138
|
+
while one is active — gate any toggle on the generated `PALETTE_SCHEMES`
|
|
139
|
+
map in `site/src/lib/palettes.gen.ts`), and font
|
|
140
|
+
declarations determine the generated Fontsource imports and `site/package.json`
|
|
141
|
+
dependency updates.
|
|
142
|
+
|
|
143
|
+
If you do not run `shell add --activate` (no shell fits, or you are only
|
|
144
|
+
staging drafts for review), the site keeps the starter's static
|
|
145
|
+
`SiteLayout.astro` shell: the theme's sections and page starters stay staged as
|
|
146
|
+
drafts and render inside the static layout. Activation is a shell concern —
|
|
147
|
+
there is nothing to activate without a chosen shell.
|
|
148
|
+
|
|
149
|
+
## Assembly Rules
|
|
150
|
+
|
|
151
|
+
- Staged templates live in `site/seed/templates/<template-id>/template.json`; staged page seeds live in `site/seed/pages/<slug>.json`; activation intent is an ephemeral `site/seed/templates/<layout-id>/activation.json` work order written by `shell add --activate`.
|
|
152
|
+
- `raybase templates theme add` writes `site/src/styles/palettes.gen.css`, `site/src/styles/palette-fonts.gen.css`, `site/src/lib/palettes.gen.ts`, and any needed Fontsource package entries in `site/package.json`; keep those generated artifacts with the staged templates. It stages sections and page seeds as **drafts** (`publish: false`) and never activates structure.
|
|
153
|
+
- If theme installation changes `site/package.json` (usually Fontsource
|
|
154
|
+
packages), run `pnpm install` before `site` check/build/dev. If pnpm warns
|
|
155
|
+
that native package build scripts were ignored and a CLI command later fails
|
|
156
|
+
to load a native binding, rebuild that dependency before treating the app as
|
|
157
|
+
broken.
|
|
158
|
+
- `raybase templates shell add <layout-id> --activate` installs the layout with its welded nav + footer (via the requires-graph), writes the activation intent, and flips the theme's staged page seeds to `publish: true`. On `templates:apply` this consumes (and deletes) the work order, publishes the selected templates + pages, and sets the active Galley layout pointer and palette. Without `--activate`, the shell is staged as drafts for review. The chosen shell is recorded in `.raybase/templates.json` under `shell`, beside `theme`.
|
|
159
|
+
- To re-activate after `templates:apply` has consumed the work order (for example after editing staged defaults), run `raybase templates shell activate` — it rewrites only `activation.json` and the page-seed publish flips. Never re-run `shell add --overwrite` just to re-stage activation: `--overwrite` re-fetches the layout and its welded nav/footer from the registry and resets any locally edited partials.
|
|
160
|
+
- Swapping a nav or footer *within* a shell has no CLI flag by design: install the replacement with `raybase templates add <nav-or-footer-id>`, hand-edit the layout's `{% render %}` lines, and record a Deviation. See the galley skill's shell-swap recipe.
|
|
161
|
+
- Page starters are real Liquid surface templates that compose the family's sections with `{% render "section-id" %}` (bare ids; resolution goes through the app's installed templates, never per-reference version pins). Staged page seeds are v2 design pointers — `{"schemaVersion": 2, "slug", "title", "publish", "design": {"templateId", "templateVersion", "data", "richText"}}` — not Portable Text block graphs.
|
|
162
|
+
- Adapt a starter before apply by editing its staged `template.liquid`: add, remove, or reorder `{% render %}` lines and pass app-specific data down through render arguments.
|
|
163
|
+
- Preserve `provenance.json`, `.raybase/templates.json`, and the generated theme files; update/fork flows and doctor checks depend on those hashes and artifact paths to avoid overwriting local adaptations.
|
|
164
|
+
|
|
165
|
+
## Adaptation
|
|
166
|
+
|
|
167
|
+
Work homepage-first:
|
|
168
|
+
|
|
169
|
+
1. Stage with `--stage-only`, then review the staged homepage starter's `{% render %}` composition before running `templates:apply`.
|
|
170
|
+
2. Replace registry sample copy with app-specific copy in the staged files -
|
|
171
|
+
cheaper than editing after publish. Inspect the staged shell nav/footer too:
|
|
172
|
+
menu-bound templates keep local `links` defaults that seed missing menus on
|
|
173
|
+
`templates:apply`; make those defaults match the actual IA before apply.
|
|
174
|
+
Keep `_key`s stable and leave `provenance.json` untouched.
|
|
175
|
+
3. Apply, place, and browser-check the homepage, then walk the secondary pages the same way.
|
|
176
|
+
4. Only then consider bespoke template edits (fields, `dataSources`) per the galley skill's authoring rules.
|
|
177
|
+
|
|
178
|
+
- Edit staged Liquid, sample content, or page seeds when the registry baseline needs app-specific language, fields, or collection mapping. For page structure, edit the starter's `{% render %}` composition rather than the page seed; the seed only points at the starter through its `design` field.
|
|
179
|
+
- Prefer Galley templates for ordinary marketing and editorial sections. Use Astro components only for route shells, metadata, custom data fetching, Raybase Server Islands, and non-content behavior.
|
|
180
|
+
- When a selected template declares `galley.dataSources`, validate each
|
|
181
|
+
`--bind alias=collection` against the real EmDash schema when possible, and
|
|
182
|
+
each `--bind alias=menu:<name>` against the planned menu name/shape. After
|
|
183
|
+
apply, keep the planned menus reflected in `site/seed/seed.json`: the current
|
|
184
|
+
`raybase doctor`/`raybase templates doctor` capacity check reads those seeded
|
|
185
|
+
`primary`/`footer` menus for the active shell, warning when `primary`'s
|
|
186
|
+
top-level item count falls outside the shell's nav capacity or when `footer`
|
|
187
|
+
has too many top-level columns.
|
|
188
|
+
- When the site plan has a posts-like collection (blog, journal, news), select
|
|
189
|
+
the theme's **article starter** (`choices.pageStarters.article`) alongside
|
|
190
|
+
the blog index — an index with no detail page is half a blog. Article
|
|
191
|
+
starters are entry-hosted: install with `raybase templates add <starter-id>
|
|
192
|
+
--bind <contextKey>=<collection>` when the app's collection is not the
|
|
193
|
+
registry convention, and `templates:apply` gives the collection a design
|
|
194
|
+
field defaulting every entry to the starter. See the galley skill's
|
|
195
|
+
"Entry-Hosted Detail Pages".
|
|
196
|
+
|
|
197
|
+
## Verification
|
|
198
|
+
|
|
199
|
+
- Run `pnpm --dir site run templates:apply` with the site dev server running.
|
|
200
|
+
- `templates:apply` uses the local setup dev-bypass route. If the scaffold is
|
|
201
|
+
running under Raybase auth or a production-mode Wrangler preview where that
|
|
202
|
+
route is blocked, use a real signed-in/admin apply path for the app or record
|
|
203
|
+
the local-only limitation in the migration/design notes instead of assuming
|
|
204
|
+
the staged templates were applied.
|
|
205
|
+
- Run `raybase palettes check` (WCAG contrast gate over the generated palette CSS), `raybase templates doctor`, `raybase doctor`, and `raybase check`.
|
|
206
|
+
- Run the Browser Verification recipe in `.agents/skills/raybase-astro-emdash/SKILL.md`: `/` and each staged secondary page must render the selected header, footer, layout, generated palette, generated font imports, any active Galley `paletteCss` overlay, and page content publicly.
|
|
207
|
+
- Public pages should render published templates only; if active layout rendering fails, fix the staged templates or re-run activation rather than relying on the static fallback.
|
|
208
|
+
- After installing an article starter, open one collection entry's public URL
|
|
209
|
+
and confirm the detail page renders from the entry (title, image, rails)
|
|
210
|
+
and that Edit mode lights up its context markers (hub skill's editability
|
|
211
|
+
gate).
|
|
212
|
+
- If `astro dev` trips Cloudflare/Vite dependency optimizer issues, verify the
|
|
213
|
+
built Worker with `astro build` plus `wrangler dev --config
|
|
214
|
+
dist/server/wrangler.json`. Seed and inspect the exact D1 state path used by
|
|
215
|
+
that Wrangler process, and remember that `dist/server/.wrangler` is removed
|
|
216
|
+
by rebuilds unless you intentionally preserve or recreate it.
|