@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,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,140 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: raybase-tanstack-start-design
|
|
3
|
+
description: Design beautiful, usable web-app UI in a Raybase TanStack Start app — typography, color, layout, motion, interaction states, UX copy, delight, and final polish. Read before building or restyling any TanStack Start screen. Not for apps embedded in another platform's admin, which follow that platform's design system.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Raybase TanStack Start Design Skill
|
|
7
|
+
|
|
8
|
+
Design serves the product. Raybase apps are tools — dashboards, tables, forms, settings, workflows — places where the user is in a task. The bar is **earned familiarity with a signature**: an interface a user fluent in the category's best tools (Linear, Stripe, Notion, Raycast) would sit down and trust, with one or two deliberate choices that make it unmistakably this app.
|
|
9
|
+
|
|
10
|
+
App UI's failure mode isn't flatness, it's strangeness without purpose: over-decorated buttons, mismatched form controls, gratuitous motion, display fonts where labels should be, invented affordances for standard tasks. The tool should disappear into the task.
|
|
11
|
+
|
|
12
|
+
## Process
|
|
13
|
+
|
|
14
|
+
1. **Read what's there.** Before designing, read the project's existing tokens, theme, and a representative component or screen (`src/styles.css`, `src/components/`, one route). Reuse what works. Never introduce a second icon set, a second font, or a parallel component vocabulary.
|
|
15
|
+
2. **Commit to a small system** and record it in `DESIGN.md` (below). Palette, type scale, spacing/radius scale, canonical layouts. Decide once; every screen draws from it.
|
|
16
|
+
3. **Design the auth door too.** 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; Raybase config still owns the auth routes and behavior.
|
|
17
|
+
4. **Build with full state coverage.** Default, hover, focus-visible, active, disabled, loading, error, success, empty, long-text. Half-finished states are the difference between a demo and a product.
|
|
18
|
+
5. **Look at it.** Screenshot or open the running app at mobile and desktop widths before calling anything done. A screenshot you didn't read doesn't count.
|
|
19
|
+
|
|
20
|
+
## DESIGN.md
|
|
21
|
+
|
|
22
|
+
Keep one short `DESIGN.md` at the project root — create it the first time you make design decisions, update it when a decision changes. One page, four sections, nothing more:
|
|
23
|
+
|
|
24
|
+
- **Palette** — token names with values: bg, surface, ink, muted, accent, plus semantic success/warning/error/info.
|
|
25
|
+
- **Typography** — the family (or families), the rem scale, which weight plays which role.
|
|
26
|
+
- **Spacing & shape** — spacing scale, radius scale, shadow/elevation steps.
|
|
27
|
+
- **Canonical layouts** — the 2–4 page shapes this app uses (e.g. "list page: page header + filter bar + table", "detail page: content left, meta rail right") so every new screen matches one instead of inventing a new shape.
|
|
28
|
+
|
|
29
|
+
That is the entire documentation process. No brand books, no per-feature briefs.
|
|
30
|
+
|
|
31
|
+
## Tooling
|
|
32
|
+
|
|
33
|
+
The built-in TanStack Start starter ships Tailwind CSS v4 and shadcn Base UI (`base-nova`) component configuration. Default to Tailwind utilities, and reach for shadcn/ui when the app needs real components — neither is mandatory, but don't substitute something else without a reason.
|
|
34
|
+
|
|
35
|
+
- **Tailwind**: style with utilities. Keep `@theme inline` in `src/styles.css`
|
|
36
|
+
as the mapping from Tailwind utilities to semantic CSS variables. Override
|
|
37
|
+
app palette variables such as `--background`, `--foreground`, `--primary`,
|
|
38
|
+
and `--radius` either in the imported `src/themes/*.css` preset or in a
|
|
39
|
+
single `@layer base { :root { ... } }` block after the preset import. Don't
|
|
40
|
+
scatter arbitrary values (`p-[13px]`, `text-[#4a4a4a]`) — if a value recurs,
|
|
41
|
+
it's a token.
|
|
42
|
+
- **shadcn/ui Base UI** (`pnpm dlx shadcn@4.11.0 add button dialog ...`): `components.json` already declares `base-nova`, so ordinary add commands copy Base UI-backed components into `src/components/ui/`. Components are themed through CSS variables. Retheme the variables to this app's palette and radius -- never ship the stock zinc look as the final design, and never restyle one copy of a component differently per screen.
|
|
43
|
+
- Icons: pick one library (lucide-react pairs well with shadcn) and use it everywhere.
|
|
44
|
+
|
|
45
|
+
## Hard rules
|
|
46
|
+
|
|
47
|
+
These apply to every screen. The references go deeper; these are the floor.
|
|
48
|
+
|
|
49
|
+
**Color**
|
|
50
|
+
- Body text ≥ 4.5:1 contrast against its background; large text (≥18px, or bold ≥14px) ≥ 3:1; placeholders need 4.5:1 too. The most common failure is muted gray body text on a tinted near-white — when in doubt, darken the text.
|
|
51
|
+
- Never gray text on a colored background — it looks washed out. Use a darker shade of the background's own hue, or a transparency of the text color.
|
|
52
|
+
- The accent color marks primary actions, current selection, and state. Not decoration.
|
|
53
|
+
|
|
54
|
+
**Typography**
|
|
55
|
+
- One well-tuned family usually carries the whole app. Fixed `rem` scale, 1.125–1.2 ratio between steps — never fluid `clamp()` type inside app UI.
|
|
56
|
+
- Body text ≥ 16px. Prose line length 65–75ch; tables and dense UI can run wider and tighter.
|
|
57
|
+
- No display fonts in labels, buttons, or data. `text-wrap: balance` on headings.
|
|
58
|
+
|
|
59
|
+
**Layout**
|
|
60
|
+
- All spacing from a scale (Tailwind's is fine). Vary it for rhythm: tight within groups, generous between sections.
|
|
61
|
+
- Cards are the lazy answer — use them only when content is truly distinct and actionable. Nested cards are always wrong.
|
|
62
|
+
- Flexbox for 1D, Grid for 2D. Build a semantic z-index scale (dropdown → sticky → backdrop → modal → toast → tooltip); never 999.
|
|
63
|
+
|
|
64
|
+
**Motion**
|
|
65
|
+
- 150–250ms for most transitions. Motion conveys state — feedback, reveal, loading — never decoration. No page-load choreography; users load into a task.
|
|
66
|
+
- Ease out with exponential curves (quart/quint/expo). No bounce, no elastic.
|
|
67
|
+
- `prefers-reduced-motion` support is not optional.
|
|
68
|
+
|
|
69
|
+
**Interaction**
|
|
70
|
+
- Every interactive element designs all its states (see [reference/interaction.md](reference/interaction.md)).
|
|
71
|
+
- Skeletons over spinners; empty states teach the interface; never `outline: none` without a `:focus-visible` replacement.
|
|
72
|
+
- Dropdowns positioned `absolute` inside `overflow: hidden/auto` containers get clipped — use the Popover API, `position: fixed`, or a portal.
|
|
73
|
+
|
|
74
|
+
## Make it individual
|
|
75
|
+
|
|
76
|
+
Familiar ≠ generic. Give the app a signature, then spend the rest of the budget on consistency:
|
|
77
|
+
|
|
78
|
+
- **Pick the accent hue deliberately.** Not default blue, not purple-blue gradient territory. If someone could guess the palette from the app's category alone ("finance → navy", "AI → purple"), push one notch further.
|
|
79
|
+
- **Tint the neutrals toward the accent** (0.005–0.015 chroma in OKLCH) instead of pure gray, so surfaces and brand cohere.
|
|
80
|
+
- **Choose one or two signature moves** — a distinctive-but-readable UI face, an unusually confident density, a consistent radius language, one earned delight moment — and execute them everywhere. One committed decision beats five decorative ones.
|
|
81
|
+
- Dark vs light is a decision, not a default. Write one sentence about who uses this app, where, in what light. If the sentence doesn't force the answer, add detail until it does.
|
|
82
|
+
|
|
83
|
+
## Absolute bans
|
|
84
|
+
|
|
85
|
+
If you're about to write any of these, rewrite the element with different structure:
|
|
86
|
+
|
|
87
|
+
- **Side-stripe borders** — `border-left/right` > 1px as a colored accent on cards, list items, or alerts. Use a full hairline border, a background tint, or a leading icon.
|
|
88
|
+
- **Gradient text** (`background-clip: text`). Solid color; emphasis via weight or size.
|
|
89
|
+
- **Glassmorphism as default.** Blur/glass used decoratively. Rare and purposeful, or nothing.
|
|
90
|
+
- **The ghost card** — `border: 1px solid` paired with a wide soft `box-shadow` (blur ≥ 16px) on the same element. Pick one.
|
|
91
|
+
- **Over-rounding** — cards and inputs top out at 12–16px radius. Full-pill is for tags and buttons only.
|
|
92
|
+
- **The hero-metric template** — big number, small label, gradient accent — unless it displays real user data.
|
|
93
|
+
- **Identical card grids** — same-sized icon + heading + text cards, repeated endlessly.
|
|
94
|
+
- **Nested cards.** Always wrong.
|
|
95
|
+
- **Purple-blue gradients** and `repeating-linear-gradient` stripe backgrounds.
|
|
96
|
+
- **Tiny uppercase tracked eyebrows / numbered section markers (01 · 02 · 03) as scaffolding** above every heading. Numbers earn their place only when the content really is a sequence.
|
|
97
|
+
- **Hand-drawn / sketchy SVG illustrations** as fallback art. If you can't render a scene with real assets, ship no illustration.
|
|
98
|
+
- **Inconsistent component vocabulary.** If the save button looks different on two screens, one of them is wrong.
|
|
99
|
+
- **Reinvented standard affordances** — custom scrollbars, weird form controls, non-standard modals.
|
|
100
|
+
- **Modal as first thought.** Modals are usually laziness; exhaust inline and progressive alternatives first.
|
|
101
|
+
- **Decorative motion** that conveys no state.
|
|
102
|
+
|
|
103
|
+
## App-UI permissions
|
|
104
|
+
|
|
105
|
+
Things app UI can afford that marketing surfaces can't — use them without guilt:
|
|
106
|
+
|
|
107
|
+
- System fonts and familiar sans defaults (Inter, system-ui stacks) when performance beats personality.
|
|
108
|
+
- Standard navigation patterns: top bar + side nav, breadcrumbs, tabs, command palettes.
|
|
109
|
+
- Density. Tables with many rows, panels with many labels — when users need the information.
|
|
110
|
+
- Consistency over surprise. The same vocabulary screen to screen is a virtue; save delight for moments, not pages.
|
|
111
|
+
|
|
112
|
+
## App identity assets
|
|
113
|
+
|
|
114
|
+
The scaffold stamps letter-mark placeholders for the PWA install surface:
|
|
115
|
+
`public/manifest.webmanifest` plus `public/icons/app-icon.svg`,
|
|
116
|
+
`app-icon-maskable.svg`, and `apple-touch-icon.png`. During the design pass,
|
|
117
|
+
restyle the two SVGs to match the app's palette and mark (keep the maskable
|
|
118
|
+
variant full-bleed with the mark inside the central 80% safe zone), set the
|
|
119
|
+
manifest `theme_color`/`background_color` to the app's tokens, and keep
|
|
120
|
+
`short_name` under ~12 characters. The apple-touch-icon is a raster PNG —
|
|
121
|
+
leave the stamped letter tile in place unless you have a real PNG to ship.
|
|
122
|
+
|
|
123
|
+
## Reference files
|
|
124
|
+
|
|
125
|
+
Read the relevant file before working in its area — they hold the depth this file deliberately omits:
|
|
126
|
+
|
|
127
|
+
| File | Read when |
|
|
128
|
+
|---|---|
|
|
129
|
+
| [reference/typography.md](reference/typography.md) | choosing fonts, building the type scale, fixing hierarchy or readability |
|
|
130
|
+
| [reference/color.md](reference/color.md) | building the palette, theming shadcn, dark mode, contrast questions |
|
|
131
|
+
| [reference/layout.md](reference/layout.md) | page structure, spacing rhythm, hierarchy, responsive behavior |
|
|
132
|
+
| [reference/motion.md](reference/motion.md) | adding any animation or transition |
|
|
133
|
+
| [reference/interaction.md](reference/interaction.md) | forms, focus, dropdowns/overlays, keyboard support, loading patterns |
|
|
134
|
+
| [reference/copy.md](reference/copy.md) | writing labels, errors, empty states, confirmations |
|
|
135
|
+
| [reference/delight.md](reference/delight.md) | adding personality or memorable moments |
|
|
136
|
+
| [reference/polish.md](reference/polish.md) | the final pass before any screen ships — includes the hardening checklist |
|
|
137
|
+
|
|
138
|
+
## Credits
|
|
139
|
+
|
|
140
|
+
Substantial portions of this skill are adapted from [Impeccable Design](https://impeccable.style/), used under the Apache License 2.0. If you want the full system — live browser iteration, critique scoring, detector rules, brand-register design — use Impeccable directly.
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# Color
|
|
2
|
+
|
|
3
|
+
App UI color is semantic first and almost always restrained: tinted neutrals doing 90% of the work, one accent reserved for actions and state. Strategic color beats rainbow vomit; every color has a job.
|
|
4
|
+
|
|
5
|
+
## Use OKLCH
|
|
6
|
+
|
|
7
|
+
Stop using HSL. OKLCH is perceptually uniform — equal lightness steps *look* equal. `oklch(L C H)`: lightness 0–100%, chroma ~0–0.4, hue 0–360. Build shade ramps by holding chroma + hue and varying lightness; **reduce chroma near white and black** (high chroma at extreme lightness looks garish).
|
|
8
|
+
|
|
9
|
+
The hue is a product decision, not a default. Don't reach for blue (~250) or warm orange (~60) by reflex — those are the saturated AI defaults. Equally, don't translate "warm/friendly" into the cream/sand near-white body background; that band (OKLCH L 0.84–0.97, C < 0.06, hue 40–100) is the most recognizable AI tell of all. Stay neutral or tint toward this app's own accent.
|
|
10
|
+
|
|
11
|
+
## Palette structure
|
|
12
|
+
|
|
13
|
+
| Role | Purpose | Shape |
|
|
14
|
+
|------|---------|-------|
|
|
15
|
+
| **Accent** | primary actions, selection, focus, links | 1 hue, 3–5 shades |
|
|
16
|
+
| **Neutral** | text, backgrounds, borders | 9–11 shade ramp, tinted toward the accent |
|
|
17
|
+
| **Semantic** | success / error / warning / info | 4 hues, 2–3 shades each |
|
|
18
|
+
| **Surface** | page bg, cards, overlays, panels | 2–3 elevation levels |
|
|
19
|
+
|
|
20
|
+
- **Tinted neutrals:** pure gray is dead next to a colored accent. Add 0.005–0.015 chroma toward *this app's* accent hue to every neutral — unconsciously cohesive, never reads as "tinted". Don't tint warm or cool by formula.
|
|
21
|
+
- **A second neutral layer** for sidebars, toolbars, and panels — slightly lighter/darker than the content surface — separates chrome from content without borders everywhere.
|
|
22
|
+
- **Skip secondary/tertiary accents** unless the app genuinely needs them (e.g. data viz categories). One accent is almost always enough.
|
|
23
|
+
- **60-30-10 by visual weight:** ~60% neutral surfaces and whitespace, ~30% text/borders/secondary, ~10% accent. Accents work *because* they're rare.
|
|
24
|
+
|
|
25
|
+
## Semantic state colors
|
|
26
|
+
|
|
27
|
+
Standardize the full vocabulary: hover, focus, active, disabled, selected, loading, error, warning, success, info. Same color always means the same thing — green is success everywhere or nowhere. Never rely on color alone (icons/labels too; 8% of men can't separate red/green).
|
|
28
|
+
|
|
29
|
+
## Tokens, Tailwind, and shadcn
|
|
30
|
+
|
|
31
|
+
Two layers: primitive (`--blue-500`-style ramps) and semantic (`--color-accent`, `--color-surface`, `--color-ink`). Components reference only the semantic layer; dark mode redefines only the semantic layer.
|
|
32
|
+
|
|
33
|
+
- In Tailwind v4, keep `@theme inline` as the utility mapping layer:
|
|
34
|
+
`--color-background: var(--background)`, `--font-sans:
|
|
35
|
+
var(--app-font-sans)`, and so on. Do not put app-specific color values in
|
|
36
|
+
`@theme inline`.
|
|
37
|
+
- shadcn Base UI's CSS variables (`--background`, `--foreground`, `--primary`, `--muted`, `--destructive`, `--radius`, …) *are* the semantic layer — retheme those variables to this app's palette and every copied component follows. Put app-specific values in the single active `src/themes/*.css` palette import or in one `@layer base { :root { ... } }` override after that import. Bare duplicate `:root` blocks outside `@layer base` are easy to lose in Tailwind v4's cascade. Never ship stock zinc as the final theme.
|
|
38
|
+
|
|
39
|
+
## Theme presets & the light/dark toggle
|
|
40
|
+
|
|
41
|
+
The starter ships seven palette snippets in `src/themes/*.css`: `base` plus `zen`, `carbon`, `sage`, `slate`, `ultra`, and `sand`. `src/styles.css` imports one active palette. Pick a snippet as a starting point during implementation, then either keep exactly one palette import or copy the chosen tokens into `src/themes/base.css`. Each file is a full light palette plus a `.dark` block. See `docs/themes.md` in the app for the per-theme "reach for it when…" table.
|
|
42
|
+
|
|
43
|
+
Light/dark is a runtime toggle, separate from palette selection: `<ModeToggle/>` flips the `.dark` class, a pre-paint script in `_app.tsx` applies the saved choice before first paint, and it persists to the localStorage key `theme` — the **same key Fumadocs/next-themes uses**, so app pages and `/docs` stay in sync. The default is the OS `prefers-color-scheme`. To add a palette direction, copy a snippet, keep it as plain `:root` and `.dark` token blocks, keep colors in OKLCH, and check the primary clears AA (see below).
|
|
44
|
+
|
|
45
|
+
## Contrast
|
|
46
|
+
|
|
47
|
+
| Content | AA minimum |
|
|
48
|
+
|---------|------------|
|
|
49
|
+
| Body text (and placeholders) | 4.5:1 |
|
|
50
|
+
| Large text (≥18px, or bold ≥14px) | 3:1 |
|
|
51
|
+
| UI components, icons, focus rings | 3:1 |
|
|
52
|
+
|
|
53
|
+
Commonly failing combos: light gray on white (the #1 fail), gray on any colored background (use a darker shade of that background's hue, or text-color transparency), yellow on white, thin light text on images. If contrast is even close, bump toward the ink end — light gray "for elegance" is the single biggest reason AI designs feel hard to read. Verify with a checker or DevTools, not your eyes.
|
|
54
|
+
|
|
55
|
+
## Dark mode is not inverted light mode
|
|
56
|
+
|
|
57
|
+
| Light mode | Dark mode |
|
|
58
|
+
|------------|-----------|
|
|
59
|
+
| shadows for depth | lighter surfaces for depth |
|
|
60
|
+
| dark text on light | light text on dark — reduce weight slightly (e.g. 350) |
|
|
61
|
+
| vibrant accents | slightly desaturated accents |
|
|
62
|
+
| white backgrounds | brand-tinted near-black (oklch 12–18% L) or pure black |
|
|
63
|
+
|
|
64
|
+
Build a 3-step dark surface ramp (e.g. 15% / 20% / 25% lightness) using the accent's own hue at low chroma; elevation = lighter, not shadowed.
|
|
65
|
+
|
|
66
|
+
## Alpha is a design smell
|
|
67
|
+
|
|
68
|
+
Heavy rgba/transparency usually means an incomplete palette: unpredictable contrast and inconsistency. Define explicit overlay/hover colors per surface. Exceptions: focus rings and momentary interactive states.
|
|
69
|
+
|
|
70
|
+
## Never
|
|
71
|
+
|
|
72
|
+
- Accent color as decoration, or heavy saturation on inactive states.
|
|
73
|
+
- Gray text on colored backgrounds.
|
|
74
|
+
- More than 2–4 colors beyond neutrals; rainbow application without meaning.
|
|
75
|
+
- Purple-blue gradients; default-warm cream/sand backgrounds.
|
|
76
|
+
- Color as the only state indicator.
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
# UX Copy
|
|
2
|
+
|
|
3
|
+
Interface text is part of the design. Vague copy creates support tickets and abandonment; specific copy gets users through the task. Good UX writing is invisible — users understand immediately without noticing the words.
|
|
4
|
+
|
|
5
|
+
## Principles
|
|
6
|
+
|
|
7
|
+
1. **Be specific**: "Enter email" not "Enter value".
|
|
8
|
+
2. **Be concise**: cut every sentence in half, then again.
|
|
9
|
+
3. **Be active**: "Save changes" not "Changes will be saved".
|
|
10
|
+
4. **Be human**, not system-flavored — but never cute during errors.
|
|
11
|
+
5. **Tell users what to do**, not just what happened.
|
|
12
|
+
6. **Be consistent**: one term per concept, everywhere.
|
|
13
|
+
|
|
14
|
+
## Buttons
|
|
15
|
+
|
|
16
|
+
Never "OK", "Submit", or "Yes/No". Verb + object:
|
|
17
|
+
|
|
18
|
+
| Bad | Good | Why |
|
|
19
|
+
|-----|------|-----|
|
|
20
|
+
| OK | Save changes | says what happens |
|
|
21
|
+
| Submit | Create account | outcome-focused |
|
|
22
|
+
| Yes | Delete message | confirms the action |
|
|
23
|
+
| Cancel | Keep editing | clarifies what cancel means |
|
|
24
|
+
| Click here | Download PDF | describes the destination |
|
|
25
|
+
|
|
26
|
+
For destructive actions, name the destruction and show the count: "Delete 5 items", not "Remove selected".
|
|
27
|
+
|
|
28
|
+
## Error messages
|
|
29
|
+
|
|
30
|
+
Every error answers three questions: what happened, why, how to fix it.
|
|
31
|
+
|
|
32
|
+
| Situation | Template |
|
|
33
|
+
|-----------|----------|
|
|
34
|
+
| Format error | "[Field] needs to be [format]. Example: [example]" |
|
|
35
|
+
| Missing required | "Please enter [what's missing]" |
|
|
36
|
+
| Permission denied | "You don't have access to [thing]. [What to do instead]" |
|
|
37
|
+
| Network error | "We couldn't reach [thing]. Check your connection and [action]." |
|
|
38
|
+
| Server error | "Something went wrong on our end. We're looking into it. [Alternative action]" |
|
|
39
|
+
|
|
40
|
+
Don't blame the user: "Please enter a date in MM/DD/YYYY format", never "You entered an invalid date". **Never use humor for errors** — users are already frustrated; be helpful, not cute.
|
|
41
|
+
|
|
42
|
+
## Empty states
|
|
43
|
+
|
|
44
|
+
Empty states are onboarding moments, not dead ends. Three parts: what will be here, why it's valuable, a clear action.
|
|
45
|
+
|
|
46
|
+
> No projects yet. Projects organize your work and your team's. **[Create your first project]**
|
|
47
|
+
|
|
48
|
+
Distinguish the types — first use (sell the value, offer a template), cleared by the user (light touch), no search results (suggest a different query, offer to clear filters), no permission (explain why, how to get access).
|
|
49
|
+
|
|
50
|
+
## Loading and success
|
|
51
|
+
|
|
52
|
+
- Specific beats generic: "Saving your draft…" not "Loading…". For long waits, set expectations ("usually takes 30–60 seconds") or show progress.
|
|
53
|
+
- Success: confirm what happened and what's next, briefly. "Settings saved — changes take effect immediately."
|
|
54
|
+
- Loading copy that's specific to what the app actually does, never AI-filler whimsy ("Herding pixels…", "Teaching robots to dance…" are instantly recognizable machine copy).
|
|
55
|
+
|
|
56
|
+
## Confirmation dialogs
|
|
57
|
+
|
|
58
|
+
Most are design failures — prefer undo (see [interaction.md](interaction.md)). When you must confirm: name the action and object, state the consequence, use specific button labels.
|
|
59
|
+
|
|
60
|
+
## Voice and tone
|
|
61
|
+
|
|
62
|
+
Voice (the app's personality) stays constant; tone adapts to the moment:
|
|
63
|
+
|
|
64
|
+
| Moment | Tone |
|
|
65
|
+
|--------|------|
|
|
66
|
+
| Success | celebratory, brief |
|
|
67
|
+
| Error | empathetic, helpful |
|
|
68
|
+
| Loading | reassuring |
|
|
69
|
+
| Destructive confirm | serious, clear |
|
|
70
|
+
|
|
71
|
+
## Consistency
|
|
72
|
+
|
|
73
|
+
Pick one term and enforce it everywhere — Delete *or* Remove, Settings *or* Preferences, Sign in *or* Log in, Create *or* Add. The same concept must use the same noun on every screen ("Workspace" here can't be "Project" three screens away). If the heading explains it, the intro is redundant; say it once.
|
|
74
|
+
|
|
75
|
+
## Accessibility and translation
|
|
76
|
+
|
|
77
|
+
- Link text has standalone meaning: "View pricing plans", not "Click here".
|
|
78
|
+
- Alt text describes the information, not the image; `alt=""` for decoration. Icon-only buttons need `aria-label`.
|
|
79
|
+
- Leave room for translation: German runs ~+30%. No fixed widths on text containers; full sentences as single strings; no abbreviations ("5 minutes ago", not "5 mins ago").
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
# Delight
|
|
2
|
+
|
|
3
|
+
Delight is what turns a functional interface into one users remember and recommend. In app UI it lives at specific **moments** — completion, first-time actions, error recovery, milestones — not spread across pages. Reliability and consistency carry the rest of the experience; delight pushed everywhere reads as noise.
|
|
4
|
+
|
|
5
|
+
## Principles
|
|
6
|
+
|
|
7
|
+
- **Amplifies, never blocks.** Delight moments are quick (<1s), skippable, and never delay core functionality. If users notice the delight more than their goal, it's gone too far.
|
|
8
|
+
- **Appropriate to context.** Celebrate success; empathize with errors; never be playful during a critical failure. An invoicing tool and a habit tracker have different licenses.
|
|
9
|
+
- **Compounds over time.** Vary responses so the 100th encounter still lands; reveal layers with continued use; don't announce every touch — let users discover some.
|
|
10
|
+
- **Earned, not defaulted.** One signature moment executed perfectly beats ten scattered flourishes.
|
|
11
|
+
|
|
12
|
+
## Where delight belongs in an app
|
|
13
|
+
|
|
14
|
+
- **Completion**: a checkmark draw animation on save; a satisfying progress-bar finish; confetti reserved for genuinely major milestones (first deploy, 100th order — not every form submit).
|
|
15
|
+
- **First-time actions**: the first project, the first invite, the first import get slightly warmer treatment than the hundredth.
|
|
16
|
+
- **Empty states**: a touch of personality in the illustration or copy — see [copy.md](copy.md) for the structure.
|
|
17
|
+
- **Error recovery**: soften the moment; a helpful, human error message is itself a delight feature.
|
|
18
|
+
- **Micro-interactions**: a button that presses down 1–2px, a toggle that slides with weight, a checkbox with a subtle scale pulse. Felt, not seen.
|
|
19
|
+
|
|
20
|
+
```css
|
|
21
|
+
.button { transition: transform 0.1s, box-shadow 0.1s; }
|
|
22
|
+
.button:hover { transform: translateY(-1px); }
|
|
23
|
+
.button:active { transform: translateY(1px); }
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
- **Easter eggs** (lightest touch): a console message for developers, a keyboard shortcut that's a pleasure to find. Optional, never load-bearing.
|
|
27
|
+
|
|
28
|
+
## Copy as delight
|
|
29
|
+
|
|
30
|
+
Personality lives cheaply in words — empty states, success toasts, loading messages — as long as it's *this product's* voice. Write loading and empty-state copy specific to what the app actually does ("Syncing your team's changes…"), never generic AI-filler whimsy ("Herding pixels…", "Consulting the magic 8-ball…").
|
|
31
|
+
|
|
32
|
+
## Implementation notes
|
|
33
|
+
|
|
34
|
+
- CSS covers most of it. For orchestrated moments: Motion/Framer Motion, canvas-confetti, Lottie for illustrated animation.
|
|
35
|
+
- Sound is almost never right in a web app; if used, off by default and respectful of system settings.
|
|
36
|
+
- Everything here obeys [motion.md](motion.md): timing, easing, `prefers-reduced-motion`, and performance budgets apply to delight doubly.
|
|
37
|
+
|
|
38
|
+
## Never
|
|
39
|
+
|
|
40
|
+
- Delay or hide core functionality for a flourish.
|
|
41
|
+
- Use delight to paper over poor UX.
|
|
42
|
+
- Make every interaction delightful — special moments stop being special.
|
|
43
|
+
- Repeat an unskippable celebration on every occurrence.
|
|
44
|
+
- Sacrifice performance or accessibility for it.
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
# Interaction
|
|
2
|
+
|
|
3
|
+
The difference between a screenshot and a product is interaction design: states, focus, keyboard paths, and overlays that don't break. shadcn/ui components ship most of this correctly — another reason to use them — but everything custom must clear the same bar.
|
|
4
|
+
|
|
5
|
+
## The eight states
|
|
6
|
+
|
|
7
|
+
Every interactive element designs all of these. Don't ship with half:
|
|
8
|
+
|
|
9
|
+
| State | When | Treatment |
|
|
10
|
+
|-------|------|-----------|
|
|
11
|
+
| Default | at rest | base styling |
|
|
12
|
+
| Hover | pointer over (not touch) | subtle lift, color shift |
|
|
13
|
+
| Focus | keyboard focus | visible ring (below) |
|
|
14
|
+
| Active | being pressed | pressed in, darker |
|
|
15
|
+
| Disabled | not interactive | reduced opacity, no pointer |
|
|
16
|
+
| Loading | processing | spinner in button, skeleton in content |
|
|
17
|
+
| Error | invalid | border + icon + message |
|
|
18
|
+
| Success | completed | confirmation |
|
|
19
|
+
|
|
20
|
+
The common miss: hover without focus, or vice versa. They're different — keyboard users never see hover states.
|
|
21
|
+
|
|
22
|
+
Disabled needs a *why*: when an element is disabled because a condition isn't met (form incomplete, missing permission, plan limit), say so nearby — helper text, an inline hint, or a tooltip. A silently disabled button is a frustration trap. Often the better design is to keep the button enabled and validate on submit — the error can explain; a disabled control can't, and it's invisible to keyboard and screen-reader users.
|
|
23
|
+
|
|
24
|
+
## Focus rings
|
|
25
|
+
|
|
26
|
+
Never `outline: none` without a replacement. Use `:focus-visible` so rings appear for keyboard users only:
|
|
27
|
+
|
|
28
|
+
```css
|
|
29
|
+
button:focus { outline: none; }
|
|
30
|
+
button:focus-visible { outline: 2px solid var(--color-accent); outline-offset: 2px; }
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
2–3px thick, offset outside the element, ≥3:1 contrast against adjacent colors, consistent across every interactive element.
|
|
34
|
+
|
|
35
|
+
## Forms
|
|
36
|
+
|
|
37
|
+
- **Placeholders aren't labels** — they disappear on input. Always visible `<label>` elements.
|
|
38
|
+
- **Validate on blur**, not on every keystroke (exception: password strength). Errors below the field, connected with `aria-describedby`. Preserve user input on error.
|
|
39
|
+
- Show format expectations with placeholder examples; explain *why* you're asking when it isn't obvious.
|
|
40
|
+
- Prevent double-submission: disable the button while the request is in flight.
|
|
41
|
+
- Logical tab order; don't overuse autofocus.
|
|
42
|
+
|
|
43
|
+
## Loading
|
|
44
|
+
|
|
45
|
+
- **Skeleton screens > spinners** — they preview content shape and feel faster. Spinners belong inside buttons, not in the middle of content.
|
|
46
|
+
- **Optimistic updates** for low-stakes actions (toggles, likes): show success immediately, roll back on failure. Never for payments or destructive actions.
|
|
47
|
+
|
|
48
|
+
## Overlays without z-index wars
|
|
49
|
+
|
|
50
|
+
The single most common generated-code bug: a dropdown positioned `absolute` inside an `overflow: hidden/auto` container gets clipped. Escape routes, in order of preference:
|
|
51
|
+
|
|
52
|
+
1. **Popover API** — `popover` attribute puts the element in the top layer (above everything, regardless of z-index or overflow), with light-dismiss and accessibility built in:
|
|
53
|
+
|
|
54
|
+
```html
|
|
55
|
+
<button popovertarget="menu">Open</button>
|
|
56
|
+
<div id="menu" popover>…</div>
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
2. **Native `<dialog>`** — `dialog.showModal()` gives a focus trap, Escape handling, and a backdrop free. For everything behind a custom modal, the `inert` attribute blocks focus and clicks without JavaScript gymnastics.
|
|
60
|
+
3. **Portal** — render at the document root (`createPortal(menu, document.body)`), position from the trigger's `getBoundingClientRect()` with `position: fixed`; recalculate on scroll/resize, flip when it would overflow the viewport edge.
|
|
61
|
+
4. **CSS anchor positioning** (`position-anchor` + `position-area` + `@position-try`) where browser support allows, with a fallback elsewhere.
|
|
62
|
+
|
|
63
|
+
And remember the product rule: **modal as first thought is laziness.** Exhaust inline and progressive alternatives before reaching for a dialog at all.
|
|
64
|
+
|
|
65
|
+
## Destructive actions: undo > confirm
|
|
66
|
+
|
|
67
|
+
Users click through confirmation dialogs mindlessly. Prefer: act immediately, show an undo toast, commit when it expires. Reserve confirmation for the truly irreversible or high-cost — and then name the object and the consequence ("Delete 'Project Alpha'? This can't be undone.") with specific button labels ("Delete project" / "Keep project", never "Yes" / "No").
|
|
68
|
+
|
|
69
|
+
## Keyboard
|
|
70
|
+
|
|
71
|
+
- All functionality reachable by keyboard; visible focus along the way.
|
|
72
|
+
- **Roving tabindex** for composite widgets (tabs, menus, radio groups): one item `tabindex="0"`, the rest `-1`, arrow keys move within, Tab leaves the widget.
|
|
73
|
+
- Skip link (`<a href="#main-content">`) hidden until focused.
|
|
74
|
+
- Command palette (⌘K) is a power-user pattern apps can earn; show shortcut hints in tooltips and menus.
|
|
75
|
+
|
|
76
|
+
## Touch and gestures
|
|
77
|
+
|
|
78
|
+
- Targets ≥ 44×44px (pad the hit area beyond the visual if needed).
|
|
79
|
+
- Gestures are invisible — anything reachable by swipe must also be reachable by a visible control.
|
|
80
|
+
|
|
81
|
+
## Never
|
|
82
|
+
|
|
83
|
+
- Removing focus indicators without a replacement.
|
|
84
|
+
- Placeholder-only labels; generic error states.
|
|
85
|
+
- Touch targets under 44×44px.
|
|
86
|
+
- Custom controls without ARIA and keyboard support — if you can't fund the full behavior, use the native element or a shadcn component.
|
|
87
|
+
- Hover as the only path to a function.
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# Layout
|
|
2
|
+
|
|
3
|
+
Space is the most underused design tool. When an interface feels "off" even though colors and fonts are fine, the layout is usually the problem. In app UI, predictable grids, consistent densities, and familiar navigation patterns win — consistency IS an affordance.
|
|
4
|
+
|
|
5
|
+
## Spacing system
|
|
6
|
+
|
|
7
|
+
- Every value comes from a scale; Tailwind's spacing scale is fine. A 4pt base (4, 8, 12, 16, 24, 32, 48, 64) beats 8pt — you'll constantly need 12px between 8 and 16.
|
|
8
|
+
- Use `gap` for sibling spacing instead of margins; no margin-collapse hacks.
|
|
9
|
+
- **Vary spacing for rhythm.** Equal padding everywhere = no hierarchy. Tight within groups (8–12px between related siblings), generous between sections (32–64px in app UI). Proximity is grouping: related elements close, distinct groups separated.
|
|
10
|
+
|
|
11
|
+
## Hierarchy
|
|
12
|
+
|
|
13
|
+
Run the squint test: blur your eyes — can you still spot the most important element, the second, and the groupings? Strong hierarchy combines 2–3 dimensions at once; a heading that is larger, bolder, *and* has more space above it reads as primary without trying.
|
|
14
|
+
|
|
15
|
+
| Tool | Strong | Weak |
|
|
16
|
+
|------|--------|------|
|
|
17
|
+
| Size | 3:1 ratio+ | <2:1 |
|
|
18
|
+
| Weight | Bold vs Regular | Medium vs Regular |
|
|
19
|
+
| Color | high contrast | similar tones |
|
|
20
|
+
| Space | surrounded by whitespace | crowded |
|
|
21
|
+
|
|
22
|
+
Space alone can be enough — generous whitespace around an element draws the eye. Add color or size contrast only when simpler means aren't sufficient.
|
|
23
|
+
|
|
24
|
+
## Structure
|
|
25
|
+
|
|
26
|
+
- **Flexbox for 1D** (toolbars, button rows, card internals), **Grid for 2D** (page shells, dashboards). Don't reach for Grid when `flex-wrap` is simpler.
|
|
27
|
+
- Breakpointless responsive grids: `repeat(auto-fit, minmax(280px, 1fr))`.
|
|
28
|
+
- Named grid areas (`grid-template-areas`) for page shells; redefine at breakpoints.
|
|
29
|
+
- **Container queries for components, viewport queries for pages.** A card in a narrow sidebar stays compact while the same card in the main column expands:
|
|
30
|
+
|
|
31
|
+
```css
|
|
32
|
+
.card-container { container-type: inline-size; }
|
|
33
|
+
@container (min-width: 400px) {
|
|
34
|
+
.card { grid-template-columns: 120px 1fr; }
|
|
35
|
+
}
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
- Match density to content: data-dense screens run tight, content screens breathe. Pick the app's density once and keep it.
|
|
39
|
+
|
|
40
|
+
## Cards: use sparingly
|
|
41
|
+
|
|
42
|
+
Cards are the lazy answer. Spacing and alignment create grouping on their own; use a card only when content is truly distinct and actionable. Never nest cards inside cards — use spacing and dividers for internal hierarchy. Break grid monotony by varying card sizes or mixing cards with non-card content; identical icon + heading + text cards repeated endlessly are a tell.
|
|
43
|
+
|
|
44
|
+
## Depth and stacking
|
|
45
|
+
|
|
46
|
+
- One consistent shadow scale (sm → md → lg), subtle, used to reinforce hierarchy — not decoration. In dark mode, depth comes from lighter surfaces, not shadows.
|
|
47
|
+
- Semantic z-index scale: dropdown → sticky → modal-backdrop → modal → toast → tooltip. Never arbitrary 999s.
|
|
48
|
+
|
|
49
|
+
## Optical adjustments
|
|
50
|
+
|
|
51
|
+
- Geometrically centered glyphs often look off-center (play icons shift right, arrows shift toward their direction). Nudge only when you're confident it actually looks wrong.
|
|
52
|
+
- Text at `margin-left: 0` looks indented because of letterform whitespace; `-0.05em` negative margin optically aligns headings with edges.
|
|
53
|
+
- **Touch targets ≥ 44×44px** even when the visual is smaller — expand the hit area:
|
|
54
|
+
|
|
55
|
+
```css
|
|
56
|
+
.icon-button { position: relative; }
|
|
57
|
+
.icon-button::before { content: ''; position: absolute; inset: -10px; }
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## Responsive behavior
|
|
61
|
+
|
|
62
|
+
In app UI, responsiveness is **structural**, not fluid type: collapse the sidebar, turn the table into cards, drop from three columns to one.
|
|
63
|
+
|
|
64
|
+
- Mobile-first: base styles narrow, `min-width` queries layer complexity. Content-driven breakpoints — stretch until the design breaks, break there. Three usually suffice (~640 / 768 / 1024).
|
|
65
|
+
- **Detect input, not just screen size**: `@media (pointer: coarse)` for bigger touch targets, `@media (hover: hover)` before relying on hover. Touch users can't hover — never make hover the only path to a function.
|
|
66
|
+
- Desktop → mobile: single column, bottom-weighted controls (thumb reach), bottom sheets instead of dropdowns, progressive disclosure instead of everything-at-once. Tables → stacked cards (`display: block` + `data-label`).
|
|
67
|
+
- Mobile → desktop: use the width — persistent side nav, master-detail, denser tables — but cap content with `max-width`; don't stretch to 4K.
|
|
68
|
+
- Safe areas on notched phones: `padding-bottom: max(1rem, env(safe-area-inset-bottom))` with `viewport-fit=cover`.
|
|
69
|
+
- **Never hide core functionality on mobile.** If it matters, make it work.
|
|
70
|
+
- Test at 320px and at 200% zoom; the viewport is part of the design. DevTools emulation is a start, not proof.
|
|
71
|
+
|
|
72
|
+
## Never
|
|
73
|
+
|
|
74
|
+
- Arbitrary spacing values outside the scale.
|
|
75
|
+
- All spacing equal — variety creates hierarchy.
|
|
76
|
+
- Everything wrapped in cards; cards nested in cards.
|
|
77
|
+
- The hero-metric template (big number, small label, gradient accent) as decoration. A prominent metric is fine when it's real user data.
|
|
78
|
+
- Different information architecture across breakpoints (confusing) or hover-only functionality.
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
Adapted from [Impeccable Design](https://impeccable.style/) (Apache-2.0).
|