Steampunk

STYLEKIT_STYLE_REFERENCE
style_name: Steampunk
style_slug: steampunk
style_source: /styles/steampunk

# 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

STYLE: Steampunk
TYPE: Victorian industrial machinery aesthetic

MUST USE:
- Dark brown background: bg-[#2a1f15] or bg-[#3d2b1f]
- Brass color: text-[#b5a642], bg-[#b5a642]
- Copper color: text-[#b87333], border-[#b87333]
- Cream text: text-[#f5f0e1]
- Metallic gradients: bg-gradient-to-b from-[#b5a642] to-[#8a7d32]
- Brass glow shadows: shadow-[0_0_15px_rgba(181,166,66,0.3)]
- font-serif for Victorian feel
- uppercase tracking-wider for labels
- Rivet decorations: small gradient circles at corners
- Ornate borders: border-2 with copper/brass colors

MUST AVOID:
- White/light backgrounds
- Neon or fluorescent colors
- Flat design without texture
- Modern sans-serif fonts for headings
- Large rounded corners (rounded-2xl+)
- Cold blue/purple color schemes

COLOR RULES:
- Primary: Brass (#b5a642)
- Secondary: Copper (#b87333)
- Background: Dark Brown (#2a1f15, #3d2b1f)
- Text: Cream (#f5f0e1)
- Iron accent: (#4a4a4a)

SPECIAL EFFECTS:
- Corner rivet decorations (small brass circles)
- Metallic inset shadows for depth
- Warm glow on hover interactions
- Gradient overlays for metal texture

## Animation & Interaction Rules

- Clockwork Grind: Motion rhythm is short and linear, simulating gear and lever mechanical engagement, no soft bounce-back.
- Steam Release: Active state performs a crisp press-down and flattens shadow, restoring brass highlight on release, forming a brief valve feedback.
- Rivet Glint: Rivets use sliding gradients for slow reflective shimmer, emphasizing metallic craftsmanship detail.
- Brass Oxidation: On hover, dark brown base slightly deepens while brass strokes and text brighten simultaneously, widening material contrast.

---

# Steampunk Design System

> Victorian-era industrial machinery aesthetics with brass and copper metallic elements, gear mechanism decorations, and steam pipe rivet details. Ideal for retro sci-fi, industrial style, and creative showcase projects.

## Design Philosophy

Steampunk style originates from the aesthetic imagination of the Victorian-era Industrial Revolution, creating a retro-futuristic feel through brass/copper metallic textures, gear mechanism elements, and precision mechanical details.

Core principles:
- Metallic texture: Brass and copper as core color tones, presenting warm metallic luster
- Mechanical decoration: Gears, pipes, rivets, and other industrial elements integrated into interface design
- Victorian elegance: Serif fonts and ornamental borders maintain classical elegance
- Aged texture: Dark brown backgrounds and yellowed paper tones create a period atmosphere

---

## Token Dictionary (exact class mapping)

### Border
```
Width: border-2
Color: border-[#b87333]/40
Radius: rounded
```

### Shadow
```
sm: shadow-[0_0_8px_rgba(181,166,66,0.2)]
md: shadow-[0_0_15px_rgba(181,166,66,0.3)]
lg: shadow-[0_0_25px_rgba(181,166,66,0.4)]
hover: shadow-[0_0_20px_rgba(184,115,51,0.4)]
focus: shadow-[0_0_12px_rgba(181,166,66,0.25)]
```

### Interaction
```
Hover translate: (none)
Hover scale: hover:shadow-[0_0_25px_rgba(181,166,66,0.5)]
Hover opacity: (none)
Transition: transition-all duration-300
Active: active:scale-95
```

### Typefaces
```
Heading: font-serif font-bold
Body: font-serif
Mono: font-mono
```

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

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

### Color roles
```
Background primary: bg-[#2a1f15]
Background secondary: bg-[#3d2b1f]
Background accent: bg-[#b5a642], bg-[#b87333], bg-[#4a4a4a]
Text primary: text-[#f5f0e1]
Text secondary: text-[#b5a642]
Text muted: text-[#b87333]/70
Button primary: bg-gradient-to-b from-[#b5a642] to-[#8a7d32] text-[#2a1f15]
Button secondary: bg-transparent text-[#b87333] border-2 border-[#b87333]
```

---

## [FORBIDDEN]

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

### Banned classes
- `bg-white`
- `bg-gray-50`
- `bg-slate-50`
- `shadow-sm`
- `shadow-md`
- `shadow-lg`
- `text-cyan-400`
- `text-fuchsia-500`
- `rounded-2xl`
- `rounded-3xl`

### Banned patterns
- matches `^bg-white`
- matches `^bg-gray-[1-3]`
- matches `^bg-slate-[1-3]`
- matches `^shadow-(?!\[)`
- matches `^rounded-[23]xl`
- matches `^text-cyan`
- matches `^text-fuchsia`
- matches `^bg-cyan`
- matches `^bg-fuchsia`

### Why they are banned
- `bg-white`: Steampunk uses dark brown backgrounds only
- `shadow-md`: Use warm brass glow shadows: shadow-[0_0_15px_rgba(181,166,66,0.3)]
- `rounded-2xl`: Keep corners subtle (rounded or rounded-lg max)
- `text-cyan-400`: Use warm brass/copper tones, not neon colors

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

---

## [REQUIRED]

### Every button must include
```
px-6 py-3
rounded
font-serif
uppercase tracking-wider
transition-all duration-300
```

### Every card must include
```
bg-[#2a1f15]
border-2 border-[#b87333]/40
rounded
```

### Every input must include
```
bg-[#2a1f15]
border-2 border-[#b87333]/30
rounded
text-[#f5f0e1]
font-serif
focus:border-[#b5a642]
focus:shadow-[0_0_12px_rgba(181,166,66,0.25)]
```

---

## [COMPARE] Steampunk 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 font-serif uppercase tracking-wider transition-all duration-300 bg-gradient-to-b from-[#b5a642] to-[#8a7d32] text-[#2a1f15]">
  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-[#2a1f15] border-2 border-[#b87333]/40 rounded p-6">
  <h3 class="font-serif font-bold 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="bg-[#2a1f15] border-2 border-[#b87333]/30 rounded text-[#f5f0e1] font-serif focus:border-[#b5a642] focus:shadow-[0_0_12px_rgba(181,166,66,0.25)]" placeholder="{PLACEHOLDER}" />
```

---

## [TEMPLATES] Steampunk page skeletons

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

### Navigation
```html
<nav class="bg-[#2a1f15] text-[#f5f0e1] border-2 border-[#b87333]/40 px-4 md:px-8">
  <div class="flex items-center justify-between max-w-6xl mx-auto gap-6">
    <a href="/" class="font-serif font-bold text-xl md:text-2xl">
      {LOGO_TEXT}
    </a>
    <div class="flex gap-6 font-serif text-xs">
      {NAV_LINKS}
    </div>
  </div>
</nav>
```

### Hero section
```html
<section class="bg-[#b5a642] text-[#f5f0e1] py-16 md:py-24 px-4 md:px-8">
  <div class="max-w-4xl mx-auto">
    <h1 class="font-serif font-bold text-4xl md:text-6xl lg:text-8xl">
      {HEADLINE}
    </h1>
    <p class="font-serif text-sm md:text-base max-w-xl">
      {SUBHEADLINE}
    </p>
    <button class="px-6 py-3 rounded font-serif uppercase tracking-wider transition-all duration-300 bg-gradient-to-b from-[#b5a642] to-[#8a7d32] text-[#2a1f15]">
      {CTA_TEXT}
    </button>
  </div>
</section>
```

### Card grid
```html
<section class="bg-[#2a1f15] text-[#f5f0e1] py-16 md:py-24 px-4 md:px-8">
  <div class="max-w-6xl mx-auto">
    <h2 class="font-serif font-bold 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-[#2a1f15] border-2 border-[#b87333]/40 rounded p-6">
        <h3 class="font-serif font-bold text-xl md:text-2xl">{CARD_TITLE}</h3>
        <p class="font-serif text-sm md:text-base text-[#b87333]/70">{CARD_DESCRIPTION}</p>
      </div>
    </div>
  </div>
</section>
```

### Form input
```html
<input class="bg-[#2a1f15] border-2 border-[#b87333]/30 rounded text-[#f5f0e1] font-serif focus:border-[#b5a642] focus:shadow-[0_0_12px_rgba(181,166,66,0.25)]" placeholder="{PLACEHOLDER}" />
```

### Footer
```html
<footer class="bg-[#3d2b1f] text-[#b5a642] py-16 md:py-24 px-4 md: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-serif font-bold text-xl md:text-2xl">{LOGO_TEXT}</span>
        <p class="font-serif text-xs">{TAGLINE}</p>
      </div>
      <div>
        <h4 class="font-serif font-bold text-xl md:text-2xl">{COLUMN_TITLE}</h4>
        <ul class="font-serif text-xs">
          {FOOTER_LINKS}
        </ul>
      </div>
    </div>
  </div>
</footer>
```

---

## [CHECKLIST] Steampunk 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 font-serif uppercase tracking-wider transition-all duration-300`
- [ ] Card includes: `bg-[#2a1f15] border-2 border-[#b87333]/40 rounded`
- [ ] Input includes: `bg-[#2a1f15] border-2 border-[#b87333]/30 rounded text-[#f5f0e1] font-serif focus:border-[#b5a642] focus:shadow-[0_0_12px_rgba(181,166,66,0.25)]`

### Forbidden check
- [ ] Not using `bg-white`
- [ ] Not using `bg-gray-50`
- [ ] Not using `bg-slate-50`
- [ ] Not using `shadow-sm`
- [ ] Not using `shadow-md`
- [ ] Not using `shadow-lg`
- [ ] Not using `text-cyan-400`
- [ ] Not using `text-fuchsia-500`

### Style rule check
- [ ] Use dark brown backgrounds bg-[#3d2b1f] or bg-[#2a1f15]
- [ ] Use shadow-[0_0_15px_rgba(181,166,66,0.3)] for brass luster effects
- [ ] Use copper-toned borders border border-[#b87333]/50
- [ ] Use cream text text-[#f5f0e1] or brass text text-[#b5a642]
- [ ] Use ornamental borders and rivet-style dot elements

### Style drift check
- [ ] Does not violate: No pure white backgrounds or modern minimalist style
- [ ] Does not violate: No neon or highly saturated fluorescent colors
- [ ] Does not violate: No flat, textureless design
- [ ] Does not violate: No modern sans-serif fonts for headings
- [ ] Does not violate: No overly large rounded corners rounded-2xl, rounded-3xl

### 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 Steampunk

## Absolute Bans (Match and Refuse)

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

- pure white backgrounds or modern minimalist style
- neon or highly saturated fluorescent colors
- flat, textureless design
- modern sans-serif fonts for headings
- overly large rounded corners rounded-2xl, rounded-3xl
- cool-toned blue/purple as primary colors

## 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
- [ ] no pure white backgrounds or modern minimalist style
- [ ] no neon or highly saturated fluorescent colors
- [ ] no flat, textureless design
- [ ] no modern sans-serif fonts for headings
- [ ] no overly large rounded corners rounded-2xl, rounded-3xl