@raybase/create 0.0.2 → 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,265 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: raybase-astro-emdash-galley
|
|
3
|
+
description: Build runtime-editable public Astro/EmDash page sections with Galley templates, Portable Text Galley blocks, shared blocks, and designed fields in raybase astro-emdash apps.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Raybase Astro/EmDash Galley Skill
|
|
7
|
+
|
|
8
|
+
Use this skill when changing public content sections in an `astro-emdash` app.
|
|
9
|
+
Galley is the default page-section authoring layer: templates live in EmDash
|
|
10
|
+
plugin storage, instances live in EmDash content fields, and the Astro route
|
|
11
|
+
renders them at request time.
|
|
12
|
+
|
|
13
|
+
## Read Order
|
|
14
|
+
|
|
15
|
+
1. Read `.agents/skills/raybase-astro-emdash/SKILL.md`.
|
|
16
|
+
2. Read `dev/SPEC.md`, `dev/SPEC-OVERVIEW.md`, and `dev/CODEBASE-MAP.md`.
|
|
17
|
+
3. Inspect `site/src/pages/[...slug].astro`, `site/seed/seed.json`, and any existing Galley templates or blocks in EmDash before changing page sections.
|
|
18
|
+
|
|
19
|
+
## Default Pattern
|
|
20
|
+
|
|
21
|
+
- Use the pages collection `design` field (a `galley:block` designed field) when a page's structure comes from a page-starter template; the public route renders `design.templateId` when set and falls back to `pages.content` Portable Text.
|
|
22
|
+
- Use `pages.content` Portable Text for editable prose. `galley.block` (page-local) and `galley.shared` (reusable) embeds live inline in that prose; they are not page structure.
|
|
23
|
+
- Prefer Raybase Templates for reusable runtime-editable sections, layouts (shells), page starters, and guided theme families when registry content fits. For full-site assembly, read `.agents/skills/raybase-astro-emdash-theme-selection/SKILL.md` and select a theme (voice + vocabulary — palette, sections, page starters) then a shell (the layout with its welded nav + footer, chosen by capacity) before activation.
|
|
24
|
+
- Installed Templates are staged under `site/seed/templates/`; page starters also stage v2 page seeds (`design` pointers) under `site/seed/pages/`. Apply them locally with `pnpm --dir site run templates:apply`, then review drafts; apply activates structure only when an `activation.json` work order staged by `templates shell add --activate` is present, and deletes it once consumed.
|
|
25
|
+
- Use `raybase templates add <id> --bind <alias=collection>` or `raybase templates theme add <theme-id> --bind <alias=collection>` when a selected template needs an EmDash collection data source override. For menu-bound nav/footer templates, use `--bind <alias>=menu:<name>` (usually `links=menu:primary`, `footerLinks=menu:footer`, `socialLinks=menu:social`, or `legalLinks=menu:legal`).
|
|
26
|
+
- This skill assumes the bound EmDash collections already exist. To model collections, fields, bindings, and seed content (`site/seed/seed.json`), read `.agents/skills/raybase-astro-emdash-content-model/SKILL.md` first.
|
|
27
|
+
- Use `widget: "galley:block"` JSON fields plus `<DynamicField />` only when a collection entry needs a designed field outside a Portable Text body.
|
|
28
|
+
- Publish Galley templates before relying on them on the public site.
|
|
29
|
+
- Keep every Portable Text block node keyed with `_key`; Galley edit context depends on stable block keys.
|
|
30
|
+
|
|
31
|
+
## What Stays In Astro
|
|
32
|
+
|
|
33
|
+
Use Astro source for route shells, metadata/layout, `raybase.actionIsland`, allow-listed Raybase Server Island proxies, custom data fetching, and non-content app behavior. Do not create new Astro components for ordinary marketing, editorial, hero, feature, CTA, media, testimonial, pricing, FAQ, or landing-page sections unless the approved spec explicitly requires non-content runtime behavior. The same rule covers `site/src/pages/[...slug].astro` itself: never replace its designed/Portable-Text render paths with hard-coded page markup — a page rendered outside those paths emits no edit annotations and silently disconnects the EmDash visual editor. If a spec truly requires custom entry markup (record it as a Deviation), it must spread EmDash edit annotations (`{...entry.edit.<field>}` → `data-emdash-ref`) on every content-derived element, and the Deviation is only complete when edit mode still lights the page up.
|
|
34
|
+
|
|
35
|
+
## Template Authoring
|
|
36
|
+
|
|
37
|
+
- Create or update templates through EmDash admin, Operator/MCP tools, or the Galley plugin API at `/_emdash/api/plugins/galley/templates/save`.
|
|
38
|
+
- Keep template ids lowercase dash-case and stable once content references them.
|
|
39
|
+
- Define `fields` for every editable value. Prefer explicit scalar fields, `portableText` fields for rich body copy, `list` fields for repeated cards, and `group` fields for structured clusters.
|
|
40
|
+
- Mark inline-editable Liquid output with Galley attributes such as `data-dynamic-text`, `data-dynamic-href`, `data-dynamic-src`, `data-dynamic-alt`, `data-dynamic-title`, `data-dynamic-aria-label`, `data-dynamic-list`, and `data-dynamic-list-item`.
|
|
41
|
+
- Content facts from CMS entries come through **typed template context** (see the next section), never through field bindings — the old ambient `entry.*` binding vocabulary was removed in galley 0.6 and now fails validation with "uses removed entry.* context; declare template.context". `fields` are local surface settings only (accent, CTA label, layout toggles).
|
|
42
|
+
- Use `dataSources` for collection/list data instead of ad hoc Liquid queries. A `where` value may be a context path (`"author": "post.author"`) — it resolves against the declared context entry at render time.
|
|
43
|
+
- Use `dataSources` for menus instead of local nav/footer copies. Menu data
|
|
44
|
+
source aliases intentionally shadow local fields of the same name, so a
|
|
45
|
+
template can keep `fields.links.default` for install seeding and previews
|
|
46
|
+
while production render reads `dataSources.links = { "kind": "menu",
|
|
47
|
+
"menu": "primary" }`.
|
|
48
|
+
- Keep Liquid local and deterministic. Do not fetch external data from Liquid templates.
|
|
49
|
+
|
|
50
|
+
Compose templates with `{% render "template-id" %}`. The tag accepts section (surface-role) and partial targets; layout-role targets are forbidden. Use bare template ids only — resolution goes through the app's installed templates, with no per-reference version pinning. A failed render degrades to an HTML comment in production and a visible error card in editing/preview, so a broken reference never breaks the page. Page starters and layouts are themselves such compositions: a page starter renders its sections, a layout renders its nav/footer and declares only a `content` slot. Render arguments pass values into the child's fields (`{% render "cta", label: heading %}`) and entries into its declared context (`{% render "post-header", post: post %}`).
|
|
51
|
+
|
|
52
|
+
## Typed Template Context
|
|
53
|
+
|
|
54
|
+
A template declares the CMS entries its Liquid reads as named, typed context
|
|
55
|
+
(galley 0.6+). Context is how content facts reach templates; `fields` carry
|
|
56
|
+
only local presentation settings.
|
|
57
|
+
|
|
58
|
+
```json
|
|
59
|
+
"context": {
|
|
60
|
+
"post": { "kind": "entry", "collection": "posts", "source": "host" }
|
|
61
|
+
}
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
- `source: "host"` resolves the entry from the render surface — the entry
|
|
65
|
+
whose designed field is being rendered. `source: "argument"` receives the
|
|
66
|
+
entry from a `{% render %}` argument (sections composed by a starter).
|
|
67
|
+
`source: { "from": "post.author" }` chases a reference field on another
|
|
68
|
+
context entry.
|
|
69
|
+
- Liquid reads typed objects: `{{ post.title }}`, `{{ post.image.src }}`.
|
|
70
|
+
Mark entry-owned output with context-path markers so the visual editor
|
|
71
|
+
routes edits to the entry: `data-dynamic-text="post.title"`,
|
|
72
|
+
`data-dynamic-src="post.image"`, and
|
|
73
|
+
`<div data-dynamic-portable-text="post.content">{{ post.content | portable_text }}</div>`
|
|
74
|
+
for long-form Portable Text bodies. Context media fields open the media
|
|
75
|
+
picker; `json` context fields are read-only.
|
|
76
|
+
- Data-source loops over entries support per-item editing: wrap each iteration
|
|
77
|
+
in `data-dynamic-item="<dataSourceKey>" data-dynamic-item-id="{{ item.id }}"`.
|
|
78
|
+
Galley annotates resolvable scopes with the entry identity (hover affordance
|
|
79
|
+
plus "Edit in admin"), and `data-dynamic-*` markers inside the scope route
|
|
80
|
+
to that entry. Unresolvable scopes are neutralized with a preview warning.
|
|
81
|
+
|
|
82
|
+
## Menu Data Sources
|
|
83
|
+
|
|
84
|
+
Use EmDash menus for nav and footer link rows. The standard menu names are
|
|
85
|
+
`primary`, `footer`, `social`, and `legal`; record any deliberate non-standard
|
|
86
|
+
name in the site plan and bind it explicitly with `--bind alias=menu:name`.
|
|
87
|
+
|
|
88
|
+
Menu-bound templates keep the local list field and bind a menu with the same
|
|
89
|
+
alias:
|
|
90
|
+
|
|
91
|
+
```json
|
|
92
|
+
{
|
|
93
|
+
"fields": {
|
|
94
|
+
"links": {
|
|
95
|
+
"label": "Links",
|
|
96
|
+
"kind": "list",
|
|
97
|
+
"fields": {
|
|
98
|
+
"label": { "kind": "string", "label": "Label" },
|
|
99
|
+
"url": { "kind": "url", "label": "URL" },
|
|
100
|
+
"target": { "kind": "string", "label": "Target" }
|
|
101
|
+
},
|
|
102
|
+
"default": [
|
|
103
|
+
{ "label": "Home", "url": "/" },
|
|
104
|
+
{ "label": "Work", "url": "/work" },
|
|
105
|
+
{ "label": "Contact", "url": "/contact" }
|
|
106
|
+
]
|
|
107
|
+
}
|
|
108
|
+
},
|
|
109
|
+
"dataSources": {
|
|
110
|
+
"links": { "kind": "menu", "menu": "primary" }
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
The local default is not duplicate production state: it seeds a missing menu on
|
|
116
|
+
`templates:apply`, keeps the lab preview useful, and keeps old CLI installs
|
|
117
|
+
from rendering an empty nav. The menu wins at runtime whenever the source
|
|
118
|
+
resolves.
|
|
119
|
+
|
|
120
|
+
Wrap the loop with a list marker and mark editable item fields by alias path:
|
|
121
|
+
|
|
122
|
+
```liquid
|
|
123
|
+
<nav data-dynamic-list="links" aria-label="Primary">
|
|
124
|
+
{% for link in links %}
|
|
125
|
+
<a
|
|
126
|
+
href="{{ link.url | default: '#' }}"
|
|
127
|
+
{% if link.target %}target="{{ link.target | escape }}"{% endif %}
|
|
128
|
+
data-dynamic-list-item="links.{{ forloop.index0 }}"
|
|
129
|
+
data-dynamic-href="links.{{ forloop.index0 }}.url"
|
|
130
|
+
data-dynamic-text="links.{{ forloop.index0 }}.label"
|
|
131
|
+
>{{ link.label | escape }}</a>
|
|
132
|
+
{% endfor %}
|
|
133
|
+
</nav>
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
`link.children` is available for dropdown navs and column footers. For sitemap
|
|
137
|
+
or standard column footers, bind one `footer` menu: top-level items are column
|
|
138
|
+
headings, each heading's `children` are the column links. Social and legal rows
|
|
139
|
+
stay separate flat menus.
|
|
140
|
+
|
|
141
|
+
Menu edit semantics are live: visual-editor add, reorder, duplicate, remove,
|
|
142
|
+
label, URL, and target edits write directly through EmDash menus, with no draft
|
|
143
|
+
or revision layer. The visual editor edits top-level menu items only today;
|
|
144
|
+
nested dropdown children and footer column contents are edited through
|
|
145
|
+
`/_emdash/admin/menus/<name>`, reachable from the toolbar's "Open in EmDash"
|
|
146
|
+
deep link. Reference-type menu item URLs are read-only in the popover because
|
|
147
|
+
they follow the referenced entry's URL.
|
|
148
|
+
|
|
149
|
+
## Entry-Hosted Detail Pages
|
|
150
|
+
|
|
151
|
+
A collection's detail page (a post, article, book, product page) is a shared
|
|
152
|
+
**entry-hosted page starter**, not a per-entry composition and never bespoke
|
|
153
|
+
Astro markup. The starter declares `context.post` with `source: "host"`, its
|
|
154
|
+
manifest carries a `host` block (`{ "collection": "articles", "contextKey":
|
|
155
|
+
"post" }`), and installation ships a `host.json` staging artifact that gives
|
|
156
|
+
the bound collection a `galley:block` design field whose options default every
|
|
157
|
+
entry to the starter — galley's value-less render then makes it the page for
|
|
158
|
+
every entry, with no per-entry seeding. Editors change the entry; the page
|
|
159
|
+
follows.
|
|
160
|
+
|
|
161
|
+
- Editability rule: every collection whose entries get public detail pages
|
|
162
|
+
must have a `galley:block` design field bound to an entry-hosted page
|
|
163
|
+
starter this way. Never hand-write Astro/HTML section markup for content
|
|
164
|
+
pages — hand-written markup renders fine but is invisible to the visual
|
|
165
|
+
editor (no `data-dynamic-*` annotations, nothing editable). If no fitting
|
|
166
|
+
registry starter exists, adapt one rather than writing raw markup.
|
|
167
|
+
- Install with `raybase templates add <starter-id> --bind <contextKey>=<collection>`
|
|
168
|
+
when the app's collection differs from the registry convention
|
|
169
|
+
(`--bind post=posts`); the binding retargets the host collection, every
|
|
170
|
+
context declaration in the install graph, and the starter's rails that
|
|
171
|
+
queried the convention collection. Then `pnpm --dir site run templates:apply`
|
|
172
|
+
publishes the templates and creates the design field.
|
|
173
|
+
- The public catch-all renders the designed page automatically: it resolves
|
|
174
|
+
the collection's design field from the EmDash schema and renders
|
|
175
|
+
`value ?? null` (schema default template) with the entry as host context.
|
|
176
|
+
- Adapting a detail starter to a bespoke collection (books, case studies) is
|
|
177
|
+
normal: install the nearest starter, then edit the installed Liquid/context
|
|
178
|
+
declarations to the collection's field slugs. Keep the context declarations
|
|
179
|
+
and markers intact — they are what keep the page editable.
|
|
180
|
+
|
|
181
|
+
## App Setup
|
|
182
|
+
|
|
183
|
+
- `site/astro.config.mjs` must register `plugins: [galley()]` inside `emdash(...)`.
|
|
184
|
+
- `site/src/pages/[...slug].astro` must render `PortableText` with `@raybase/galley/astro` `blockComponents` and attach `getEditMeta()` context to `galley.block` and `galley.shared` nodes.
|
|
185
|
+
- Portable Text-embedded Galley blocks need a real EmDash edit-mode session
|
|
186
|
+
(`emdash-edit-mode=true` cookie) for SSR source maps. In standalone
|
|
187
|
+
`?dynamicBlocksEditor=1` sessions, linked-source editing for PT-embedded
|
|
188
|
+
blocks may classify bindings only after the first live re-render; use the
|
|
189
|
+
EmDash edit-mode toolbar when verifying menu or entry-bound source editing
|
|
190
|
+
inside Portable Text.
|
|
191
|
+
- Local starter bootstrap: with the site dev server running, `pnpm --dir site run seed:galley` installs a sample published Galley template and updates the home page to use it. Prefer the Template bootstrap below when registry content fits; `seed:galley` is the no-registry fallback.
|
|
192
|
+
- Template bootstrap: `raybase templates add <id> --stage-only`, `raybase templates theme add <theme-id> --stage-only`, and `raybase templates shell add <layout-id> --stage-only` write draft template payloads and provenance, and `pnpm --dir site run templates:apply` pushes them to the local Galley API. `shell add --activate` stages an ephemeral `site/seed/templates/<layout-id>/activation.json` work order; apply consumes and deletes it, publishing the selected public templates and setting the active Galley layout pointer and palette.
|
|
193
|
+
- For production or existing content databases, create templates and content through EmDash admin or MCP/operator tools instead of relying on the local dev bootstrap.
|
|
194
|
+
|
|
195
|
+
## Demo Starter Set
|
|
196
|
+
|
|
197
|
+
`site/demo/` is a worked example of every wiring pattern in this skill, in the
|
|
198
|
+
standard file-installable Template format. Read it before authoring your first
|
|
199
|
+
template — reading needs no dev server and is the intended use:
|
|
200
|
+
|
|
201
|
+
- `templates/demo-article-page/` — entry-hosted page starter: `context.post`
|
|
202
|
+
with `source: "host"`, the manifest `host` block, `host.json` (the design
|
|
203
|
+
field seed), `data-dynamic-text`/`data-dynamic-portable-text` markers, and a
|
|
204
|
+
local presentation field (`backLabel`) beside entry-owned facts.
|
|
205
|
+
- `templates/demo-articles-index/` — a `dataSources` collection query looped
|
|
206
|
+
with `data-dynamic-item`/`data-dynamic-item-id` per-entry edit markers,
|
|
207
|
+
`{% render "demo-article-card", article: article %}` composition, a staged
|
|
208
|
+
v2 `page.json`, and the list-default idiom: the `notes` list carries its
|
|
209
|
+
content in the field's `default`, because list data declared only in sample
|
|
210
|
+
content renders empty once a page composes the template.
|
|
211
|
+
- `templates/demo-article-card/` — a partial fed by render arguments through
|
|
212
|
+
a `group` field with a standalone-preview default.
|
|
213
|
+
- `templates/demo-menu-nav/` — a menu-bound nav partial: local `links`
|
|
214
|
+
defaults beside `dataSources.links = { "kind": "menu", "menu": "primary" }`,
|
|
215
|
+
`data-dynamic-list` ownership markers, per-item label/URL markers, a target
|
|
216
|
+
control through the menu-item popover, and the seed-on-apply fallback pattern
|
|
217
|
+
used by real nav/footer templates. It is inspect-first and not installed by
|
|
218
|
+
`demo:load`, because `primary` is live owner data rather than draft demo
|
|
219
|
+
content.
|
|
220
|
+
- `content/collection.json` and `content/entries.json` — the collection schema
|
|
221
|
+
(its `urlPattern` routes entries to the entry-hosted page) and draft entries
|
|
222
|
+
whose Portable Text bodies explain the wiring from the reader's side.
|
|
223
|
+
|
|
224
|
+
Optionally load it live: `pnpm --dir site run demo:load` (site dev server
|
|
225
|
+
running) creates the draft `demoarticles` collection and entries, installs
|
|
226
|
+
the three templates through the real `raybase templates add file://…` path,
|
|
227
|
+
and applies them. Everything stays draft — nothing renders publicly. It writes
|
|
228
|
+
`.raybase/galley-demo.json`, and `raybase doctor` warns until
|
|
229
|
+
`pnpm --dir site run demo:unload` removes the collection, entries, page,
|
|
230
|
+
staged seeds, and lock entries. The demo is teaching material: copy its wiring
|
|
231
|
+
(typed context, field defaults, collection dataSources, menu dataSources),
|
|
232
|
+
never its look — real pages come from registry Templates via the
|
|
233
|
+
theme-selection skill. Never deploy with the demo loaded.
|
|
234
|
+
|
|
235
|
+
## Shell Nav/Footer Swap Recipe
|
|
236
|
+
|
|
237
|
+
A shell welds one nav and one footer into its layout Liquid — that is intentional (the pair are the bookends of every page and the layout owns their physics). Selecting a *different* shell is the normal move. But swapping just the nav or footer *within* a shell has **no CLI flag by design**; composition edits are Liquid's job everywhere else in the system, and the shell is no exception. Divorce is available — you just file the paperwork:
|
|
238
|
+
|
|
239
|
+
1. Install the replacement partial: `raybase templates add <other-nav-or-footer-id> --stage-only`.
|
|
240
|
+
2. Hand-edit the shell layout's staged `template.liquid` (`site/seed/templates/<layout-id>/template.json` → `liquidSource`): rewrite the `{% render "old-nav" %}` / `{% render "old-footer" %}` line to render the replacement id. Match the layout's container/height contract so the handoff from last band to footer still holds.
|
|
241
|
+
3. Update the layout manifest's `relations.requires` to include the replacement (so the dependency graph and doctor stay honest). Leave the `shell.*` provenance block untouched — it records what the shell *shipped* with; the swap is a local deviation, not a new shell.
|
|
242
|
+
4. Record a **Deviation** in `DESIGN.md`: "swapped `<layout>`'s footer to `<other-footer>` — needed a sitemap-grade footer the family didn't ship." Recurring swaps like this are exactly the signal the registry uses to author a missing shell.
|
|
243
|
+
|
|
244
|
+
## One-Page Anchor Targets
|
|
245
|
+
|
|
246
|
+
Anchor-tuned shells (`shell.capacity.anchorNav`) point their nav links at same-page anchors (`#work`, `#pricing`). The anchor targets belong to the **page starter**, not the shell and not the section templates:
|
|
247
|
+
|
|
248
|
+
- Wrap each anchored band in the starter's Liquid: `<div id="work" class="scroll-mt-24">{% render "family-work-band" %}</div>`. Ids are stable kebab-case names matching the nav's anchor hrefs; `scroll-mt-*` keeps a sticky nav from overlapping the scrolled-to band — size it to the shell's header height.
|
|
249
|
+
- Do not put ids inside section templates: sections repeat across pages and would duplicate ids. Do not gate anchored bands behind scroll-triggered visibility — a nav jump to a hidden band lands on nothing.
|
|
250
|
+
- An anchor-tuned nav with zero links still renders the brand block (and CTA when declared) — a brand bar, never an empty strip.
|
|
251
|
+
|
|
252
|
+
## Behavior And Motion
|
|
253
|
+
|
|
254
|
+
- Templates that declare `data-rb-motion` use `site/src/lib/site-motion.ts`.
|
|
255
|
+
- Do not treat `motion.strategy: "site-helper-v1"` as a missing JavaScript sidecar.
|
|
256
|
+
- Basecoat and future behavior sidecars are Galley/template-host concerns. Do not hand-roll them in React app UI.
|
|
257
|
+
|
|
258
|
+
## Verification
|
|
259
|
+
|
|
260
|
+
Run relevant checks before handoff:
|
|
261
|
+
|
|
262
|
+
- `pnpm --dir site run check`
|
|
263
|
+
- `raybase doctor`
|
|
264
|
+
- `raybase check`
|
|
265
|
+
- Browser smoke test `/`, `/_emdash/admin/plugins/galley/templates`, and any edited page while signed in through the Raybase handoff.
|
|
@@ -0,0 +1,218 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: raybase-astro-emdash-migration
|
|
3
|
+
description: Inventory and migrate an existing public site into a Raybase Astro/EmDash content site, preserving meaning, owner-approved URLs, media references, and content parity while redesigning through the normal site-planning, theme, and Galley skills.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Raybase Astro/EmDash Migration Skill
|
|
7
|
+
|
|
8
|
+
Use this skill when `dev/SPEC.md` says an `astro-emdash` app is migrating
|
|
9
|
+
content from an existing public site. This skill runs after spec approval and
|
|
10
|
+
before the content-model skill: it produces the inventory, URL map, media list,
|
|
11
|
+
and conversion decisions that the site plan consumes.
|
|
12
|
+
|
|
13
|
+
Default: migrate the existing site's meaning and content into a new Raybase
|
|
14
|
+
Sites design system. Faithful visual reproduction is an explicit owner-approved
|
|
15
|
+
exception, and even then stays inside the starter's token contract, Galley
|
|
16
|
+
templates, and editor-owned content model.
|
|
17
|
+
|
|
18
|
+
## Read Order
|
|
19
|
+
|
|
20
|
+
1. Read `.agents/skills/raybase-astro-emdash/SKILL.md` for the site/spine
|
|
21
|
+
ownership boundaries.
|
|
22
|
+
2. Read `dev/SPEC.md`, `dev/SPEC-OVERVIEW.md`, and `dev/CODEBASE-MAP.md`.
|
|
23
|
+
3. Read
|
|
24
|
+
[references/inventory-and-conversion.md](references/inventory-and-conversion.md).
|
|
25
|
+
4. Produce or update `dev/migration/inventory.md`.
|
|
26
|
+
5. Continue into `.agents/skills/raybase-astro-emdash-content-model/SKILL.md`
|
|
27
|
+
using the inventory as an input to the Site plan.
|
|
28
|
+
|
|
29
|
+
## Migration Stance
|
|
30
|
+
|
|
31
|
+
Agree the stance with the owner before collecting or converting content:
|
|
32
|
+
|
|
33
|
+
- **Redesign is the default.** Preserve content, IA intent, editorial voice,
|
|
34
|
+
media, and URLs where useful; express the site through a registry theme,
|
|
35
|
+
page starters, Galley sections, and EmDash collections.
|
|
36
|
+
- **Faithful reproduction is exceptional.** It requires explicit approval and
|
|
37
|
+
must still fit the starter. Do not promise pixel-matching another builder,
|
|
38
|
+
recreating proprietary widgets, or bypassing Galley/editor boundaries.
|
|
39
|
+
- **URLs are a product decision.** Preserve slugs for kept pages whenever
|
|
40
|
+
possible with page slugs or collection `urlPattern`s. Record renames and
|
|
41
|
+
drops in the URL map.
|
|
42
|
+
- **Copy improvements are separate.** Migrate owner copy as written unless the
|
|
43
|
+
owner approves an edit. Record proposed rewrites as recommendations, not as
|
|
44
|
+
silent conversion changes.
|
|
45
|
+
|
|
46
|
+
## Inventory Rules
|
|
47
|
+
|
|
48
|
+
Inventory comes from browser investigation only. Use whatever browser, fetch,
|
|
49
|
+
or Playwright tooling the harness provides to inspect the live public site:
|
|
50
|
+
start with public discovery surfaces such as `/sitemap.xml` when available,
|
|
51
|
+
then treat the rendered live navigation and footer as the IA ground truth, and
|
|
52
|
+
walk every discoverable page. Do not ask for or depend on CMS exports,
|
|
53
|
+
WordPress XML/WXR, database dumps, platform APIs, or private admin access.
|
|
54
|
+
|
|
55
|
+
Create `dev/migration/inventory.md` from the reference template. It must
|
|
56
|
+
include:
|
|
57
|
+
|
|
58
|
+
- Page inventory: old URL, title, purpose, observed content, and keep/merge/drop
|
|
59
|
+
recommendation.
|
|
60
|
+
- Repeated content types with real counts: articles, products, books, team,
|
|
61
|
+
events, testimonials, FAQs, resources, or whatever the site actually has.
|
|
62
|
+
- Media inventory: each image/file slot, the page or entry using it, current
|
|
63
|
+
source URL, intended destination, alt text status, and whether it came from
|
|
64
|
+
the old site or is a new stock stand-in.
|
|
65
|
+
- Nav and footer link sets with counts and depth. These feed shell capacity
|
|
66
|
+
selection later.
|
|
67
|
+
- Old to new URL map, including preserved slugs, renames, drops, and any
|
|
68
|
+
redirect requirement.
|
|
69
|
+
|
|
70
|
+
If the site is a JavaScript app, inspect the rendered DOM and network results
|
|
71
|
+
rather than treating the initial HTML shell as the content. Broken or shell-like
|
|
72
|
+
discovery surfaces (`/sitemap.xml`, `/robots.txt`, source HTML) are not proof
|
|
73
|
+
that detail pages are empty; follow rendered nav, bundles, links, and hydrated
|
|
74
|
+
routes before dropping anything. If a page is gated, unreachable, or
|
|
75
|
+
intentionally excluded, record that limitation in the inventory instead of
|
|
76
|
+
inventing content.
|
|
77
|
+
|
|
78
|
+
## IA And URL Map
|
|
79
|
+
|
|
80
|
+
Before modeling content, confirm the IA map with the owner:
|
|
81
|
+
|
|
82
|
+
- `keep`: the page or entry survives, ideally at the same slug.
|
|
83
|
+
- `merge`: content moves into another page or collection entry.
|
|
84
|
+
- `drop`: content is intentionally left out.
|
|
85
|
+
- `rename`: content survives at a new URL.
|
|
86
|
+
|
|
87
|
+
The current template has no built-in redirect map. Prefer preserved slugs for
|
|
88
|
+
surviving pages. If redirects are required, implement them in
|
|
89
|
+
`site/src/middleware.ts` as a recorded Deviation in `DESIGN.md`/`dev/SPEC.md`,
|
|
90
|
+
then verify each mapped old URL. Do not imply redirect support exists until
|
|
91
|
+
the app contains it.
|
|
92
|
+
|
|
93
|
+
## Content Modeling And Conversion
|
|
94
|
+
|
|
95
|
+
Let the content-model skill own the EmDash schema and site plan. This skill
|
|
96
|
+
owns the conversion discipline:
|
|
97
|
+
|
|
98
|
+
- Page-backing collections are for repeated items with detail pages:
|
|
99
|
+
articles, books, projects, products, events, resources.
|
|
100
|
+
- Section-data collections are for reusable rails: testimonials, team, logos,
|
|
101
|
+
FAQs, featured items.
|
|
102
|
+
- One-off marketing pages become page starters and Galley section data, not a
|
|
103
|
+
verbatim translation of page-builder markup.
|
|
104
|
+
- Long-form articles and resources convert to Portable Text `content` using
|
|
105
|
+
the mapping table in the reference.
|
|
106
|
+
- Stable `_key`s are required for every Portable Text block and span.
|
|
107
|
+
|
|
108
|
+
Migrate meaning, not markup. Remove builder wrappers, spacer divs, animation
|
|
109
|
+
classes, and inline style debris. Preserve headings, paragraphs, lists,
|
|
110
|
+
quotes, links, media relationships, captions, and the editorial order that
|
|
111
|
+
matters to readers.
|
|
112
|
+
|
|
113
|
+
## Fresh App Vs Live Database
|
|
114
|
+
|
|
115
|
+
Choose the vehicle from database state:
|
|
116
|
+
|
|
117
|
+
- **Fresh app with an empty EmDash database:** author the migration in
|
|
118
|
+
`site/seed/seed.json`. Use `$media` values for already-hosted media URLs so
|
|
119
|
+
EmDash downloads the assets on first apply. This path is declarative,
|
|
120
|
+
reviewable, and re-runnable on a clean DB.
|
|
121
|
+
- **Live database with real content:** use EmDash CLI/admin operations:
|
|
122
|
+
`pnpm --dir site exec emdash content create`, `content update`,
|
|
123
|
+
`content publish`, and `media upload`. Do not rewrite already-applied seed
|
|
124
|
+
content and expect it to mutate the live database.
|
|
125
|
+
|
|
126
|
+
For CLI media uploads, authenticate with a real EmDash API token created from
|
|
127
|
+
the signed-in admin/settings flow for that app. If a local Raybase-authenticated
|
|
128
|
+
preview blocks `/_emdash/api/setup/dev-bypass`, do not present dev-bypass or a
|
|
129
|
+
hand-inserted D1 token as the normal path. For a local-only dry run, you may
|
|
130
|
+
record a temporary D1 token workaround in the migration ledger, but the owner
|
|
131
|
+
handoff must say the production path still needs a real admin-issued token or
|
|
132
|
+
admin UI upload.
|
|
133
|
+
|
|
134
|
+
For seed `$media`, first-request apply can warn and skip media that cannot be
|
|
135
|
+
downloaded, leaving the image field empty while continuing the rest of the
|
|
136
|
+
seed. Check first-request logs and fall back to downloading the asset locally
|
|
137
|
+
and uploading it with the CLI.
|
|
138
|
+
|
|
139
|
+
Astro's live content helpers also require `site/src/live.config.ts` to define
|
|
140
|
+
the `_emdash` live collection with `emdashLoader()` from `emdash/runtime`.
|
|
141
|
+
Without it, `getEmDashEntry`, `getEmDashCollection`, and search can return
|
|
142
|
+
empty results even when D1 has seeded rows.
|
|
143
|
+
|
|
144
|
+
## Media Migration
|
|
145
|
+
|
|
146
|
+
Harvest the highest-resolution media URL the public page actually serves.
|
|
147
|
+
When a CDN URL carries resizing parameters and the host permits a cleaner
|
|
148
|
+
original URL, strip the resizing query params and verify the resulting URL
|
|
149
|
+
before using it. Never guess image URLs.
|
|
150
|
+
|
|
151
|
+
Destination rule:
|
|
152
|
+
|
|
153
|
+
- EmDash collection `image` fields get media objects, usually via seed
|
|
154
|
+
`$media` for fresh apps or CLI-uploaded media for live databases.
|
|
155
|
+
- Galley `data-dynamic-src` fields get URL strings. For CLI-uploaded media,
|
|
156
|
+
use the site-origin-qualified `/_emdash/api/media/file/{storageKey}` URL.
|
|
157
|
+
- Alt text is authored in the site's voice. Do not derive alt text from
|
|
158
|
+
filenames.
|
|
159
|
+
|
|
160
|
+
When verifying a built Cloudflare/Wrangler preview locally, distinguish D1 media
|
|
161
|
+
metadata from R2 file bytes. Seed `$media` downloads files to the CLI
|
|
162
|
+
`--uploads-dir`; the Worker serves `/_emdash/api/media/file/{storageKey}` from
|
|
163
|
+
the configured R2 binding. Verify the rendered media URLs return 200. If they
|
|
164
|
+
404 in local preview while media rows exist, hydrate local R2 from the upload
|
|
165
|
+
directory or upload the assets through the API before declaring parity.
|
|
166
|
+
|
|
167
|
+
In pinned EmDash 0.23, direct CLI media upload can accept `--alt`/`--caption`
|
|
168
|
+
without persisting them to the media row. Treat the upload result as the source
|
|
169
|
+
of truth and set final alt text on the consuming collection entry or Galley
|
|
170
|
+
field until the upload endpoint persists those fields.
|
|
171
|
+
|
|
172
|
+
Image licensing is the owner's responsibility. Do not audit rights or identify
|
|
173
|
+
stock provenance as a migration task. The handoff message must include one
|
|
174
|
+
sentence: imagery from the old site was republished as-is; confirm you hold the
|
|
175
|
+
rights before publish.
|
|
176
|
+
|
|
177
|
+
## Redesign Through Existing Skills
|
|
178
|
+
|
|
179
|
+
After the inventory and owner-approved IA map exist:
|
|
180
|
+
|
|
181
|
+
1. Run the content-model skill to turn the inventory into the `## Site plan`,
|
|
182
|
+
EmDash collections, bindings, and seed/live content path.
|
|
183
|
+
2. Run the design skill. Record the old site as a reference or anti-reference
|
|
184
|
+
in `DESIGN.md` using the direction fields defined by the design skill; do
|
|
185
|
+
not let the old builder dictate the new theme.
|
|
186
|
+
3. Run theme selection and Galley adaptation using the migration-derived page
|
|
187
|
+
inventory, link counts, collection counts, and media inventory.
|
|
188
|
+
4. Keep old-site content parity separate from design polish. Design may
|
|
189
|
+
improve presentation; it must not make migrated content disappear.
|
|
190
|
+
|
|
191
|
+
## Verification
|
|
192
|
+
|
|
193
|
+
In addition to the hub Browser Verification recipe:
|
|
194
|
+
|
|
195
|
+
- Every kept page in `dev/migration/inventory.md` resolves at its intended new
|
|
196
|
+
URL and renders migrated content.
|
|
197
|
+
- Per-collection counts match the inventory, or every intentional difference
|
|
198
|
+
is recorded.
|
|
199
|
+
- First-request logs have no unresolved `$media` failures.
|
|
200
|
+
- Every rendered `/_emdash/api/media/file/{storageKey}` URL for migrated media
|
|
201
|
+
returns 200 in the verification environment.
|
|
202
|
+
- No stock stand-in appears where the old site had usable real media, unless
|
|
203
|
+
the owner explicitly chose the replacement.
|
|
204
|
+
- The old to new URL map is honored. Preserved old slugs resolve; implemented
|
|
205
|
+
redirects return the intended destination.
|
|
206
|
+
- Site search, when enabled for migrated collections, returns migrated entries.
|
|
207
|
+
- **The migrated site stays runtime-editable.** Every kept page passes the hub
|
|
208
|
+
skill's editability gate (Edit mode lights up designed blocks, Portable
|
|
209
|
+
Text, or context markers). Content parity achieved through hard-coded
|
|
210
|
+
markup is a failed migration: operators must be able to change the content
|
|
211
|
+
through EmDash without code changes, as the spec promises.
|
|
212
|
+
|
|
213
|
+
## Handoff
|
|
214
|
+
|
|
215
|
+
The handoff should name the inventory file, summarize kept/merged/dropped
|
|
216
|
+
content, call out redirect limitations or middleware deviations, and include
|
|
217
|
+
the image-rights sentence above. Do not ask the owner to verify basic parity
|
|
218
|
+
instead of doing the browser check yourself.
|