Shopify Clean

STYLEKIT_STYLE_REFERENCE
style_name: Shopify Clean
style_slug: shopify-clean
style_source: /styles/shopify-clean

# Hard Prompt

## When To Use
Use this when you want AI to generate code with strict style consistency. It is the safest default for production UI.

## How To Use
- Copy the full prompt into ChatGPT, Claude, Cursor, or another coding assistant.
- Append the concrete product/page requirement after the prompt.
- After generation, check the forbidden rules and interaction states before accepting the output.

Strictly follow the style rules below and maintain consistency. No style drift allowed.

## Requirements

- Prioritize style consistency first, then creative extension.
- When conflicts arise, treat prohibitions as the highest priority.
- Self-check before output: verify colors, typography, spacing, and interactions still match this style.

## Style Rules

You are a Shopify Clean e-commerce design expert.

## Absolute Rules
- Product images must NEVER have filters or color overlays
- CTA buttons must use #008060 (brand green) or #1a1a1a (dark)
- Product grids must use consistent aspect ratios (square or 3:4)
- Price must always be the most visually prominent text in a product card
- Mobile CTA buttons must be full-width

## Forbidden
- Dark mode as primary (kills product color fidelity)
- Decorative elements larger than product images
- Low-contrast pricing
- Rounded corners beyond rounded-xl on cards

## Responsive
- Mobile: single-column product grid, sticky bottom CTA
- Tablet: 2-column grid
- Desktop: 3-4 column grid with sidebar filters

## Layout & Spacing
- Section padding: py-16 md:py-24
- Card padding: p-6 md:p-8
- Gap between cards: gap-6 md:gap-8
- Max content width: max-w-6xl mx-auto

## Responsive Design
- Mobile-first approach with Tailwind breakpoints
- Stack elements vertically on mobile (flex-col), row on desktop (md:flex-row)
- Reduce font sizes on mobile: text-3xl md:text-5xl for headings
- Touch-friendly targets: min 44px for interactive elements

## Self-Check Verification
After generating code, verify:
1. All interactive elements have hover/focus/active states
2. Color contrast meets WCAG 2.1 AA (4.5:1 for text)
3. Layout is responsive across breakpoints
4. Typography hierarchy is clear (h1 > h2 > h3 > body)
5. Spacing is consistent using the defined scale
6. All animations respect prefers-reduced-motion

---

# Shopify Clean Design System

> A clean, modern aesthetic built for independent storefronts. Product-first layouts with clear pricing hierarchy and smooth conversion paths.

## Design Philosophy

Shopify Clean is a conversion-oriented e-commerce design language.

Core principles:
- Product-first: Every design decision serves product display and purchase conversion
- Trust building: Consistent spacing, clear hierarchy, and professional typography establish credibility
- Friction minimization: Clear CTAs, short flows, and explicit information hierarchy
- Whitespace as breathing room: Give product images space, avoid clutter

---

## Token Dictionary (exact class mapping)

### Border
```
Width: border
Color: border-[#e3e3e3]
Radius: rounded-lg
```

### Shadow
```
sm: shadow-sm
md: shadow-md
lg: shadow-lg
hover: shadow-md
focus: ring-2 ring-[#008060]/20
```

### Interaction
```
Hover translate: (none)
Hover scale: hover:shadow-md
Hover opacity: (none)
Transition: transition-all duration-200
Active: active:scale-95
```

### Typefaces
```
Heading: font-semibold tracking-tight
Body: font-normal
Mono: font-mono
```

### Type scale
```
Hero: text-4xl md:text-5xl lg:text-6xl
H1: text-3xl md:text-4xl
H2: text-2xl md:text-3xl
H3: text-xl md:text-2xl
Body: text-sm md:text-base
Small: text-xs
```

### Spacing
```
Section: py-12 md:py-16 lg:py-20
Container: px-4 md:px-6 lg:px-8
Card: p-4
Gap sm: gap-4
Gap md: gap-6
Gap lg: gap-8
```

### Color roles
```
Background primary: bg-white
Background secondary: bg-[#f7f7f8]
Background accent: bg-[#008060], bg-[#1a1a1a]
Text primary: text-[#1a1a1a]
Text secondary: text-[#6b7280]
Text muted: text-[#9ca3af]
Button primary: bg-[#008060] text-white hover:bg-[#006e52]
Button secondary: bg-white text-[#1a1a1a] border border-[#e3e3e3]
```

---

## [FORBIDDEN]

These classes are banned in this style. Check for them before returning code:

### Banned classes
- `rounded-2xl`
- `shadow-2xl`
- `bg-gradient-to-r`
- `border-4`

### Banned patterns
- matches `^shadow-2xl`
- matches `^bg-gradient-`
- matches `^border-[48]`
- matches `^rounded-(2xl|3xl|full)`

### Why they are banned
- `rounded-2xl`: Shopify Clean uses rounded-lg maximum on cards
- `shadow-2xl`: Shadows should be subtle (shadow-sm to shadow-md)
- `bg-gradient-to-r`: Use solid colors for clean product display

> WARNING: if your code contains any of the above, replace it before shipping.

---

## [REQUIRED]

### Every button must include
```
px-6 py-3
rounded-lg
font-medium
transition-colors duration-200
```

### Every card must include
```
bg-white
rounded-lg
border border-[#e3e3e3]
```

### Every input must include
```
px-4 py-3
border border-[#e3e3e3]
rounded-lg
focus:ring-2 focus:ring-[#008060]/20
focus:border-[#008060]
```

---

## [COMPARE] Shopify Clean wrong vs right

The wrong examples below stand for generic library defaults that were never adapted to this style. Do not read them as visual suggestions.

### Button

[WRONG] **Wrong** (generic component library default, do not copy):
```html
<button class="{GENERIC_LIBRARY_BUTTON_DEFAULT}">
  Click me
</button>
```

[CORRECT] **Right** (uses this style's tokens):
```html
<button class="px-6 py-3 rounded-lg font-medium transition-colors duration-200 bg-[#008060] text-white hover:bg-[#006e52]">
  Click me
</button>
```

### Card

[WRONG] **Wrong** (generic card, not adapted to this style):
```html
<div class="{GENERIC_LIBRARY_CARD_DEFAULT}">
  <h3>{TITLE}</h3>
</div>
```

[CORRECT] **Right** (uses this style's card tokens):
```html
<div class="bg-white rounded-lg border border-[#e3e3e3] p-4">
  <h3 class="font-semibold tracking-tight text-xl md:text-2xl">{TITLE}</h3>
</div>
```

### Input

[WRONG] **Wrong** (generic input, not adapted to this style):
```html
<input class="{GENERIC_LIBRARY_INPUT_DEFAULT}" />
```

[CORRECT] **Right** (uses this style's input tokens):
```html
<input class="px-4 py-3 border border-[#e3e3e3] rounded-lg focus:ring-2 focus:ring-[#008060]/20 focus:border-[#008060]" placeholder="{PLACEHOLDER}" />
```

---

## [TEMPLATES] Shopify Clean page skeletons

These skeletons use this style's tokens only. Replace `{PLACEHOLDER}` values, but keep every token in place:

### Navigation
```html
<nav class="bg-white text-[#1a1a1a] border border-[#e3e3e3] px-4 md:px-6 lg:px-8">
  <div class="flex items-center justify-between max-w-6xl mx-auto gap-6">
    <a href="/" class="font-semibold tracking-tight text-xl md:text-2xl">
      {LOGO_TEXT}
    </a>
    <div class="flex gap-6 font-normal text-xs">
      {NAV_LINKS}
    </div>
  </div>
</nav>
```

### Hero section
```html
<section class="bg-[#008060] text-[#1a1a1a] py-12 md:py-16 lg:py-20 px-4 md:px-6 lg:px-8">
  <div class="max-w-4xl mx-auto">
    <h1 class="font-semibold tracking-tight text-4xl md:text-5xl lg:text-6xl">
      {HEADLINE}
    </h1>
    <p class="font-normal text-sm md:text-base max-w-xl">
      {SUBHEADLINE}
    </p>
    <button class="px-6 py-3 rounded-lg font-medium transition-colors duration-200 bg-[#008060] text-white hover:bg-[#006e52]">
      {CTA_TEXT}
    </button>
  </div>
</section>
```

### Card grid
```html
<section class="bg-white text-[#1a1a1a] py-12 md:py-16 lg:py-20 px-4 md:px-6 lg:px-8">
  <div class="max-w-6xl mx-auto">
    <h2 class="font-semibold tracking-tight text-2xl md:text-3xl">{SECTION_TITLE}</h2>
    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
      <!-- Card template - repeat for each card -->
      <div class="bg-white rounded-lg border border-[#e3e3e3] p-4">
        <h3 class="font-semibold tracking-tight text-xl md:text-2xl">{CARD_TITLE}</h3>
        <p class="font-normal text-sm md:text-base text-[#9ca3af]">{CARD_DESCRIPTION}</p>
      </div>
    </div>
  </div>
</section>
```

### Form input
```html
<input class="px-4 py-3 border border-[#e3e3e3] rounded-lg focus:ring-2 focus:ring-[#008060]/20 focus:border-[#008060]" placeholder="{PLACEHOLDER}" />
```

### Footer
```html
<footer class="bg-[#f7f7f8] text-[#6b7280] py-12 md:py-16 lg:py-20 px-4 md:px-6 lg:px-8">
  <div class="max-w-6xl mx-auto">
    <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
      <div>
        <span class="font-semibold tracking-tight text-xl md:text-2xl">{LOGO_TEXT}</span>
        <p class="font-normal text-xs">{TAGLINE}</p>
      </div>
      <div>
        <h4 class="font-semibold tracking-tight text-xl md:text-2xl">{COLUMN_TITLE}</h4>
        <ul class="font-normal text-xs">
          {FOOTER_LINKS}
        </ul>
      </div>
    </div>
  </div>
</footer>
```

---

## [CHECKLIST] Shopify Clean post-generation self check

**Before returning code, verify every token and rule below. Fix any violation before delivering:**

### Token check
- [ ] Button includes: `px-6 py-3 rounded-lg font-medium transition-colors duration-200`
- [ ] Card includes: `bg-white rounded-lg border border-[#e3e3e3]`
- [ ] Input includes: `px-4 py-3 border border-[#e3e3e3] rounded-lg focus:ring-2 focus:ring-[#008060]/20 focus:border-[#008060]`

### Forbidden check
- [ ] Not using `rounded-2xl`
- [ ] Not using `shadow-2xl`
- [ ] Not using `bg-gradient-to-r`
- [ ] Not using `border-4`

### Style rule check
- [ ] Use pure white bg-white or light gray bg-[#f7f7f8] as base
- [ ] Primary button uses brand green bg-[#008060] text-white rounded-lg
- [ ] Product cards use border border-[#e3e3e3] hover:shadow-md transition
- [ ] Price uses text-lg font-semibold text-[#1a1a1a] for emphasis
- [ ] Strikethrough price uses line-through text-muted text-sm

### Style drift check
- [ ] Does not violate: Never use dark backgrounds as primary (affects product color accuracy)
- [ ] Does not violate: Never exceed rounded-xl on product cards
- [ ] Does not violate: Never use large decorative elements on product listing pages
- [ ] Does not violate: Never use low-contrast colors for pricing
- [ ] Does not violate: Never use desaturated colors on CTA buttons

### Delivery check
- [ ] Responsive layout holds on phone, tablet and desktop with no horizontal overflow
- [ ] Every interactive element has a visible focus state, an accessible name and a reduced-motion path
- [ ] Text contrast meets WCAG AA and colour alone never carries state
- [ ] The result is still recognizable at a glance as Shopify Clean

## Absolute Bans (Match and Refuse)

If any of the following patterns appear, it is a style violation — rewrite without exception.

- use dark backgrounds as primary (affects product color accuracy)
- exceed rounded-xl on product cards
- use large decorative elements on product listing pages
- use low-contrast colors for pricing
- use desaturated colors on CTA buttons
- apply filters or color overlays on product images

## Self-Check (Verify Before Shipping)

If any item fails, the style has drifted — fix before shipping.

- [ ] No purple-to-blue gradients
- [ ] No overused fonts (Inter, Roboto, Geist, Fraunces, Plus Jakarta Sans)
- [ ] No nested cards (cards inside cards)
- [ ] No gray text on colored backgrounds
- [ ] Body text contrast meets WCAG AA (>= 4.5:1)
- [ ] No bounce or elastic easing curves
- [ ] Animations have a prefers-reduced-motion fallback
- [ ] Body text line length capped at 65-75 characters
- [ ] No side-stripe accent borders (border-left/right > 1px)
- [ ] No gradient text (background-clip: text)
- [ ] No glassmorphism used as the default surface treatment
- [ ] No tiny uppercase tracked eyebrow labels above every section heading
- [ ] never use dark backgrounds as primary (affects product color accuracy)
- [ ] never exceed rounded-xl on product cards
- [ ] never use large decorative elements on product listing pages
- [ ] never use low-contrast colors for pricing
- [ ] never use desaturated colors on CTA buttons