adevkit 0.1.0__py3-none-any.whl
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.
- adevkit-0.1.0.dist-info/METADATA +171 -0
- adevkit-0.1.0.dist-info/RECORD +731 -0
- adevkit-0.1.0.dist-info/WHEEL +5 -0
- adevkit-0.1.0.dist-info/entry_points.txt +3 -0
- adevkit-0.1.0.dist-info/top_level.txt +1 -0
- devkit/__init__.py +4 -0
- devkit/cli.py +442 -0
- devkit/config.py +21 -0
- devkit/prompts.py +197 -0
- devkit/scaffold/__init__.py +16 -0
- devkit/scaffold/agents_md.py +152 -0
- devkit/scaffold/env_setup.py +59 -0
- devkit/scaffold/git_setup.py +69 -0
- devkit/scaffold/prd_md.py +85 -0
- devkit/scaffold/vscode_setup.py +38 -0
- devkit/skills/__init__.py +10 -0
- devkit/skills/catalog.py +156 -0
- devkit/skills/embedded/SKILL.md +52 -0
- devkit/skills/embedded/animate/RECIPES.md +324 -0
- devkit/skills/embedded/animate/SKILL.md +207 -0
- devkit/skills/embedded/animate-expo/RECIPES.md +385 -0
- devkit/skills/embedded/animate-expo/SKILL.md +263 -0
- devkit/skills/embedded/animation-performance/SKILL.md +222 -0
- devkit/skills/embedded/animation-vocabulary/SKILL.md +181 -0
- devkit/skills/embedded/apple-design/SKILL.md +290 -0
- devkit/skills/embedded/ask-sonner/API.md +64 -0
- devkit/skills/embedded/ask-sonner/SKILL.md +88 -0
- devkit/skills/embedded/banner-design/SKILL.md +145 -0
- devkit/skills/embedded/banner-design/references/banner-sizes-and-styles.md +118 -0
- devkit/skills/embedded/brand/SKILL.md +108 -0
- devkit/skills/embedded/brand/references/approval-checklist.md +169 -0
- devkit/skills/embedded/brand/references/asset-organization.md +157 -0
- devkit/skills/embedded/brand/references/brand-guideline-template.md +140 -0
- devkit/skills/embedded/brand/references/color-palette-management.md +186 -0
- devkit/skills/embedded/brand/references/consistency-checklist.md +94 -0
- devkit/skills/embedded/brand/references/logo-usage-rules.md +185 -0
- devkit/skills/embedded/brand/references/messaging-framework.md +85 -0
- devkit/skills/embedded/brand/references/typography-specifications.md +214 -0
- devkit/skills/embedded/brand/references/update.md +129 -0
- devkit/skills/embedded/brand/references/visual-identity.md +96 -0
- devkit/skills/embedded/brand/references/voice-framework.md +88 -0
- devkit/skills/embedded/brand/scripts/extract-colors.cjs +337 -0
- devkit/skills/embedded/brand/scripts/inject-brand-context.cjs +349 -0
- devkit/skills/embedded/brand/scripts/sync-brand-to-tokens.cjs +415 -0
- devkit/skills/embedded/brand/scripts/tests/test_sync_brand_to_tokens.py +368 -0
- devkit/skills/embedded/brand/scripts/validate-asset.cjs +387 -0
- devkit/skills/embedded/brand/templates/brand-guidelines-starter.md +275 -0
- devkit/skills/embedded/break-ui/CATALOG.md +135 -0
- devkit/skills/embedded/break-ui/SKILL.md +175 -0
- devkit/skills/embedded/chrome-devtools/SKILL.md +74 -0
- devkit/skills/embedded/deploy-to-vercel/Archive.zip +0 -0
- devkit/skills/embedded/deploy-to-vercel/SKILL.md +296 -0
- devkit/skills/embedded/deploy-to-vercel/resources/deploy-codex.sh +301 -0
- devkit/skills/embedded/deploy-to-vercel/resources/deploy.sh +301 -0
- devkit/skills/embedded/design/SKILL.md +333 -0
- devkit/skills/embedded/design/data/cip/deliverables.csv +51 -0
- devkit/skills/embedded/design/data/cip/industries.csv +21 -0
- devkit/skills/embedded/design/data/cip/mockup-contexts.csv +21 -0
- devkit/skills/embedded/design/data/cip/styles.csv +21 -0
- devkit/skills/embedded/design/data/icon/styles.csv +16 -0
- devkit/skills/embedded/design/data/logo/colors.csv +56 -0
- devkit/skills/embedded/design/data/logo/industries.csv +56 -0
- devkit/skills/embedded/design/data/logo/styles.csv +56 -0
- devkit/skills/embedded/design/references/banner-sizes-and-styles.md +118 -0
- devkit/skills/embedded/design/references/cip-deliverable-guide.md +95 -0
- devkit/skills/embedded/design/references/cip-design.md +123 -0
- devkit/skills/embedded/design/references/cip-prompt-engineering.md +84 -0
- devkit/skills/embedded/design/references/cip-style-guide.md +68 -0
- devkit/skills/embedded/design/references/design-routing.md +207 -0
- devkit/skills/embedded/design/references/icon-design.md +122 -0
- devkit/skills/embedded/design/references/logo-color-psychology.md +101 -0
- devkit/skills/embedded/design/references/logo-design.md +110 -0
- devkit/skills/embedded/design/references/logo-prompt-engineering.md +158 -0
- devkit/skills/embedded/design/references/logo-style-guide.md +109 -0
- devkit/skills/embedded/design/references/slides-copywriting-formulas.md +84 -0
- devkit/skills/embedded/design/references/slides-create.md +4 -0
- devkit/skills/embedded/design/references/slides-html-template.md +295 -0
- devkit/skills/embedded/design/references/slides-layout-patterns.md +137 -0
- devkit/skills/embedded/design/references/slides-strategies.md +94 -0
- devkit/skills/embedded/design/references/slides.md +42 -0
- devkit/skills/embedded/design/references/social-photos-design.md +329 -0
- devkit/skills/embedded/design/scripts/cip/core.py +215 -0
- devkit/skills/embedded/design/scripts/cip/generate.py +504 -0
- devkit/skills/embedded/design/scripts/cip/render-html.py +424 -0
- devkit/skills/embedded/design/scripts/cip/search.py +127 -0
- devkit/skills/embedded/design/scripts/icon/generate.py +535 -0
- devkit/skills/embedded/design/scripts/logo/core.py +175 -0
- devkit/skills/embedded/design/scripts/logo/generate.py +812 -0
- devkit/skills/embedded/design/scripts/logo/search.py +114 -0
- devkit/skills/embedded/design/scripts/logo/tests/test_generate.py +454 -0
- devkit/skills/embedded/design/scripts/tests/test_cip_generate.py +134 -0
- devkit/skills/embedded/design/scripts/tests/test_icon_generate.py +178 -0
- devkit/skills/embedded/design-system/SKILL.md +248 -0
- devkit/skills/embedded/design-system/data/slide-backgrounds.csv +11 -0
- devkit/skills/embedded/design-system/data/slide-charts.csv +26 -0
- devkit/skills/embedded/design-system/data/slide-color-logic.csv +14 -0
- devkit/skills/embedded/design-system/data/slide-copy.csv +26 -0
- devkit/skills/embedded/design-system/data/slide-layout-logic.csv +16 -0
- devkit/skills/embedded/design-system/data/slide-layouts.csv +26 -0
- devkit/skills/embedded/design-system/data/slide-strategies.csv +16 -0
- devkit/skills/embedded/design-system/data/slide-typography.csv +15 -0
- devkit/skills/embedded/design-system/references/component-specs.md +236 -0
- devkit/skills/embedded/design-system/references/component-tokens.md +214 -0
- devkit/skills/embedded/design-system/references/primitive-tokens.md +203 -0
- devkit/skills/embedded/design-system/references/semantic-tokens.md +215 -0
- devkit/skills/embedded/design-system/references/states-and-variants.md +241 -0
- devkit/skills/embedded/design-system/references/tailwind-integration.md +251 -0
- devkit/skills/embedded/design-system/references/token-architecture.md +224 -0
- devkit/skills/embedded/design-system/scripts/embed-tokens.cjs +103 -0
- devkit/skills/embedded/design-system/scripts/fetch-background.py +339 -0
- devkit/skills/embedded/design-system/scripts/generate-slide.py +770 -0
- devkit/skills/embedded/design-system/scripts/generate-tokens.cjs +205 -0
- devkit/skills/embedded/design-system/scripts/html-token-validator.py +359 -0
- devkit/skills/embedded/design-system/scripts/search-slides.py +228 -0
- devkit/skills/embedded/design-system/scripts/slide-token-validator.py +35 -0
- devkit/skills/embedded/design-system/scripts/slide_search_core.py +453 -0
- devkit/skills/embedded/design-system/scripts/tests/test_validate_tokens.py +52 -0
- devkit/skills/embedded/design-system/scripts/validate-tokens.cjs +246 -0
- devkit/skills/embedded/design-system/templates/design-tokens-starter.json +143 -0
- devkit/skills/embedded/design-taste-frontend/README.md +81 -0
- devkit/skills/embedded/design-taste-frontend/SKILL.md +542 -0
- devkit/skills/embedded/design-taste-frontend/assets/app.css +216 -0
- devkit/skills/embedded/design-taste-frontend/assets/base.css +105 -0
- devkit/skills/embedded/design-taste-frontend/assets/base.js +37 -0
- devkit/skills/embedded/design-taste-frontend/assets/charts.js +619 -0
- devkit/skills/embedded/design-taste-frontend/assets/scenes/stage.css +28 -0
- devkit/skills/embedded/design-taste-frontend/assets/scenes/stage.js +134 -0
- devkit/skills/embedded/design-taste-frontend/evals/evals.json +76 -0
- devkit/skills/embedded/design-taste-frontend/library/app.json +1327 -0
- devkit/skills/embedded/design-taste-frontend/library/directions.json +1078 -0
- devkit/skills/embedded/design-taste-frontend/library/heroes.json +1086 -0
- devkit/skills/embedded/design-taste-frontend/library/motions.json +92 -0
- devkit/skills/embedded/design-taste-frontend/library/palettes.json +1485 -0
- devkit/skills/embedded/design-taste-frontend/library/photos.json +7240 -0
- devkit/skills/embedded/design-taste-frontend/library/sections.json +4429 -0
- devkit/skills/embedded/design-taste-frontend/library/sites.json +8350 -0
- devkit/skills/embedded/design-taste-frontend/library/type.json +2024 -0
- devkit/skills/embedded/design-taste-frontend/references/app-screens.md +1199 -0
- devkit/skills/embedded/design-taste-frontend/references/colour.md +141 -0
- devkit/skills/embedded/design-taste-frontend/references/copy.md +177 -0
- devkit/skills/embedded/design-taste-frontend/references/critique.md +182 -0
- devkit/skills/embedded/design-taste-frontend/references/imagery.md +791 -0
- devkit/skills/embedded/design-taste-frontend/references/layout.md +292 -0
- devkit/skills/embedded/design-taste-frontend/references/motion.md +980 -0
- devkit/skills/embedded/design-taste-frontend/references/research.md +356 -0
- devkit/skills/embedded/design-taste-frontend/references/scenes.md +174 -0
- devkit/skills/embedded/design-taste-frontend/references/tells.md +115 -0
- devkit/skills/embedded/design-taste-frontend/references/type.md +170 -0
- devkit/skills/embedded/design-taste-frontend/scripts/assets.mjs +865 -0
- devkit/skills/embedded/design-taste-frontend/scripts/draw.mjs +584 -0
- devkit/skills/embedded/design-taste-frontend/scripts/inspect.mjs +308 -0
- devkit/skills/embedded/design-taste-frontend/scripts/lib/app-draw.mjs +203 -0
- devkit/skills/embedded/design-taste-frontend/scripts/lib/cdp.mjs +248 -0
- devkit/skills/embedded/design-taste-frontend/scripts/lib/inspection-files.mjs +9 -0
- devkit/skills/embedded/design-taste-frontend/scripts/lib/probe.mjs +929 -0
- devkit/skills/embedded/design-taste-frontend/scripts/lib/rules.mjs +243 -0
- devkit/skills/embedded/design-taste-frontend/scripts/lint.mjs +119 -0
- devkit/skills/embedded/design-taste-frontend/scripts/scenes.mjs +124 -0
- devkit/skills/embedded/emil-design-eng/SKILL.md +674 -0
- devkit/skills/embedded/find-animation-opportunities/SKILL.md +140 -0
- devkit/skills/embedded/gemini-api-dev/SKILL.md +458 -0
- devkit/skills/embedded/gemini-api-dev/references/migration.md +180 -0
- devkit/skills/embedded/impeccable/SKILL.md +86 -0
- devkit/skills/embedded/impeccable/agents/impeccable_asset_producer.toml +47 -0
- devkit/skills/embedded/impeccable/agents/impeccable_documenter.toml +27 -0
- devkit/skills/embedded/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
- devkit/skills/embedded/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
- devkit/skills/embedded/impeccable/agents/openai.yaml +4 -0
- devkit/skills/embedded/impeccable/reference/adapt.md +318 -0
- devkit/skills/embedded/impeccable/reference/adapt.native.md +58 -0
- devkit/skills/embedded/impeccable/reference/android.md +46 -0
- devkit/skills/embedded/impeccable/reference/animate.md +89 -0
- devkit/skills/embedded/impeccable/reference/audit.md +139 -0
- devkit/skills/embedded/impeccable/reference/audit.native.md +139 -0
- devkit/skills/embedded/impeccable/reference/bolder.md +33 -0
- devkit/skills/embedded/impeccable/reference/clarify.md +94 -0
- devkit/skills/embedded/impeccable/reference/colorize.md +86 -0
- devkit/skills/embedded/impeccable/reference/component-review.md +63 -0
- devkit/skills/embedded/impeccable/reference/craft-floor.md +50 -0
- devkit/skills/embedded/impeccable/reference/craft.md +5 -0
- devkit/skills/embedded/impeccable/reference/critique.md +841 -0
- devkit/skills/embedded/impeccable/reference/degraded/asset-producer.md +44 -0
- devkit/skills/embedded/impeccable/reference/degraded/documenter.md +24 -0
- devkit/skills/embedded/impeccable/reference/degraded/finish-reviewer.md +38 -0
- devkit/skills/embedded/impeccable/reference/degraded/manual-edit-applier.md +92 -0
- devkit/skills/embedded/impeccable/reference/delight.md +70 -0
- devkit/skills/embedded/impeccable/reference/distill.md +111 -0
- devkit/skills/embedded/impeccable/reference/doctor.md +54 -0
- devkit/skills/embedded/impeccable/reference/document.md +416 -0
- devkit/skills/embedded/impeccable/reference/extract.md +69 -0
- devkit/skills/embedded/impeccable/reference/generate.md +101 -0
- devkit/skills/embedded/impeccable/reference/harden.md +362 -0
- devkit/skills/embedded/impeccable/reference/hooks.md +113 -0
- devkit/skills/embedded/impeccable/reference/init.md +131 -0
- devkit/skills/embedded/impeccable/reference/ios.md +51 -0
- devkit/skills/embedded/impeccable/reference/layout.md +84 -0
- devkit/skills/embedded/impeccable/reference/live-setup.md +104 -0
- devkit/skills/embedded/impeccable/reference/live.md +327 -0
- devkit/skills/embedded/impeccable/reference/mode-operate.md +21 -0
- devkit/skills/embedded/impeccable/reference/mode-persuade.md +19 -0
- devkit/skills/embedded/impeccable/reference/mode-read.md +21 -0
- devkit/skills/embedded/impeccable/reference/new-work.md +152 -0
- devkit/skills/embedded/impeccable/reference/onboard.md +234 -0
- devkit/skills/embedded/impeccable/reference/operate.md +61 -0
- devkit/skills/embedded/impeccable/reference/optimize.md +257 -0
- devkit/skills/embedded/impeccable/reference/overdrive.md +127 -0
- devkit/skills/embedded/impeccable/reference/polish.md +105 -0
- devkit/skills/embedded/impeccable/reference/quieter.md +99 -0
- devkit/skills/embedded/impeccable/reference/region-map.md +26 -0
- devkit/skills/embedded/impeccable/reference/routing.md +24 -0
- devkit/skills/embedded/impeccable/reference/shape.md +59 -0
- devkit/skills/embedded/impeccable/reference/typeset.md +90 -0
- devkit/skills/embedded/impeccable/reference/visualize.md +47 -0
- devkit/skills/embedded/impeccable/scripts/VERSION +1 -0
- devkit/skills/embedded/impeccable/scripts/command-metadata.json +98 -0
- devkit/skills/embedded/impeccable/scripts/data/font-index-failures.json +121 -0
- devkit/skills/embedded/impeccable/scripts/data/font-index.json +1 -0
- devkit/skills/embedded/impeccable/scripts/impeccable +213 -0
- devkit/skills/embedded/impeccable/scripts/impeccable.cmd +239 -0
- devkit/skills/embedded/impeccable/scripts/live-browser-dom.js +320 -0
- devkit/skills/embedded/impeccable/scripts/live-browser-ignores.js +246 -0
- devkit/skills/embedded/impeccable/scripts/live-browser-session.js +183 -0
- devkit/skills/embedded/impeccable/scripts/live-browser.js +13645 -0
- devkit/skills/embedded/impeccable/scripts/modern-screenshot.umd.js +14 -0
- devkit/skills/embedded/improve-animations/AUDIT.md +115 -0
- devkit/skills/embedded/improve-animations/PLAN-TEMPLATE.md +73 -0
- devkit/skills/embedded/improve-animations/SKILL.md +109 -0
- devkit/skills/embedded/mobile-native/SKILL.md +311 -0
- devkit/skills/embedded/modern-web-guidance/SKILL.md +135 -0
- devkit/skills/embedded/pick-ui-library/SKILL.md +85 -0
- devkit/skills/embedded/ponytail/SKILL.md +52 -0
- devkit/skills/embedded/ponytail-audit/SKILL.md +103 -0
- devkit/skills/embedded/ponytail-debt/SKILL.md +44 -0
- devkit/skills/embedded/ponytail-gain/SKILL.md +52 -0
- devkit/skills/embedded/ponytail-help/SKILL.md +76 -0
- devkit/skills/embedded/ponytail-review/SKILL.md +101 -0
- devkit/skills/embedded/prototype/PICKER.md +197 -0
- devkit/skills/embedded/prototype/SKILL.md +98 -0
- devkit/skills/embedded/review-animations/SKILL.md +120 -0
- devkit/skills/embedded/review-animations/STANDARDS.md +187 -0
- devkit/skills/embedded/skills-lock.json +239 -0
- devkit/skills/embedded/slides/SKILL.md +44 -0
- devkit/skills/embedded/slides/references/copywriting-formulas.md +84 -0
- devkit/skills/embedded/slides/references/create.md +4 -0
- devkit/skills/embedded/slides/references/html-template.md +295 -0
- devkit/skills/embedded/slides/references/layout-patterns.md +137 -0
- devkit/skills/embedded/slides/references/slide-strategies.md +94 -0
- devkit/skills/embedded/ui-styling/LICENSE.txt +202 -0
- devkit/skills/embedded/ui-styling/SKILL.md +336 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/ArsenalSC-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/ArsenalSC-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/BigShoulders-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/BigShoulders-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/BigShoulders-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Boldonse-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Boldonse-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/BricolageGrotesque-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-Italic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/DMMono-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/DMMono-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/EricaOne-OFL.txt +94 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/EricaOne-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/GeistMono-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/GeistMono-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/GeistMono-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Gloock-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Gloock-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexMono-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexMono-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexMono-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-BoldItalic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-Italic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSerif-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Italiana-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Italiana-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/JetBrainsMono-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/JetBrainsMono-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Jura-Light.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Jura-Medium.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Jura-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/LibreBaskerville-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/LibreBaskerville-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Lora-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Lora-BoldItalic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Lora-Italic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Lora-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Lora-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/NationalPark-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/NationalPark-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/NationalPark-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/NothingYouCouldDo-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Outfit-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Outfit-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Outfit-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/PixelifySans-Medium.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/PixelifySans-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/PoiretOne-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/PoiretOne-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/RedHatMono-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/RedHatMono-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/RedHatMono-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Silkscreen-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Silkscreen-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/SmoochSans-Medium.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/SmoochSans-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Tektur-Medium.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Tektur-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Tektur-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-BoldItalic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-Italic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/YoungSerif-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/YoungSerif-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/references/canvas-design-system.md +320 -0
- devkit/skills/embedded/ui-styling/references/shadcn-accessibility.md +471 -0
- devkit/skills/embedded/ui-styling/references/shadcn-components.md +424 -0
- devkit/skills/embedded/ui-styling/references/shadcn-theming.md +373 -0
- devkit/skills/embedded/ui-styling/references/tailwind-customization.md +483 -0
- devkit/skills/embedded/ui-styling/references/tailwind-responsive.md +382 -0
- devkit/skills/embedded/ui-styling/references/tailwind-utilities.md +455 -0
- devkit/skills/embedded/ui-styling/scripts/.coverage +0 -0
- devkit/skills/embedded/ui-styling/scripts/requirements.txt +17 -0
- devkit/skills/embedded/ui-styling/scripts/shadcn_add.py +308 -0
- devkit/skills/embedded/ui-styling/scripts/tailwind_config_gen.py +508 -0
- devkit/skills/embedded/ui-styling/scripts/tests/coverage-ui.json +1 -0
- devkit/skills/embedded/ui-styling/scripts/tests/requirements.txt +3 -0
- devkit/skills/embedded/ui-styling/scripts/tests/test_shadcn_add.py +266 -0
- devkit/skills/embedded/ui-styling/scripts/tests/test_tailwind_config_gen.py +508 -0
- devkit/skills/embedded/ui-ux-pro-max/SKILL.md +214 -0
- devkit/skills/embedded/ui-ux-pro-max/data/app-interface.csv +33 -0
- devkit/skills/embedded/ui-ux-pro-max/data/catalog-summary.json +78 -0
- devkit/skills/embedded/ui-ux-pro-max/data/charts.csv +26 -0
- devkit/skills/embedded/ui-ux-pro-max/data/colors.csv +193 -0
- devkit/skills/embedded/ui-ux-pro-max/data/data-provenance.json +1348 -0
- devkit/skills/embedded/ui-ux-pro-max/data/google-font-licenses.json +20185 -0
- devkit/skills/embedded/ui-ux-pro-max/data/google-fonts.csv +1935 -0
- devkit/skills/embedded/ui-ux-pro-max/data/icons.csv +106 -0
- devkit/skills/embedded/ui-ux-pro-max/data/landing.csv +35 -0
- devkit/skills/embedded/ui-ux-pro-max/data/motion.csv +18 -0
- devkit/skills/embedded/ui-ux-pro-max/data/phosphor-icons-upstream.json +32582 -0
- devkit/skills/embedded/ui-ux-pro-max/data/products.csv +193 -0
- devkit/skills/embedded/ui-ux-pro-max/data/react-performance.csv +45 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/angular.csv +51 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/astro.csv +54 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/avalonia.csv +57 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/html-tailwind.csv +60 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/javafx.csv +76 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/laravel.csv +51 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/nextjs.csv +62 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/nuxt-ui.csv +77 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/nuxtjs.csv +68 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/react.csv +67 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/shadcn.csv +69 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/svelte.csv +56 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/threejs.csv +54 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/uno.csv +60 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/uwp.csv +56 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/vue.csv +50 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/winui.csv +60 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/wpf.csv +57 -0
- devkit/skills/embedded/ui-ux-pro-max/data/styles.csv +89 -0
- devkit/skills/embedded/ui-ux-pro-max/data/typography.csv +75 -0
- devkit/skills/embedded/ui-ux-pro-max/data/ui-reasoning.csv +193 -0
- devkit/skills/embedded/ui-ux-pro-max/data/ux-guidelines.csv +120 -0
- devkit/skills/embedded/ui-ux-pro-max/references/pro-rules.md +117 -0
- devkit/skills/embedded/ui-ux-pro-max/references/quick-reference.md +256 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/core.py +993 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/design_system.py +1668 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/reasoning_contract.py +123 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/search.py +177 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-api.json +36 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-catalog.json +33 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-existing.csv +3 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-metadata.json +17 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-overrides.json +7 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/icons-curated.csv +4 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-core.json +23 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-package.json +13 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-exports.json +4 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-package.json +5 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/relevance-baseline.json +3366 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/relevance-cases.json +111 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/relevance-thresholds.json +100 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_catalog_refresh.py +354 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_catalog_summary_line_endings.py +78 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_core.py +343 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_core_data_quality.py +198 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_data_contracts.py +421 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_design_system_mode.py +233 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_design_system_stack.py +61 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_native_desktop_stack_freshness.py +179 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_relevance_evaluator.py +182 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_skill_script_paths.py +82 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_style_taxonomy.py +175 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_text_layout_resilience.py +120 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_web_stack_freshness.py +177 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/validate_data.py +1095 -0
- devkit/skills/embedded/vercel-cli-with-tokens/SKILL.md +353 -0
- devkit/skills/embedded/vercel-composition-patterns/AGENTS.md +946 -0
- devkit/skills/embedded/vercel-composition-patterns/README.md +60 -0
- devkit/skills/embedded/vercel-composition-patterns/SKILL.md +89 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/_sections.md +29 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/_template.md +24 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/react19-no-forwardref.md +42 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/state-context-interface.md +191 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/state-lift-state.md +125 -0
- devkit/skills/embedded/vercel-optimize/AGENTS.md +48 -0
- devkit/skills/embedded/vercel-optimize/CONTRIBUTING.md +41 -0
- devkit/skills/embedded/vercel-optimize/README.md +91 -0
- devkit/skills/embedded/vercel-optimize/SKILL.md +322 -0
- devkit/skills/embedded/vercel-optimize/lib/auth-route.mjs +23 -0
- devkit/skills/embedded/vercel-optimize/lib/budget-summary.mjs +182 -0
- devkit/skills/embedded/vercel-optimize/lib/citations.mjs +139 -0
- devkit/skills/embedded/vercel-optimize/lib/cost-coverage.mjs +143 -0
- devkit/skills/embedded/vercel-optimize/lib/dedup-recs.mjs +325 -0
- devkit/skills/embedded/vercel-optimize/lib/deep-dive.mjs +350 -0
- devkit/skills/embedded/vercel-optimize/lib/display-labels.mjs +185 -0
- devkit/skills/embedded/vercel-optimize/lib/extract-claims.mjs +550 -0
- devkit/skills/embedded/vercel-optimize/lib/framework-support.mjs +67 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/build-minutes-fanout.mjs +69 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/cold-start.mjs +66 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/contract.mjs +79 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/cwv-poor.mjs +87 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/external-api-slow.mjs +55 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/hard-gates.mjs +73 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/index.mjs +45 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/isr-overrevalidation.mjs +62 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/middleware-heavy.mjs +51 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/observability-events-attribution.mjs +56 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/platform-bot-protection.mjs +115 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/platform-fluid-compute.mjs +83 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/region-misconfig.mjs +64 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/route-errors.mjs +80 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/scanner-driven.mjs +122 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/select-candidates.mjs +134 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/slow-route.mjs +88 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/types.d.ts +38 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/uncached-route.mjs +93 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/usage-spike-triage.mjs +121 -0
- devkit/skills/embedded/vercel-optimize/lib/grade-recommendation.mjs +155 -0
- devkit/skills/embedded/vercel-optimize/lib/impact-label.mjs +126 -0
- devkit/skills/embedded/vercel-optimize/lib/impact-magnitude.mjs +60 -0
- devkit/skills/embedded/vercel-optimize/lib/investigation-brief.mjs +610 -0
- devkit/skills/embedded/vercel-optimize/lib/observation-safety.mjs +174 -0
- devkit/skills/embedded/vercel-optimize/lib/project-facts.mjs +99 -0
- devkit/skills/embedded/vercel-optimize/lib/queries.mjs +315 -0
- devkit/skills/embedded/vercel-optimize/lib/reconcile-candidates.mjs +372 -0
- devkit/skills/embedded/vercel-optimize/lib/render-report.mjs +955 -0
- devkit/skills/embedded/vercel-optimize/lib/repo-root.mjs +86 -0
- devkit/skills/embedded/vercel-optimize/lib/route-normalize.mjs +220 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/bot-protection-certainty.mjs +38 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/cache-tag-invalidation-certainty.mjs +30 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/count-correct.mjs +52 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/function-duration-invocations.mjs +38 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/index.mjs +79 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/middleware-conflict.mjs +36 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/missing-citation.mjs +16 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/pre-release.mjs +74 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/rate-limit.mjs +67 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/rendering-mode-mislabel.mjs +38 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/undeclared-dep.mjs +78 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/vercel-directive-strip.mjs +37 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/window-units.mjs +32 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/cache-components-suspense-dedupe.mjs +109 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/edge-heavy-import.mjs +94 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/force-dynamic.mjs +42 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/headers-in-page.mjs +44 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/index.mjs +35 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/large-static-asset.mjs +92 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/max-age-without-s-maxage.mjs +42 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/middleware-broad-matcher.mjs +55 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/missing-cache-headers.mjs +90 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/prisma-include-tree.mjs +42 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/region-pin-in-config.mjs +88 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/source-maps-production.mjs +36 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/sveltekit-prerender-missing.mjs +43 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/turbo-force-bypass.mjs +129 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/unoptimized-image.mjs +113 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/use-cache-date-stamp.mjs +106 -0
- devkit/skills/embedded/vercel-optimize/lib/support-topics.mjs +355 -0
- devkit/skills/embedded/vercel-optimize/lib/throttle.mjs +273 -0
- devkit/skills/embedded/vercel-optimize/lib/util.mjs +17 -0
- devkit/skills/embedded/vercel-optimize/lib/vercel.mjs +864 -0
- devkit/skills/embedded/vercel-optimize/lib/verify-claim.mjs +1296 -0
- devkit/skills/embedded/vercel-optimize/lib/workspace-resolver.mjs +521 -0
- devkit/skills/embedded/vercel-optimize/references/candidates.md +176 -0
- devkit/skills/embedded/vercel-optimize/references/data-collection.md +218 -0
- devkit/skills/embedded/vercel-optimize/references/docs-library.json +683 -0
- devkit/skills/embedded/vercel-optimize/references/doctrine.md +105 -0
- devkit/skills/embedded/vercel-optimize/references/observability-plus.md +108 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/README.md +53 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/ai-application.md +32 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/api-service.md +30 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/content-site.md +30 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/ecommerce.md +30 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/marketing.md +30 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/saas.md +31 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/sveltekit.md +75 -0
- devkit/skills/embedded/vercel-optimize/references/recommendations.md +203 -0
- devkit/skills/embedded/vercel-optimize/references/scanner-patterns.md +251 -0
- devkit/skills/embedded/vercel-optimize/references/scoring.md +205 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/README.md +46 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/astro-edge-middleware-scope.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/astro-output-mode-and-isr.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/auth-preserving-parallelization.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/bot-protection-product-guardrails.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/build-minutes-monorepo-fanout.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/cache-components-static-shell-boundaries.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/cache-components-suspense-dedupe-pitfall.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/cdn-cache-auth-safety.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/cold-start-initialization-bundle.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/core-web-vitals-client-bottlenecks.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/database-egress-pooling-region.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/dynamic-rendering-traps.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/external-api-critical-path-platform.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/external-api-critical-path.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/fast-data-transfer-payloads.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/fluid-compute-caveats.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/function-duration-io-and-after.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/function-invocation-reduction.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/function-region-misconfiguration-ttfb.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/image-optimization-cost-control.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/isr-revalidation-static-generation.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/middleware-proxy-edge-cost.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/next-fetch-revalidate-floor.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/next-font-cls-self-hosting.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/next-heavy-ui-lazy-load-boundaries.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/next-image-lcp-preload-sizes.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/next-route-handler-get-cache-defaults.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/next-script-third-party-strategy.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/nextjs-version-cache-semantics.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/not-found-catchall-request-waste.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/nuxt-route-rules-cache-isr.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/observability-events-cost-attribution.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/post-response-work-waituntil.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/route-error-durable-offload.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/route-error-runtime-limits.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/runtime-cache-reusable-data.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/sveltekit-isr-prerender-safety.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/sveltekit-split-cold-start-tradeoff.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/usage-spike-triage.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/use-cache-date-stamp-isr-write-amplifier.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/use-cache-remote-shared-origin-data.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/workflow-resumable-stream-routes.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/verification.md +102 -0
- devkit/skills/embedded/vercel-optimize/references/voice.md +76 -0
- devkit/skills/embedded/vercel-optimize/scripts/budget-summary.mjs +56 -0
- devkit/skills/embedded/vercel-optimize/scripts/build-docs.mjs +74 -0
- devkit/skills/embedded/vercel-optimize/scripts/check-citations.mjs +81 -0
- devkit/skills/embedded/vercel-optimize/scripts/check-docs-fresh.mjs +93 -0
- devkit/skills/embedded/vercel-optimize/scripts/collect-signals.mjs +576 -0
- devkit/skills/embedded/vercel-optimize/scripts/collect-sub-agent-outputs.mjs +296 -0
- devkit/skills/embedded/vercel-optimize/scripts/deep-dive.mjs +319 -0
- devkit/skills/embedded/vercel-optimize/scripts/gate-investigations.mjs +166 -0
- devkit/skills/embedded/vercel-optimize/scripts/merge-signals.mjs +192 -0
- devkit/skills/embedded/vercel-optimize/scripts/prepare-investigation-brief.mjs +231 -0
- devkit/skills/embedded/vercel-optimize/scripts/reconcile-candidates.mjs +62 -0
- devkit/skills/embedded/vercel-optimize/scripts/render-report.mjs +437 -0
- devkit/skills/embedded/vercel-optimize/scripts/scan-codebase.mjs +313 -0
- devkit/skills/embedded/vercel-optimize/scripts/verify-and-regen.mjs +346 -0
- devkit/skills/embedded/vercel-optimize/scripts/verify-finding.mjs +19 -0
- devkit/skills/embedded/vercel-react-best-practices/AGENTS.md +3810 -0
- devkit/skills/embedded/vercel-react-best-practices/README.md +123 -0
- devkit/skills/embedded/vercel-react-best-practices/SKILL.md +149 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/_sections.md +46 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/_template.md +28 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/async-api-routes.md +38 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/async-defer-await.md +82 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/async-dependencies.md +51 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/async-parallel.md +28 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/bundle-preload.md +50 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-early-exit.md +50 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-index-maps.md +37 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-activity.md +26 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-memo.md +44 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-cache-react.md +76 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-serialization.md +38 -0
- devkit/skills/embedded/vercel-react-native-skills/AGENTS.md +2897 -0
- devkit/skills/embedded/vercel-react-native-skills/README.md +165 -0
- devkit/skills/embedded/vercel-react-native-skills/SKILL.md +121 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/_sections.md +86 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/_template.md +28 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-images.md +53 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-menus.md +174 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-pressable.md +61 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-styling.md +87 -0
- devkit/skills/embedded/vercel-react-view-transitions/AGENTS.md +1380 -0
- devkit/skills/embedded/vercel-react-view-transitions/README.md +44 -0
- devkit/skills/embedded/vercel-react-view-transitions/SKILL.md +332 -0
- devkit/skills/embedded/vercel-react-view-transitions/references/css-recipes.md +312 -0
- devkit/skills/embedded/vercel-react-view-transitions/references/implementation.md +170 -0
- devkit/skills/embedded/vercel-react-view-transitions/references/nextjs.md +233 -0
- devkit/skills/embedded/vercel-react-view-transitions/references/patterns.md +274 -0
- devkit/skills/embedded/vercel-react-view-transitions/references/troubleshooting.md +47 -0
- devkit/skills/embedded/web-design-guidelines/SKILL.md +39 -0
- devkit/skills/embedded/write-swift/SKILL.md +396 -0
- devkit/skills/embedded/writing-guidelines/SKILL.md +39 -0
- devkit/skills/installer.py +110 -0
- devkit/templates/__init__.py +76 -0
- devkit/templates/ai_agents_python.py +160 -0
- devkit/templates/base.py +37 -0
- devkit/templates/content_site.py +117 -0
- devkit/templates/custom.py +129 -0
- devkit/templates/design_system.py +167 -0
- devkit/templates/expo_fullstack.py +278 -0
- devkit/templates/expo_mobile.py +127 -0
- devkit/templates/minimal_agentic.py +34 -0
- devkit/templates/nextjs.py +219 -0
- devkit/templates/python_fastapi.py +125 -0
- devkit/templates/saas_fullstack.py +212 -0
- devkit/templates/vite_react.py +176 -0
- devkit/ui.py +61 -0
- devkit/utils/__init__.py +15 -0
- devkit/utils/system.py +48 -0
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
# Type
|
|
2
|
+
|
|
3
|
+
Typography is most of what a visitor sees and most of what makes a page look designed or assembled.
|
|
4
|
+
The direction sheet deals you a type system (faces, weights, settings). This file is how to use it.
|
|
5
|
+
|
|
6
|
+
## Contents
|
|
7
|
+
|
|
8
|
+
1. What the study measured
|
|
9
|
+
2. The scale: few sizes, far apart
|
|
10
|
+
3. Setting display type
|
|
11
|
+
4. Setting text
|
|
12
|
+
5. Loading the fonts properly
|
|
13
|
+
6. One family or two
|
|
14
|
+
7. Details that separate set type from typed text
|
|
15
|
+
8. Mistakes the inspector cannot see
|
|
16
|
+
|
|
17
|
+
## 1. What the study measured
|
|
18
|
+
|
|
19
|
+
From 202 measurable sites out of the 247 studied (Chrome, 1440×900 and 390×844):
|
|
20
|
+
|
|
21
|
+
| | Median | Middle half | Note |
|
|
22
|
+
| --- | --- | --- | --- |
|
|
23
|
+
| Hero headline size | 72px (5.0vw) | 43–109px | Top-scored sites: 6.0vw median |
|
|
24
|
+
| Largest type on the page | 6.4vw | up to 10.4vw | Top-scored sites 8.4vw, weak sites 5.0vw |
|
|
25
|
+
| Hero headline on a phone | 40px | 32–59px | |
|
|
26
|
+
| Hero tracking | -0.01em | -0.03 to 0 | Tighter as size grows |
|
|
27
|
+
| Hero leading | 1.0 | 0.95–1.1 | |
|
|
28
|
+
| Body size | 16px | 14–18px | |
|
|
29
|
+
| Headline ÷ body size | 4.3 | | Top-scored sites 4.7 |
|
|
30
|
+
| Typefaces in real use | 2 | 31% use one, 45% two, 22% three | |
|
|
31
|
+
| Hero weight | regular 48%, medium 18%, bold or heavier 22% | | Big type does not need to be bold |
|
|
32
|
+
| Hero in capitals | 24% | | |
|
|
33
|
+
| Hero centred | 39% | | 52% on the weak sites |
|
|
34
|
+
|
|
35
|
+
Two things to take from it. First, size contrast is the main lever and the best sites pull it harder.
|
|
36
|
+
Second, weight is not: half of the heroes are set in a regular weight. Scale and spacing make type
|
|
37
|
+
confident; bold is one option among several.
|
|
38
|
+
|
|
39
|
+
## 2. The scale: few sizes, far apart
|
|
40
|
+
|
|
41
|
+
The panel described about 30 of the 114 strongest sites as using two or three type sizes with nothing
|
|
42
|
+
in between, and none as using a graded five- or six-step scale. So: one display size, one text size
|
|
43
|
+
and a small size carry the page; a lead size and a heading size exist for when they are needed. Five
|
|
44
|
+
is the ceiling. The common failure is nine sizes that are all near each other (16, 18, 20, 24, 28,
|
|
45
|
+
32…), which reads as mush. Choose steps that are clearly different:
|
|
46
|
+
|
|
47
|
+
```css
|
|
48
|
+
:root {
|
|
49
|
+
--step-small: clamp(0.8125rem, 0.79rem + 0.1vw, 0.875rem); /* 13–14px captions, legal */
|
|
50
|
+
--step-body: clamp(1.0625rem, 1rem + 0.25vw, 1.1875rem); /* 17–19px paragraphs */
|
|
51
|
+
--step-lead: clamp(1.25rem, 1.1rem + 0.7vw, 1.625rem); /* 20–26px supporting line, large body */
|
|
52
|
+
--step-head: clamp(2rem, 1.3rem + 3.2vw, 4rem); /* 32–64px section headings */
|
|
53
|
+
--step-display: clamp(3rem, 1rem + 9vw, 9rem); /* set by the hero blueprint */
|
|
54
|
+
}
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
- `--step-display` belongs to the direction. A monument wordmark is 16–24vw; a quiet instrument's
|
|
58
|
+
headline is 28px. Use the size the hero blueprint gives, as a `clamp()` so it scales with the
|
|
59
|
+
viewport but is bounded on phones and very wide screens.
|
|
60
|
+
- Keep the gap: the display size should be at least four times the body size on desktop, and nothing
|
|
61
|
+
should sit between `--step-lead` and `--step-head` unless the design truly needs a sixth size.
|
|
62
|
+
- Resist a "subheading" size for every card and label. If two sizes look almost the same, make them
|
|
63
|
+
the same.
|
|
64
|
+
|
|
65
|
+
## 3. Setting display type
|
|
66
|
+
|
|
67
|
+
Large type exposes spacing that is invisible at text size. Apply all of these to anything over 40px:
|
|
68
|
+
|
|
69
|
+
```css
|
|
70
|
+
.display {
|
|
71
|
+
font-size: var(--step-display);
|
|
72
|
+
line-height: 0.95; /* 0.85–1.05; tighter for capitals and condensed faces */
|
|
73
|
+
letter-spacing: -0.035em; /* -0.02 to -0.05em; use the value on the direction sheet */
|
|
74
|
+
font-kerning: normal;
|
|
75
|
+
text-wrap: balance;
|
|
76
|
+
max-width: 14ch; /* choose the measure so lines break where you want */
|
|
77
|
+
margin: 0;
|
|
78
|
+
}
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
- **Tracking scales with size.** The larger the type, the tighter it needs to be; a value right for
|
|
82
|
+
120px will choke 32px. Set tracking per step, not once for all headings.
|
|
83
|
+
- **Leading below 1.0 needs checking.** Look for collisions between descenders and the ascenders or
|
|
84
|
+
accents of the next line. Two-line headlines make this easy to verify by eye.
|
|
85
|
+
- **All capitals** want slightly open tracking (0 to +0.03em) even at display size, and leading around
|
|
86
|
+
0.9.
|
|
87
|
+
- **Optical alignment.** Big letters with round or diagonal left edges (O, C, A, T, W) look indented.
|
|
88
|
+
Pull the headline left by about 0.04–0.06em (`margin-left: -0.05em`) so it aligns optically with the
|
|
89
|
+
text beneath it.
|
|
90
|
+
- **Viewport-wide type.** For a line that must span the screen, size it in `vw` and verify at 390 and
|
|
91
|
+
1440; set `white-space: nowrap` and let the container clip rather than wrap. Calculate the size from
|
|
92
|
+
the character count: `font-size ≈ container width ÷ (characters × k)` with k from `copy.md` §2.
|
|
93
|
+
- Never add a text shadow, an outline stroke, or a gradient fill to display type.
|
|
94
|
+
|
|
95
|
+
## 4. Setting text
|
|
96
|
+
|
|
97
|
+
```css
|
|
98
|
+
body { font-size: var(--step-body); line-height: 1.5; font-kerning: normal; text-rendering: optimizeLegibility; }
|
|
99
|
+
p { max-width: 62ch; text-wrap: pretty; margin: 0; }
|
|
100
|
+
p + p { margin-top: 0.9em; }
|
|
101
|
+
.lead { font-size: var(--step-lead); line-height: 1.35; max-width: 40ch; }
|
|
102
|
+
small, .caption { font-size: var(--step-small); line-height: 1.45; }
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
- Measure: 45–75 characters. Wider than that and the eye loses the next line; the inspector warns
|
|
106
|
+
past about 88.
|
|
107
|
+
- Leading: 1.45–1.6 for body, tighter (1.3–1.4) for the larger lead size, looser for long reading.
|
|
108
|
+
- Secondary text is the same face in a softer ink (`--muted`), not a lighter weight and not smaller
|
|
109
|
+
than 13px.
|
|
110
|
+
- Do not centre paragraphs longer than three lines. Do not justify.
|
|
111
|
+
- Light text on a dark ground looks heavier: drop one weight step or add 0.01em tracking, and raise
|
|
112
|
+
leading slightly.
|
|
113
|
+
|
|
114
|
+
## 5. Loading the fonts properly
|
|
115
|
+
|
|
116
|
+
The sheet gives a `<link>` tag. Use it exactly; do not swap in a face you prefer.
|
|
117
|
+
|
|
118
|
+
```html
|
|
119
|
+
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
120
|
+
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
121
|
+
<link href="…from the direction sheet…" rel="stylesheet">
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
```css
|
|
125
|
+
:root {
|
|
126
|
+
--font-display: "Family From Sheet", "Helvetica Neue", Arial, sans-serif;
|
|
127
|
+
--font-text: "Family From Sheet", Georgia, serif;
|
|
128
|
+
}
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
- Request only the weights you use (usually two or three in total).
|
|
132
|
+
- Always give a fallback stack of the same broad kind (sans for sans, serif for serif).
|
|
133
|
+
- In a framework, use its font loader with the same family and weights (`next/font/google`, or a
|
|
134
|
+
self-hosted `@font-face` with `font-display: swap`). Fontshare faces load from the
|
|
135
|
+
`api.fontshare.com` stylesheet on the sheet.
|
|
136
|
+
- After building, `inspect.mjs` reports the families that actually rendered. If it warns that a face
|
|
137
|
+
did not load, the screenshots show a fallback and nothing you judge from them is real. Fix the link
|
|
138
|
+
first.
|
|
139
|
+
|
|
140
|
+
## 6. One family or two
|
|
141
|
+
|
|
142
|
+
A third of the studied sites use a single family for everything, and it is the safest way to look
|
|
143
|
+
coherent. When the dealt system has two faces:
|
|
144
|
+
|
|
145
|
+
- Give each a job and never swap them: one sets headlines, the other sets everything else.
|
|
146
|
+
- Do not introduce a third face for labels, numbers or quotes.
|
|
147
|
+
- Do not mix two faces inside one headline.
|
|
148
|
+
- Italic is for titles of works and real emphasis inside paragraphs, never as decoration.
|
|
149
|
+
|
|
150
|
+
## 7. Details that separate set type from typed text
|
|
151
|
+
|
|
152
|
+
- Curly quotes and apostrophes, real dashes, a real ellipsis (see `copy.md` §7).
|
|
153
|
+
- `font-variant-numeric: tabular-nums` for prices, tables, dates in columns; `oldstyle-nums` suits
|
|
154
|
+
serif body text.
|
|
155
|
+
- `text-underline-offset: 0.18em; text-decoration-thickness: 0.07em` on links, so underlines clear the
|
|
156
|
+
descenders.
|
|
157
|
+
- `hyphens: none` on headings. `overflow-wrap: anywhere` only on long URLs or emails.
|
|
158
|
+
- A heading belongs to the text after it: space above a heading is at least twice the space below.
|
|
159
|
+
- `::selection { background: var(--accent); color: var(--accent-ink); }` and a visible
|
|
160
|
+
`:focus-visible` outline in the accent, so even the browser's own states belong to the design.
|
|
161
|
+
- Do not change weight on hover; the line reflows.
|
|
162
|
+
|
|
163
|
+
## 8. Mistakes the inspector cannot see
|
|
164
|
+
|
|
165
|
+
- A headline that passes the two-line rule but breaks badly: one orphan word on line two, or a break
|
|
166
|
+
that splits a phrase ("Stools for small / kitchens"). Author the break.
|
|
167
|
+
- Display type so tight that letters touch, or so loose it falls apart.
|
|
168
|
+
- A confident hero followed by section headings almost as large. Keep one size dominant per screen.
|
|
169
|
+
- Body text set in the display face when that face was drawn for large sizes only.
|
|
170
|
+
- Everything bold. If every line is emphasised, none is.
|