TikTok

# TikTok Design System — .cursorrules
# Generated by StyleExtract · styleextract.com/vault/tiktok

You are a senior frontend developer building UI that matches the TikTok design system exactly.
Read this entire file before writing any component.

## Brand Identity
Company    : TikTok
Primary    : #FE2C55
Secondary  : #010101
Accent     : #25F4EE
Font       : TikTok Sans, system-ui
Radius     : 4px
Voice      : Red-on-black with cyan — the short-video platform with maximum visual impact.

## CSS Custom Properties
```css
:root {
  --color-primary:   #FE2C55;
  --color-secondary: #010101;
  --color-accent:    #25F4EE;
  --color-text:      #FFFFFF;
  --color-surface:   #1C1C1E;
  --color-border:    #2C2C2E;
  --font-sans:       "TikTok Sans", system-ui, -apple-system, sans-serif;
  --radius:          4px;
}
```

## Tailwind Config
```js
// tailwind.config.js
module.exports = {
  theme: {
    extend: {
      colors: {
        primary:   "#FE2C55",
        secondary: "#010101",
        accent:    "#25F4EE",
      },
      fontFamily: {
        sans: ["TikTok Sans", "system-ui", "sans-serif"],
      },
      borderRadius: {
        brand: "4px",
      },
    },
  },
};
```

## Typography
```
heading-font:    TikTok Sans, system-ui
heading-weight:  700
heading-tracking: -0.02em
body-font:       TikTok Sans, system-ui
body-size:       16px
body-line-height: 1.6
```

## Spacing Scale
Base: 4px  |  Scale: 4 · 8 · 12 · 16 · 24 · 32 · 48 · 64 · 96px
Never use arbitrary values like 13px, 22px, or 50px.

## Component Rules

### Primary Button
background-color: #FE2C55
color: #FFFFFF
border-radius: 4px
padding: 12px 24px
font-weight: 600
font-size: 14px
transition: opacity 0.15s
&:hover { opacity: 0.88 }

### Secondary Button
background-color: transparent
border: 1.5px solid #FE2C55
color: #FE2C55
border-radius: 4px
padding: 11px 23px

### Card
background: #1C1C1E
border: 1px solid #2C2C2E
border-radius: 16px
padding: 24px
box-shadow: 0 1px 3px rgba(0,0,0,0.08)

### Navigation
background: #010101
color: #FFFFFF
height: 60px
padding: 0 24px
```

## Rules
DO:
- Use the exact hex values defined in CSS Custom Properties
- Maintain TikTok's aesthetic: Red-on-black with cyan — the short-video platform with maximum visual impact.
- Apply 4px base-unit spacing throughout
- Use TikTok Sans for all text elements
- Meet WCAG AA contrast (4.5:1 minimum for body text)

DON'T:
- Invent colors outside the defined palette
- Use system-default blue (#0000EE) for links — use var(--color-primary)
- Apply border-radius values not on the brand scale
- Use font-weight below 400 or above 900

---
brand:
  name: "TikTok"
  category: "Consumer & Media"
  primary: "#FE2C55"
  secondary: "#010101"
  accent: "#25F4EE"
typography:
  heading: "TikTok Sans, system-ui"
  headingWeight: 700
  headingTracking: "-0.02em"
  body: "TikTok Sans, system-ui"
  bodySize: "16px"
  lineHeight: 1.6
spacing:
  base: 4
  scale: [4, 8, 12, 16, 24, 32, 48, 64, 96]
shape:
  radiusSm: "4px"
  radiusMd: "4px"
  radiusLg: "16px"
  radiusXl: "24px"
---

# TikTok Design System
> AI Agent Context — read this entire file before generating any UI for TikTok
> Source: StyleExtract Vault · styleextract.com/vault/tiktok

## Brand Overview
Red-on-black with cyan — the short-video platform with maximum visual impact.

## Color System

| Role      | Hex       | Usage                          |
|-----------|-----------|-------------------------------|
| Primary   | `#FE2C55` | CTAs, links, key accents  |
| Secondary | `#010101` | Backgrounds, headings    |
| Accent    | `#25F4EE` | Highlights, badges, icons |
| Surface   | `#1C1C1E` | Card backgrounds |
| Border    | `#2C2C2E` | Dividers, outlines |

ALWAYS use `#FE2C55` for primary interactive elements and CTAs.
NEVER invent colors outside the palette above.

## Typography

- **Heading font**: TikTok Sans, system-ui
- **Heading weight**: 700 / letter-spacing −0.02em
- **Body font**: TikTok Sans, system-ui
- **Body size**: 16px / line-height 1.6

## Spacing System

Base unit is **4px**. Allowed values: 4, 8, 12, 16, 24, 32, 48, 64, 96px.
Never use arbitrary values.

## Component Patterns

### Buttons
```
Primary:   bg #FE2C55  · text #FFFFFF  · rounded-[4px]  · px-6 py-3  · font-semibold
Secondary: transparent    · border-[#FE2C55]       · text-[#FE2C55]      · px-6 py-3
```

### Cards
```
bg white (dark: #1C1C1E) · border #E5E5E7 (dark: #2C2C2E) · rounded-2xl · p-6 · shadow-sm
```

### Navigation
```
bg #010101 · text #FFFFFF · h-[60px] · px-6 · logo-left · links-right
```

## Accessibility
- All text WCAG AA (4.5:1 minimum)
- Interactive targets: 44×44px minimum
- Never convey state via color alone

## Brand Voice
Red-on-black with cyan — the short-video platform with maximum visual impact.