planetscale
starsforks
How to install planetscale?
ihlamury/design-skills/planetscale
$npx -y skills add ihlamury/design-skills --skill planetscalePlanetscale's UI design system. Use when building interfaces inspired by Planetscale's aesthetic - dark mode, Inter font, 4px grid.
SKILL.md
| 1 | # Planetscale UI Skills |
| 2 | |
| 3 | Opinionated constraints for building Planetscale-style interfaces with AI agents. |
| 4 | |
| 5 | ## When to Apply |
| 6 | |
| 7 | Reference these guidelines when: |
| 8 | - Building dark-mode interfaces |
| 9 | - Creating Planetscale-inspired design systems |
| 10 | - Implementing UIs with Inter font and 4px grid |
| 11 | |
| 12 | ## Colors |
| 13 | |
| 14 | - MUST use dark backgrounds (lightness < 20) for primary surfaces - detected lightness: 0 |
| 15 | - MUST use `#000000` as page background (`surface-base`) |
| 16 | - MUST use `#7967D3` for primary actions and focus states (`accent`) |
| 17 | - SHOULD reduce color palette (currently 23 colors detected) |
| 18 | - MUST maintain text contrast ratio of at least 4.5:1 for accessibility |
| 19 | |
| 20 | ### Semantic Tokens |
| 21 | |
| 22 | | Token | HEX | RGB | Usage | |
| 23 | |-------|-----|-----|-------| |
| 24 | | `surface-base` | #000000 | rgb(0,0,0) | Page background | |
| 25 | | `surface-raised` | #F8F8F9 | rgb(248,248,249) | Cards, modals, raised surfaces | |
| 26 | | `surface-overlay` | #EC4011 | rgb(236,64,17) | Overlays, tooltips, dropdowns | |
| 27 | | `text-primary` | #202020 | rgb(32,32,32) | Headings, body text | |
| 28 | | `text-secondary` | #787878 | rgb(120,120,120) | Secondary, muted text | |
| 29 | | `text-tertiary` | #54565C | rgb(84,86,92) | Additional text | |
| 30 | | `border-default` | #D44927 | rgb(212,73,39) | Subtle borders, dividers | |
| 31 | | `destructive` | #EC4011 | rgb(236,64,17) | Error states, delete actions | |
| 32 | | `success` | #41D731 | rgb(65,215,49) | Success states, confirmations | |
| 33 | | `accent` | #7967D3 | rgb(121,103,211) | Primary actions, links, focus | |
| 34 | |
| 35 | ## Typography |
| 36 | |
| 37 | - MUST use `Inter` as primary font family |
| 38 | - SHOULD use single font family for consistency |
| 39 | - MUST use `51px` / `700` for primary headings |
| 40 | - MUST use `17px` / `400` for body text |
| 41 | - SHOULD reduce font weights (currently 5 detected) |
| 42 | - MUST use `text-balance` for headings and `text-pretty` for body text |
| 43 | - SHOULD use `tabular-nums` for numeric data |
| 44 | - NEVER modify letter-spacing unless explicitly requested |
| 45 | |
| 46 | ### Text Styles |
| 47 | |
| 48 | | Style | Font | Size | Weight | Color | Count | |
| 49 | |-------|------|------|--------|-------|-------| |
| 50 | | `heading-1` | Inter | 51px | 700 | #DF5C2E | 1 | |
| 51 | | `text-44px` | Inter | 44px | 700 | #36F91F | 1 | |
| 52 | | `text-40px` | Inter | 40px | extra_bold | #202020 | 1 | |
| 53 | | `text-39px` | Inter | 39px | extra_bold | #1A1A1A | 1 | |
| 54 | | `text-38px` | Inter | 38px | 700 | #1E1E1E | 1 | |
| 55 | | `text-35px` | Inter | 35px | extra_bold | #1D1D1D | 1 | |
| 56 | | `text-34px` | Inter | 34px | 700 | #1A1A1A | 1 | |
| 57 | | `text-31px` | Inter | 31px | 700 | #141414 | 1 | |
| 58 | | `text-30px` | Inter | 30px | 700 | #1A1A1A | 1 | |
| 59 | | `text-30px` | Inter | 30px | 400 | #D76B60 | 1 | |
| 60 | |
| 61 | ### Typography Reference |
| 62 | |
| 63 | **Font Families:** |
| 64 | - `Inter` (used 55x) |
| 65 | |
| 66 | **Font Sizes:** 11px, 12px, 13px, 14px, 15px, 16px, 17px, 18px, 21px, 22px, 23px, 24px, 25px, 26px, 29px, 30px, 31px, 34px, 35px, 38px, 39px, 40px, 44px, 51px |
| 67 | |
| 68 | ## Spacing |
| 69 | |
| 70 | - MUST use 4px grid for spacing |
| 71 | - SHOULD use spacing from scale: 3px, 4px, 5px, 6px, 7px, 25px, 28px, 32px |
| 72 | - SHOULD use 38px as default gap between elements |
| 73 | - NEVER use arbitrary spacing values (use design scale) |
| 74 | - SHOULD maintain consistent padding within containers |
| 75 | |
| 76 | ## Borders |
| 77 | |
| 78 | - MUST use 1px border width consistently |
| 79 | - NEVER use arbitrary border-radius values (use design scale) |
| 80 | - SHOULD use subtle borders (1px) for element separation |
| 81 | |
| 82 | ## Layout |
| 83 | |
| 84 | - MUST design for 1920px base viewport width |
| 85 | - SHOULD use consistent element widths: 220px, 221px, 2px, 30px, 1px |
| 86 | - SHOULD maintain text-heavy layout with clear hierarchy |
| 87 | - NEVER use `h-screen`, use `h-dvh` for full viewport height |
| 88 | - MUST respect `safe-area-inset` for fixed elements |
| 89 | - SHOULD use `size-*` for square elements instead of `w-*` + `h-*` |
| 90 | |
| 91 | ### Detected Layout Patterns |
| 92 | |
| 93 | - **Main Content**: width: 1920px, height: 1041px |
| 94 | - **Main Content**: width: 1114px, height: 664px |
| 95 | - **Main Content**: width: 1104px, height: 667px |
| 96 | - **Header**: height: 39px |
| 97 | |
| 98 | ## Components |
| 99 | |
| 100 | ### Buttons |
| 101 | |
| 102 | | Variant | Background | Text | Border | Height | Radius | |
| 103 | |---------|------------|------|--------|--------|--------| |
| 104 | | Ghost | transparent | #F0B095 | none | - | - | |
| 105 | |
| 106 | ## Interactive States |
| 107 | |
| 108 | ### Focus |
| 109 | |
| 110 | - MUST use `2px` outline with accent color (`#7967D3`) |
| 111 | - MUST use `2px` outline-offset |
| 112 | - NEVER remove focus indicators |
| 113 | |
| 114 | ### Hover |
| 115 | |
| 116 | - Buttons (primary): lighten background by 10% |
| 117 | - Buttons (secondary): use `#F8F8F9` background |
| 118 | - List items: use `#F8F8F9` background |
| 119 | |
| 120 | ### Disabled |
| 121 | |
| 122 | - MUST use `opacity: 0.5` |
| 123 | - MUST use `cursor: not-allowed` |
| 124 | |
| 125 | ## Interaction |
| 126 | |
| 127 | - MUST use an `AlertDialog` for destructive or irreversible actions |
| 128 | - SHOULD use structural skeletons for loading states |
| 129 | - MUST show errors next to where the action happens |
| 130 | - NEVER block paste in `input` or `textarea` elements |
| 131 | - MUST add an `aria-label` to icon-only buttons |
| 132 | |
| 133 | ## Animation |
| 134 | |
| 135 | - NEVER add animation unless it is explicitly requested |
| 136 | - MUST animat |
People who liked this also viewed
6 picksType
- azure-storageAzure Storage Services including Blob Storage, File Shares, Queue Storage, Table Storage, and Data Lake. Answers questions about storage access tiers (hot, cool, cold, archive), when to use each tier,SkillsJul 2026
- supabase-postgres-best-practicesPostgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.SkillsJul 2026
- supabaseUse when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, SkillsJul 2026
- convex-quickstartCreates or adds Convex to an app. Use for new Convex projects, npm create convex@latest, frontend setup, env vars, or the first npx convex dev run.SkillsJul 2026
- convex-performance-auditAudits Convex performance for reads, subscriptions, write contention, and function limits. Use for slow features, insights findings, OCC conflicts, or read amplification.SkillsJul 2026
- convex-setup-authSets up Convex auth, identity mapping, and access control. Use for login, auth providers, users tables, protected functions, or roles in a Convex app.SkillsJul 2026
