@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,265 @@
|
|
|
1
|
+
# EmDash Collections Reference (vendored)
|
|
2
|
+
|
|
3
|
+
Trimmed from EmDash's own site-building skill for use inside Raybase Sites.
|
|
4
|
+
Verified against EmDash 0.23 (the version pinned in
|
|
5
|
+
`site/package.json`). When the pinned EmDash version moves, re-check this
|
|
6
|
+
file against the EmDash docs (`https://docs.emdashcms.com`) before trusting
|
|
7
|
+
details here over observed behaviour.
|
|
8
|
+
|
|
9
|
+
In an astro-emdash app the EmDash site lives in `site/`; run every `emdash`
|
|
10
|
+
CLI command from there, for example `pnpm --dir site exec emdash schema list`.
|
|
11
|
+
Some localhost dev flows can use the EmDash dev bypass, but Raybase-auth
|
|
12
|
+
scaffolds or built Wrangler previews may require an authenticated CLI token.
|
|
13
|
+
|
|
14
|
+
## Seed File Structure
|
|
15
|
+
|
|
16
|
+
`site/seed/seed.json` defines schema plus optional starter content:
|
|
17
|
+
|
|
18
|
+
```json
|
|
19
|
+
{
|
|
20
|
+
"$schema": "https://emdashcms.com/seed.schema.json",
|
|
21
|
+
"version": "1",
|
|
22
|
+
"meta": { "name": "...", "description": "...", "author": "..." },
|
|
23
|
+
"settings": { "title": "...", "tagline": "..." },
|
|
24
|
+
"collections": [ ... ],
|
|
25
|
+
"taxonomies": [ ... ],
|
|
26
|
+
"menus": [ ... ],
|
|
27
|
+
"content": { ... }
|
|
28
|
+
}
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
It is applied automatically on the first request when the content database is
|
|
32
|
+
empty; existing data is never overwritten. Validation runs at apply time - an
|
|
33
|
+
invalid seed fails the first request and logs the error; fix and restart the
|
|
34
|
+
dev server.
|
|
35
|
+
|
|
36
|
+
## Collections
|
|
37
|
+
|
|
38
|
+
```json
|
|
39
|
+
{
|
|
40
|
+
"slug": "articles",
|
|
41
|
+
"label": "Articles",
|
|
42
|
+
"labelSingular": "Article",
|
|
43
|
+
"urlPattern": "/articles/{slug}",
|
|
44
|
+
"supports": ["drafts", "revisions", "search", "seo"],
|
|
45
|
+
"fields": [ ... ]
|
|
46
|
+
}
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
- Slugs are lowercase alphanumeric plus underscores (`/^[a-z][a-z0-9_]*$/`),
|
|
50
|
+
max 63 characters.
|
|
51
|
+
- `supports`: `drafts` (draft/published workflow), `revisions` (history),
|
|
52
|
+
`search` (full-text indexing), `seo` (meta fields in admin).
|
|
53
|
+
- `urlPattern` gives entries public URLs. In this starter the public catch-all
|
|
54
|
+
resolves matching paths and renders `title` / `description` / `content` /
|
|
55
|
+
`design`; omit `urlPattern` for collections that only feed section
|
|
56
|
+
`dataSources`.
|
|
57
|
+
|
|
58
|
+
## Field Types
|
|
59
|
+
|
|
60
|
+
| Type | Runtime shape | Notes |
|
|
61
|
+
| -------------- | ------------------------------------- | ---------------------------- |
|
|
62
|
+
| `string` | `string` | Single line |
|
|
63
|
+
| `text` | `string` | Multi-line |
|
|
64
|
+
| `number` | `number` | Floating point |
|
|
65
|
+
| `integer` | `number` | Whole numbers |
|
|
66
|
+
| `boolean` | `boolean` | |
|
|
67
|
+
| `datetime` | `Date` | ISO 8601 in DB |
|
|
68
|
+
| `image` | `{ id, src?, alt?, width?, height? }` | An object, never a string |
|
|
69
|
+
| `reference` | `string` (entry ULID) | Points at another entry |
|
|
70
|
+
| `portableText` | `PortableTextBlock[]` | Rich text as structured JSON |
|
|
71
|
+
| `json` | `any` | Arbitrary JSON |
|
|
72
|
+
|
|
73
|
+
The CLI additionally accepts `select`, `multiSelect`, `file`, `slug`, and
|
|
74
|
+
`url` field types.
|
|
75
|
+
|
|
76
|
+
Field definition:
|
|
77
|
+
|
|
78
|
+
```json
|
|
79
|
+
{ "slug": "title", "label": "Title", "type": "string", "required": true, "searchable": true }
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
Example page-backing collection field set (matches the shape the public
|
|
83
|
+
route renders):
|
|
84
|
+
|
|
85
|
+
```json
|
|
86
|
+
"fields": [
|
|
87
|
+
{ "slug": "title", "label": "Title", "type": "string", "required": true, "searchable": true },
|
|
88
|
+
{ "slug": "description", "label": "Description", "type": "text", "searchable": true },
|
|
89
|
+
{ "slug": "content", "label": "Content", "type": "portableText", "searchable": true },
|
|
90
|
+
{ "slug": "design", "label": "Design", "type": "json", "widget": "galley:block" }
|
|
91
|
+
]
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Example section-data collection (no `urlPattern`, no `content`):
|
|
95
|
+
|
|
96
|
+
```json
|
|
97
|
+
"fields": [
|
|
98
|
+
{ "slug": "quote", "label": "Quote", "type": "text", "required": true },
|
|
99
|
+
{ "slug": "attribution", "label": "Attribution", "type": "string" },
|
|
100
|
+
{ "slug": "portrait", "label": "Portrait", "type": "image" }
|
|
101
|
+
]
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
## Taxonomies And Menus
|
|
105
|
+
|
|
106
|
+
```json
|
|
107
|
+
{
|
|
108
|
+
"name": "category",
|
|
109
|
+
"label": "Categories",
|
|
110
|
+
"labelSingular": "Category",
|
|
111
|
+
"hierarchical": true,
|
|
112
|
+
"collections": ["articles"],
|
|
113
|
+
"terms": [{ "slug": "guides", "label": "Guides" }]
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
Query names must match the seed's `name` exactly (`"category"`, not
|
|
118
|
+
`"categories"`); a wrong name returns empty results with no error.
|
|
119
|
+
|
|
120
|
+
```json
|
|
121
|
+
{
|
|
122
|
+
"name": "primary",
|
|
123
|
+
"label": "Primary Navigation",
|
|
124
|
+
"items": [{ "type": "custom", "label": "Home", "url": "/" }]
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
## Seed Content
|
|
129
|
+
|
|
130
|
+
Sample rows are organized by collection slug under `content`:
|
|
131
|
+
|
|
132
|
+
```json
|
|
133
|
+
"content": {
|
|
134
|
+
"articles": [
|
|
135
|
+
{
|
|
136
|
+
"id": "article-1",
|
|
137
|
+
"slug": "hello-world",
|
|
138
|
+
"status": "published",
|
|
139
|
+
"data": {
|
|
140
|
+
"title": "Hello World",
|
|
141
|
+
"content": [
|
|
142
|
+
{
|
|
143
|
+
"_type": "block",
|
|
144
|
+
"_key": "a1-intro",
|
|
145
|
+
"style": "normal",
|
|
146
|
+
"markDefs": [],
|
|
147
|
+
"children": [
|
|
148
|
+
{ "_type": "span", "_key": "a1-intro-text", "text": "Body text.", "marks": [] }
|
|
149
|
+
]
|
|
150
|
+
}
|
|
151
|
+
]
|
|
152
|
+
},
|
|
153
|
+
"taxonomies": { "category": ["guides"] }
|
|
154
|
+
}
|
|
155
|
+
]
|
|
156
|
+
}
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
- Give every Portable Text block and span a stable `_key` (Raybase rule:
|
|
160
|
+
Galley edit context depends on stable keys; upstream EmDash examples omit
|
|
161
|
+
them, this starter must not).
|
|
162
|
+
- Image fields use `$media` so EmDash downloads and stores the file:
|
|
163
|
+
`"featured_image": { "$media": { "url": "https://...", "alt": "...", "filename": "x.jpg" } }`.
|
|
164
|
+
- Reference fields use `"$ref:<seed-id>"`.
|
|
165
|
+
- `"status": "draft"` seeds unpublished content.
|
|
166
|
+
- Block styles: `normal`, `h1`-`h6`, `blockquote`; inline marks via
|
|
167
|
+
`"marks": ["strong"]` etc.
|
|
168
|
+
|
|
169
|
+
## Ingesting Owner Assets
|
|
170
|
+
|
|
171
|
+
Use this section for greenfield owner asset intake and for migrated site
|
|
172
|
+
imagery. First get the bytes onto local disk however the host provides them:
|
|
173
|
+
chat attachments, a folder the owner names, or URLs you download. Normalize
|
|
174
|
+
before upload: descriptive kebab-case filenames, oversized originals
|
|
175
|
+
downscaled locally, and raster heroes kept to roughly 300KB where practical.
|
|
176
|
+
Nothing in this starter resizes images for you; EmDash's default direct-upload
|
|
177
|
+
limit is 50MB, but review performance should be much stricter than that.
|
|
178
|
+
|
|
179
|
+
For a fresh app whose content database is still empty, prefer seed `$media`
|
|
180
|
+
when the asset is already hosted:
|
|
181
|
+
|
|
182
|
+
```json
|
|
183
|
+
"featured_image": {
|
|
184
|
+
"$media": {
|
|
185
|
+
"url": "https://example.com/photo.jpg",
|
|
186
|
+
"alt": "Chef Mina plating saffron risotto at the pass",
|
|
187
|
+
"filename": "chef-mina-risotto.jpg"
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
EmDash downloads those URLs on first seed apply. If a source URL is blocked,
|
|
193
|
+
private, oversized, or otherwise unreachable, the seed apply continues with a
|
|
194
|
+
warning, the affected media value is skipped, and the image field becomes
|
|
195
|
+
`null`; check the first-request logs. The fallback is to download the file
|
|
196
|
+
locally and upload it with the CLI after the first seed apply.
|
|
197
|
+
|
|
198
|
+
For built Cloudflare/Wrangler local previews, `$media` seed apply may populate
|
|
199
|
+
the media table and download files into `--uploads-dir` without putting those
|
|
200
|
+
bytes into Miniflare's R2 bucket. Verify each
|
|
201
|
+
`/_emdash/api/media/file/{storageKey}` URL. If rows exist but URLs 404, hydrate
|
|
202
|
+
the local R2 state from the upload directory or upload the files through the
|
|
203
|
+
API before signing off on media parity.
|
|
204
|
+
|
|
205
|
+
For local files after the seed has applied, or for any live database, upload
|
|
206
|
+
each asset through the EmDash CLI:
|
|
207
|
+
|
|
208
|
+
```bash
|
|
209
|
+
pnpm --dir site exec emdash media upload ./chef-mina-risotto.jpg --alt "Chef Mina plating saffron risotto at the pass" --json
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
Capture the returned media item. In EmDash 0.23 the response includes an
|
|
213
|
+
`id` and a relative `url` like `/_emdash/api/media/file/{storageKey}`. For
|
|
214
|
+
Galley `data-dynamic-src` fields, paste the site-origin-qualified URL
|
|
215
|
+
(`https://site.example/_emdash/api/media/file/{storageKey}` in production, or
|
|
216
|
+
the local dev origin during review). For collection `image` fields, use the
|
|
217
|
+
media object shape the field expects: `{ id, src?, alt?, width?, height? }`.
|
|
218
|
+
|
|
219
|
+
Destination rule: collection `image` fields get media objects; Galley section
|
|
220
|
+
fields get URL strings in `data-dynamic-src` plus authored alt text in
|
|
221
|
+
`data-dynamic-alt`. Alt text is copy, not metadata cleanup: write it in the
|
|
222
|
+
site's voice and never derive it from the filename. Seed `$media` preserves
|
|
223
|
+
`alt`, but in pinned EmDash 0.23 the direct-upload route behind the CLI does
|
|
224
|
+
not persist `--alt`/`--caption` to the media row; after CLI upload, set the
|
|
225
|
+
final alt text on the collection entry or Galley `data-dynamic-alt` field and
|
|
226
|
+
verify it before handoff.
|
|
227
|
+
|
|
228
|
+
## Live Database Operations (CLI)
|
|
229
|
+
|
|
230
|
+
Once the local content database has real data, change schema and content
|
|
231
|
+
through the CLI or `/_emdash/admin`, not by re-editing the applied seed.
|
|
232
|
+
Create and update auto-publish by default; pass `--draft` to stage instead.
|
|
233
|
+
|
|
234
|
+
```bash
|
|
235
|
+
# Schema
|
|
236
|
+
pnpm --dir site exec emdash schema list
|
|
237
|
+
pnpm --dir site exec emdash schema get articles
|
|
238
|
+
pnpm --dir site exec emdash schema create articles --label Articles
|
|
239
|
+
pnpm --dir site exec emdash schema add-field articles summary --type text --label "Summary"
|
|
240
|
+
|
|
241
|
+
# Content (update requires --rev from a prior get)
|
|
242
|
+
pnpm --dir site exec emdash content list articles --json
|
|
243
|
+
pnpm --dir site exec emdash content get articles <ulid>
|
|
244
|
+
pnpm --dir site exec emdash content create articles --data '{"title": "Hello"}'
|
|
245
|
+
pnpm --dir site exec emdash content update articles <ulid> --rev <rev> --data '{"title": "Updated"}'
|
|
246
|
+
pnpm --dir site exec emdash content publish articles <ulid>
|
|
247
|
+
|
|
248
|
+
# Taxonomies / media / types
|
|
249
|
+
pnpm --dir site exec emdash taxonomy add-term category --name "Guides" --slug guides
|
|
250
|
+
pnpm --dir site exec emdash media upload ./photo.jpg --alt "A sunset"
|
|
251
|
+
pnpm --dir site exec emdash types
|
|
252
|
+
|
|
253
|
+
# Round-trip a grown database back into a seed
|
|
254
|
+
pnpm --dir site exec emdash export-seed --with-content
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
## Gotchas
|
|
258
|
+
|
|
259
|
+
- `entry.id` is the slug (use in URLs); `entry.data.id` is the database ULID
|
|
260
|
+
(use for API calls and reference fields). Mixing them up returns silently
|
|
261
|
+
empty results.
|
|
262
|
+
- Image fields render `[object Object]` if treated as strings; use the
|
|
263
|
+
`Image` component from `emdash/ui` in any bespoke Astro code.
|
|
264
|
+
- All CMS pages are server-rendered; never add `getStaticPaths` for EmDash
|
|
265
|
+
content.
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
Substantial portions of this skill are adapted from Impeccable Design
|
|
2
|
+
(https://impeccable.style/), used under the Apache License, Version 2.0,
|
|
3
|
+
whose text follows. The adapted passages were rewritten for Raybase apps;
|
|
4
|
+
the files that carry them say so where they begin or end.
|
|
5
|
+
|
|
6
|
+
Apache License
|
|
7
|
+
|
|
8
|
+
Version 2.0, January 2004
|
|
9
|
+
|
|
10
|
+
http://www.apache.org/licenses/
|
|
11
|
+
|
|
12
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
13
|
+
|
|
14
|
+
1. Definitions.
|
|
15
|
+
|
|
16
|
+
"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
|
|
17
|
+
|
|
18
|
+
"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
|
|
19
|
+
|
|
20
|
+
"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
|
|
21
|
+
|
|
22
|
+
"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
|
|
23
|
+
|
|
24
|
+
"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
|
|
25
|
+
|
|
26
|
+
"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
|
|
27
|
+
|
|
28
|
+
"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
|
|
29
|
+
|
|
30
|
+
"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
|
|
31
|
+
|
|
32
|
+
"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
|
|
33
|
+
|
|
34
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
|
|
35
|
+
|
|
36
|
+
2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
|
|
37
|
+
|
|
38
|
+
3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
|
|
39
|
+
|
|
40
|
+
4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
|
|
41
|
+
|
|
42
|
+
You must give any other recipients of the Work or Derivative Works a copy of this License; and
|
|
43
|
+
|
|
44
|
+
You must cause any modified files to carry prominent notices stating that You changed the files; and
|
|
45
|
+
|
|
46
|
+
You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
|
|
47
|
+
|
|
48
|
+
If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
|
|
49
|
+
|
|
50
|
+
5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
|
|
51
|
+
|
|
52
|
+
6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
|
|
53
|
+
|
|
54
|
+
7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
|
|
55
|
+
|
|
56
|
+
8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
|
|
57
|
+
|
|
58
|
+
9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
|
|
59
|
+
|
|
60
|
+
END OF TERMS AND CONDITIONS
|
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: raybase-astro-emdash-design
|
|
3
|
+
description: Design astro-emdash public sites to a distinctive, production bar - derive a design direction from the spec, select and work within a registry theme on the shadcn-semantic-v1 token contract, and craft site typography, color, layout, imagery, motion, and copy. Records durable decisions in DESIGN.md. Read before theme selection and before any durable visual or UX change.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Raybase Astro/EmDash Design Skill
|
|
7
|
+
|
|
8
|
+
The public site of an `astro-emdash` app is a **brand surface: design IS the
|
|
9
|
+
product**. A visitor's impression is the deliverable. The bar is
|
|
10
|
+
distinctiveness — a visitor should ask "how was this made?", not "which AI
|
|
11
|
+
made this?". AI-generated sites have flooded the internet; restraint without
|
|
12
|
+
intent now reads as mediocre, not refined. The site needs a point of view, a
|
|
13
|
+
specific audience, and a willingness to commit.
|
|
14
|
+
|
|
15
|
+
The Raybase spine is the opposite register: an operator tool that keeps the
|
|
16
|
+
starter's baseline design system (the spine sections of `DESIGN.md`). This
|
|
17
|
+
skill is about the public site; the spine rules at the end keep the lanes
|
|
18
|
+
separate.
|
|
19
|
+
|
|
20
|
+
## Read Order
|
|
21
|
+
|
|
22
|
+
1. Read `.agents/skills/raybase-astro-emdash/SKILL.md`.
|
|
23
|
+
2. Read `dev/SPEC.md` (especially the interview's tone and audience answers) and the `Site plan` section produced by `.agents/skills/raybase-astro-emdash-content-model/SKILL.md`.
|
|
24
|
+
3. Read `DESIGN.md`; its Public Site section is the durable design memory this skill writes and later work consumes.
|
|
25
|
+
4. Read `.agents/skills/raybase-astro-emdash-galley/SKILL.md` before implementing section-level changes.
|
|
26
|
+
5. Read the matching [reference file](#reference-files) before working in its area.
|
|
27
|
+
|
|
28
|
+
## The Flow
|
|
29
|
+
|
|
30
|
+
1. **Derive a design direction** from the approved spec ([reference/direction.md](reference/direction.md)) — before searching for a theme. Theme selection consumes a direction; it must not invent one from the first search results.
|
|
31
|
+
2. **Record it in `DESIGN.md`** before running the theme-selection loop.
|
|
32
|
+
3. **Select a theme, then a shell** with `.agents/skills/raybase-astro-emdash-theme-selection/SKILL.md`. The theme (voice + vocabulary) and the shell (the IA's frame — nav/footer/layout, chosen by capacity from the site plan's link sets) are separate artifacts; it records both, plus palette and rationale, in the same `DESIGN.md` section.
|
|
33
|
+
4. **Adapt within the theme**: replace sample copy and imagery with the site's own voice and assets, tune section composition, and make deliberate deviations — recorded with their why.
|
|
34
|
+
5. **Look at it like a designer.** Browser-verify at mobile and desktop widths (the hub skill's Browser Verification recipe). Critique against the direction and the bans below, patch material defects, re-inspect. Don't invent defects to demonstrate iteration; a confident "first pass clean" beats a fake fix.
|
|
35
|
+
|
|
36
|
+
## DESIGN.md Is The Design Memory
|
|
37
|
+
|
|
38
|
+
`DESIGN.md` is not documentation ceremony — it is the design system's memory.
|
|
39
|
+
Sessions end and context windows close; the file is what lets the next agent
|
|
40
|
+
(or a runtime agent editing the live site) make on-brand decisions without
|
|
41
|
+
re-deriving them. Keep the Public Site section short and current:
|
|
42
|
+
|
|
43
|
+
- The design direction and its rationale (fields in [reference/direction.md](reference/direction.md)).
|
|
44
|
+
- The selected theme, palette, and tone rationale (written at theme selection).
|
|
45
|
+
- The selected shell (layout id) and its capacity rationale (nav item count, footer grade, IA fit) — written at shell selection.
|
|
46
|
+
- Deliberate deviations from the theme baseline (bespoke sections, palette edits, font swaps, shell nav/footer swaps) and why.
|
|
47
|
+
- The site's 1–2 signature moves, so later edits protect them instead of sanding them off.
|
|
48
|
+
|
|
49
|
+
Update it when a decision changes; never scatter design decisions across
|
|
50
|
+
commit messages or chat instead of this file.
|
|
51
|
+
|
|
52
|
+
## Work Within The Chosen Theme
|
|
53
|
+
|
|
54
|
+
Once a theme is activated it is the site's design system, not a starting
|
|
55
|
+
suggestion:
|
|
56
|
+
|
|
57
|
+
- The theme constrains the layout shell, nav, footer, section families, and palette. Prefer the theme family's own sections and page starters; add a bespoke section only when the family lacks a needed band (galley skill rules apply).
|
|
58
|
+
- Change the site's look by switching the palette or re-running theme selection, not by scattering CSS overrides across templates.
|
|
59
|
+
- Registry themes expose their installable palettes as `palettes`; `raybase templates info` shows each palette's kind, fonts, and provenance. What `--palette` accepts is the theme's registry list.
|
|
60
|
+
- Ambition still has room: direction-led copy and imagery, section composition and rhythm, a new registry palette or validated Galley `paletteCss` overlay authored to the token contract, and motion presets are all in-theme levers. Use them before considering bespoke CSS.
|
|
61
|
+
|
|
62
|
+
## Token Contract: shadcn-semantic-v1
|
|
63
|
+
|
|
64
|
+
Registry templates declare `catalog.tokenContract: "shadcn-semantic-v1"`:
|
|
65
|
+
they style only against the shadcn semantic CSS variables, so one palette
|
|
66
|
+
swap restyles every section.
|
|
67
|
+
|
|
68
|
+
- Installed palettes live in `site/src/styles/palettes.gen.css` as `[data-palette="..."]` and `[data-palette="..."].dark` blocks defining `--background`, `--foreground`, `--card`, `--muted`, `--primary`, `--accent`, `--border`, and their companions, plus font (`--app-font-sans/serif/mono/display`) and radius variables. `SiteLayout.astro` applies the active palette as `data-palette` on the site `<html>` from the app database and appends any validated Galley `paletteCss` overlay.
|
|
69
|
+
- Stay on token rails in Galley Liquid and Astro site components: semantic classes and variables only. A hardcoded hex, font family, or radius in section markup breaks every palette except the one it was written against.
|
|
70
|
+
- A new color strategy materializes as a new palette artifact or app-local overlay defining the same semantic variables ([reference/color.md](reference/color.md)); a new typeface materializes through palette font metadata and font variables ([reference/typography.md](reference/typography.md)). Bespoke sections must honor the same contract.
|
|
71
|
+
|
|
72
|
+
## Hard Rules
|
|
73
|
+
|
|
74
|
+
The floor for every page. The references go deeper.
|
|
75
|
+
|
|
76
|
+
- Body text ≥ 4.5:1 contrast against its background; large text (≥18px, or bold ≥14px) ≥ 3:1. The most common failure is muted gray body text on a tinted near-white — when in doubt, darken the text. Never gray text on a colored background; use a darker shade of the background's own hue or a transparency of the text color.
|
|
77
|
+
- Text over photography always sits on a scrim (gradient overlay such as `bg-gradient-to-t from-card via-card/75 to-card/25`, or a solid panel) — never on the raw image; the content author controls the photo, so legibility cannot depend on it staying dark or quiet. Verify on the rendered page, not the template source: if the scrim's palette-token utilities fail to compile (see `raybase templates doctor`'s token-contract check), the text ships illegible while the markup looks correct.
|
|
78
|
+
- Body line length 65–75ch; body ≥ 16px, fixed (fluid `clamp()` is for headings). Hero heading ceiling: clamp max ≤ 6rem. Display letter-spacing floor: ≥ −0.04em. `text-wrap: balance` on h1–h3, `pretty` on long prose.
|
|
79
|
+
- Vary spacing for rhythm: tight within groups, generous between sections. Cards are the lazy answer; nested cards are always wrong. Flexbox for 1D, Grid for 2D; semantic z-index scale, never 999.
|
|
80
|
+
- One-page sites compress the whole narrative into one scroll, so pacing discipline doubles: sequence bands as an arc (arrive → establish → show the work → answer objections → convert), repeat the CTA at the arc's turns rather than after every band, and give anchored bands sticky-nav clearance (`scroll-mt-*` sized to the shell header). Ten equal-weight bands is a brochure, not an argument.
|
|
81
|
+
- When the brief implies imagery (restaurant, hotel, travel, food, product, portfolio), ship imagery. Zero images is a bug, not restraint ([reference/imagery.md](reference/imagery.md)).
|
|
82
|
+
- Motion is intentional and part of the build. Use the starter's `data-rb-motion` presets; reduced motion is not optional ([reference/motion.md](reference/motion.md)). Never gate content visibility on a scroll-triggered class — a reveal that doesn't fire ships a blank section.
|
|
83
|
+
- Test heading copy at every breakpoint; text that overflows its container is a defect. The viewport is part of the design.
|
|
84
|
+
- Real content at handoff: no placeholder copy, broken image URLs, dead links, or leftover registry sample text. And real means true — never invent stats, testimonials, or credentials the owner didn't supply ([reference/copy.md](reference/copy.md)).
|
|
85
|
+
|
|
86
|
+
## Absolute Bans
|
|
87
|
+
|
|
88
|
+
Match-and-refuse. About to write one of these? Rewrite the element with
|
|
89
|
+
different structure:
|
|
90
|
+
|
|
91
|
+
- **Side-stripe borders** — `border-left/right` > 1px as a colored accent. Full hairline border, background tint, or nothing.
|
|
92
|
+
- **Gradient text** (`background-clip: text`). Solid color; emphasis via weight or size.
|
|
93
|
+
- **Glassmorphism as default.** Rare and purposeful, or nothing.
|
|
94
|
+
- **The ghost card** — 1px border + wide soft shadow (blur ≥ 16px) on the same element. Pick one.
|
|
95
|
+
- **Over-rounding** — cards top out at 12–16px radius; full-pill is for tags and buttons.
|
|
96
|
+
- **The hero-metric template** — big number, small label, gradient accent — unless it shows real data.
|
|
97
|
+
- **Identical card grids** — same-sized icon + heading + text cards, repeated endlessly.
|
|
98
|
+
- **Tiny uppercase tracked eyebrows or numbered markers (01 · 02 · 03) above every section.** One named kicker can be brand voice; section-grammar repetition is AI scaffolding. Numbers only when the content really is a sequence.
|
|
99
|
+
- **Purple-blue gradients**, `repeating-linear-gradient` stripe backgrounds, and decorative 1px grid-line backgrounds (unless the surface is literally a canvas, map, or blueprint).
|
|
100
|
+
- **Hand-drawn / sketchy SVG illustrations** as fallback art. If you can't render the scene with real assets, ship no illustration.
|
|
101
|
+
- **The cream/sand/beige default body.** The warm near-white band (OKLCH L 0.84–0.97, C < 0.06, hue 40–100) is the saturated AI default; "warm" briefs are carried by accent, typography, and imagery, not a parchment background.
|
|
102
|
+
- **Monospace as costume** for "technical", **editorial-magazine styling by default** (display serif + italic + drop caps on briefs that aren't magazine-shaped), **all-caps body copy**.
|
|
103
|
+
|
|
104
|
+
## The Slop Test
|
|
105
|
+
|
|
106
|
+
If someone could look at the site and say "AI made that" without doubt, it
|
|
107
|
+
has failed. Two altitudes:
|
|
108
|
+
|
|
109
|
+
- **First-order**: if the theme + palette are guessable from the category alone ("Italian restaurant → cream and terracotta", "fintech → navy"), it's the first training-data reflex. Rework the direction until the answer isn't obvious from the domain.
|
|
110
|
+
- **Second-order**: if the aesthetic family is guessable from category-plus-anti-reference ("dev tool that's not SaaS-cream → editorial serif + mono labels"), it's the trap one tier deeper. Rework until both answers are non-obvious.
|
|
111
|
+
|
|
112
|
+
## Brand Permissions
|
|
113
|
+
|
|
114
|
+
Things a content site can afford that app UI can't — use them when the
|
|
115
|
+
direction invites them:
|
|
116
|
+
|
|
117
|
+
- **Ambitious entrance motion.** One well-orchestrated page load or hero reveal beats scattered micro-interactions. Some brands skip entrance motion entirely; that restraint is also a voice.
|
|
118
|
+
- **Single-purpose viewports.** One dominant idea per fold, long scroll, deliberate pacing.
|
|
119
|
+
- **Committed color.** A saturated color carrying most of a surface is voice, not excess, when the chosen strategy calls for it.
|
|
120
|
+
- **Art direction per section** when the narrative demands it. Consistency of voice beats consistency of treatment.
|
|
121
|
+
|
|
122
|
+
## Public Site Lanes
|
|
123
|
+
|
|
124
|
+
- Design the public site as a content experience, not as a Raybase admin screen.
|
|
125
|
+
- Put public route/layout shell styling in `site/src/styles.css`. Ordinary public page sections are Galley templates, not new Astro block components (galley skill rules).
|
|
126
|
+
- Keep `site/src/components/blocks/RaybaseActionIsland.astro` focused on the Raybase Server Island exception. Island controls show their remote state and errors without exposing internal tokens or URLs; any public action control calls a named, allow-listed action only.
|
|
127
|
+
- Public pages should render useful fallback content before EmDash setup, but edited content comes from EmDash.
|
|
128
|
+
- Content-editor handoff is a clear command that mints a short-lived token and opens the EmDash admin.
|
|
129
|
+
|
|
130
|
+
## Raybase Spine
|
|
131
|
+
|
|
132
|
+
- The spine UI is an operator surface: quiet, dense enough to scan, focused on handoff, status, docs, and operational controls. It keeps the starter's baseline design system (the spine sections of `DESIGN.md`); the selected site theme styles the public site only.
|
|
133
|
+
- The spine auth door is part of the design pass. Its copy starts in the app-owned `src/auth-door.ts`, and its look lives in `src/components/auth-shell.tsx`; edit or replace that shell freely while Raybase config continues to own auth routes and behavior.
|
|
134
|
+
- Do not put public marketing pages in the Raybase route graph, and do not let the site's brand voice leak into spine chrome.
|
|
135
|
+
- Do not add app-owned persona switchers or custom auth behavior; local persona switching on the public site is the generated `/_raybase/dev/session` content-door route (hub skill).
|
|
136
|
+
|
|
137
|
+
## Verification
|
|
138
|
+
|
|
139
|
+
Drive the hub skill's Browser Verification recipe yourself before handoff.
|
|
140
|
+
Design-specific checks at mobile and desktop widths:
|
|
141
|
+
|
|
142
|
+
- Header links do not overlap; hero and section text stays inside its container at 320px, 768px, and desktop.
|
|
143
|
+
- Every page in the site plan renders real content — no sample copy, no
|
|
144
|
+
broken images, no empty data rails, and every asset-inventory slot renders
|
|
145
|
+
either an owner asset or a named stock stand-in.
|
|
146
|
+
- Fonts load without layout shift; images have stable dimensions; Server Island output wraps long JSON.
|
|
147
|
+
- The [reference/polish.md](reference/polish.md) checklist passes.
|
|
148
|
+
|
|
149
|
+
## Reference Files
|
|
150
|
+
|
|
151
|
+
Read the relevant file before working in its area — they hold the depth this
|
|
152
|
+
file deliberately omits:
|
|
153
|
+
|
|
154
|
+
| File | Read when |
|
|
155
|
+
|---|---|
|
|
156
|
+
| [reference/direction.md](reference/direction.md) | deriving or revising the design direction; writing the DESIGN.md record |
|
|
157
|
+
| [reference/typography.md](reference/typography.md) | choosing or swapping fonts, building heading scales, fixing hierarchy or readability |
|
|
158
|
+
| [reference/color.md](reference/color.md) | picking a color strategy, authoring a `[data-palette]` palette, contrast questions |
|
|
159
|
+
| [reference/layout.md](reference/layout.md) | page rhythm, section composition, hierarchy, responsive behavior |
|
|
160
|
+
| [reference/imagery.md](reference/imagery.md) | sourcing, placing, or optimizing photos, illustrations, and media |
|
|
161
|
+
| [reference/motion.md](reference/motion.md) | adding any animation — presets, timing, easing, reduced motion |
|
|
162
|
+
| [reference/copy.md](reference/copy.md) | replacing sample copy, writing headlines, CTAs, microcopy, alt text |
|
|
163
|
+
| [reference/polish.md](reference/polish.md) | the final pass before handoff — hardening, states, performance, the checklist |
|
|
164
|
+
|
|
165
|
+
## Credits
|
|
166
|
+
|
|
167
|
+
Substantial portions of this skill are adapted from
|
|
168
|
+
[Impeccable Design](https://impeccable.style/), used under the Apache License
|
|
169
|
+
2.0. If you want the full system — live browser iteration, critique scoring,
|
|
170
|
+
detector rules, slash commands — use Impeccable directly.
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
# Color
|
|
2
|
+
|
|
3
|
+
On a brand surface, palette IS voice. A calm brand and a restless brand
|
|
4
|
+
should not share palette mechanics, and a beige-and-muted-slate page ignores
|
|
5
|
+
the register. The color strategy comes from the direction
|
|
6
|
+
([direction.md](direction.md)); this file is how to execute it on the
|
|
7
|
+
starter's token rails.
|
|
8
|
+
|
|
9
|
+
## How color works in this starter
|
|
10
|
+
|
|
11
|
+
- The site's installed palettes live in `site/src/styles/palettes.gen.css` as `[data-palette="..."]` and `[data-palette="..."].dark` blocks defining the shadcn semantic variables: `--background`, `--foreground`, `--card`, `--muted`, `--muted-foreground`, `--primary`, `--secondary`, `--accent`, `--border`, `--input`, `--ring`, and companions, plus `--radius` and the font variables. `SiteLayout.astro` applies the active theme as `data-palette` on `<html>` from the app database.
|
|
12
|
+
- `site/src/styles.css` owns only starter defaults and layout/component CSS. Do not put durable palette choices there unless you are changing the fallback defaults.
|
|
13
|
+
- **Switching look = switching palette**, via theme selection (`--palette` accepts the keys the theme's registry entry lists) - not scattering overrides across templates.
|
|
14
|
+
- **A new strategy = a new registry palette or Galley overlay** defining the same semantic variables. For reusable packages, add a standard or signature palette artifact; for app-local work, edit the generated palette file or use a validated Galley `paletteCss` overlay. Record it in `DESIGN.md` as a deviation with its why.
|
|
15
|
+
- Sections style against semantic classes and variables only. One hardcoded hex in a Liquid template breaks every palette except the one it was written against.
|
|
16
|
+
|
|
17
|
+
## Execute the chosen strategy
|
|
18
|
+
|
|
19
|
+
- **Restrained**: tinted neutrals do 90% of the work; one accent ≤10% of visual weight, reserved for primary actions, links, and emphasis. The 60-30-10 weighting applies here — and only here.
|
|
20
|
+
- **Committed**: one saturated color carries 30–60% of the surface (a drenched hero band, a colored nav, full-bleed section backgrounds). Don't hedge with neutrals around the edges; commit.
|
|
21
|
+
- **Full palette**: 3–4 named roles, each used deliberately and consistently — never rainbow application.
|
|
22
|
+
- **Drenched**: the surface IS the color; text and accents are tints and inks of it.
|
|
23
|
+
|
|
24
|
+
Name a real reference before picking values ("Klim #ff4500 orange drench",
|
|
25
|
+
"Vercel pure black monochrome"). When a cultural-symbol palette is the
|
|
26
|
+
obvious pull (Italian flag greens, national colors), reach past it — let the
|
|
27
|
+
cultural reading come from typography, imagery, and copy.
|
|
28
|
+
|
|
29
|
+
## Use OKLCH
|
|
30
|
+
|
|
31
|
+
The starter's palettes are OKLCH; stay in it. `oklch(L C H)` is perceptually
|
|
32
|
+
uniform — equal lightness steps *look* equal. Build ramps by holding chroma +
|
|
33
|
+
hue and varying lightness; **reduce chroma near white and black** (high
|
|
34
|
+
chroma at extreme lightness looks garish).
|
|
35
|
+
|
|
36
|
+
- **Tinted neutrals**: pure gray is dead next to a colored brand. Add 0.005–0.015 chroma toward *this site's own hue* to neutrals — cohesive without reading as "tinted". Never tint warm or cool by formula; that's the cross-project monoculture move.
|
|
37
|
+
- **The cream ban**: the warm near-white band (L 0.84–0.97, C < 0.06, hue 40–100) is the saturated AI default body background — token names like `--paper`, `--sand`, `--linen` are tells in themselves. "Warm, traditional, editorial" briefs are carried by accent + typography + imagery; the body is either a true off-white at the brand's own hue (or chroma 0), a saturated brand color, or a darker mid-tone that's clearly the brand's own.
|
|
38
|
+
- The hue is a brand decision, not a default: not blue-250 or warm-60 by reflex.
|
|
39
|
+
|
|
40
|
+
## Contrast
|
|
41
|
+
|
|
42
|
+
| Content | AA minimum |
|
|
43
|
+
|---------|------------|
|
|
44
|
+
| Body text (and placeholders) | 4.5:1 |
|
|
45
|
+
| Large text (≥18px, or bold ≥14px) | 3:1 |
|
|
46
|
+
| UI components, icons, focus rings | 3:1 |
|
|
47
|
+
|
|
48
|
+
- The #1 failure: light gray body text on near-white "for elegance". If it's even close, move toward the ink end.
|
|
49
|
+
- Gray text on a colored background looks washed out — use a darker shade of the background's own hue, or a transparency of the text color.
|
|
50
|
+
- Thin light text over photos has unpredictable contrast: add a scrim, a solid band, or move the text.
|
|
51
|
+
- Verify with a checker or DevTools, not your eyes. Test every `[data-palette]` the site exposes, including generated palettes and any live Galley overlay, and never rely on color alone for meaning (8% of men can't separate red/green).
|
|
52
|
+
|
|
53
|
+
## Dark palettes
|
|
54
|
+
|
|
55
|
+
A dark site (the scene sentence decides — see [direction.md](direction.md))
|
|
56
|
+
is not inverted light:
|
|
57
|
+
|
|
58
|
+
- Depth from lighter surfaces, not shadows: a 3-step surface ramp (~15% / 20% / 25% L) at the brand's own hue and low chroma.
|
|
59
|
+
- Body background: pure black or a brand-tinted near-black (oklch 12–18% L).
|
|
60
|
+
- Desaturate accents slightly; drop body weight a notch; see the light-on-dark compensation in [typography.md](typography.md).
|
|
61
|
+
|
|
62
|
+
### Single-scheme palettes and mode toggles
|
|
63
|
+
|
|
64
|
+
Every palette declares a color scheme: `"light dark"` (both modes), `"dark"`,
|
|
65
|
+
or `"light"`. The generated `site/src/lib/palettes.gen.ts` exports
|
|
66
|
+
`PALETTE_SCHEMES`, and single-scheme blocks in `palettes.gen.css` carry a
|
|
67
|
+
banner comment. A `"dark"` palette (e.g. the standard `noir`) is dark in both
|
|
68
|
+
OS modes by design — its tokens live in the base `[data-palette]` block, it
|
|
69
|
+
declares `color-scheme: dark` for native form controls, and it ships no
|
|
70
|
+
`.dark` override block. **Do not build a light/dark mode toggle while a
|
|
71
|
+
single-scheme palette is active**; there is no second mode to switch to. If
|
|
72
|
+
the site offers a toggle, gate it on
|
|
73
|
+
`PALETTE_SCHEMES[activePalette] === "light dark"`.
|
|
74
|
+
|
|
75
|
+
## Alpha is a design smell
|
|
76
|
+
|
|
77
|
+
Heavy rgba/transparency usually means an incomplete palette — unpredictable
|
|
78
|
+
contrast and inconsistency. Define explicit overlay and hover values in the
|
|
79
|
+
palette block. Exceptions: focus rings, scrims over imagery, momentary
|
|
80
|
+
interactive states.
|
|
81
|
+
|
|
82
|
+
## Never
|
|
83
|
+
|
|
84
|
+
- Hardcoded hex/oklch values, font families, or radii in section markup.
|
|
85
|
+
- Gray text on colored backgrounds; color as the only state indicator.
|
|
86
|
+
- Purple-blue gradients; default cream/sand bodies; palettes converging across projects.
|
|
87
|
+
- Editing a shared stock palette in place for a new direction - author a new signature palette or app-local overlay and record it.
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
|