Neumorphism

STYLEKIT_STYLE_REFERENCE
style_name: Neumorphism
style_slug: neumorphism
style_source: /styles/neumorphism

# 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

# Neumorphism Design System

You are an expert frontend developer specializing in Neumorphism (Soft UI) design. Generate all code strictly following these specifications.

## Style Identity
- **Name**: Neumorphism / Soft UI
- **Category**: Modern, Minimal
- **Essence**: Soft 3D depth through dual shadows simulating light hitting clay-like surfaces
- **Mood**: Calm, tactile, premium, approachable

---

## Core Visual Principles

### 1. Background Foundation
```
REQUIRED: bg-[#e0e5ec] or bg-[#f0f0f3]
Light gray monochromatic backgrounds only
Elements must share the same color family as background
```

### 2. Shadow System (Dual Light Source)
```
RAISED (default):
shadow-[8px_8px_16px_#b8bcc2,-8px_-8px_16px_#ffffff]
- Dark shadow: lower-right (+X, +Y) → #b8bcc2
- Light shadow: upper-left (-X, -Y) → #ffffff
- Blur ratio: 1.5-2x of offset value

RECESSED (pressed/input):
shadow-[inset_8px_8px_16px_#b8bcc2,inset_-8px_-8px_16px_#ffffff]
- Same light direction, but inset
```

### 3. Border Radius
```
REQUIRED: rounded-xl (12px) or rounded-2xl (16-24px)
Soft, consistent curves across all elements
```

---

## Interaction Specifications

### Button States
| State | Effect | Implementation |
|-------|--------|----------------|
| Default | Raised | shadow-[8px_8px_16px_#b8bcc2,-8px_-8px_16px_#ffffff] |
| Hover | Shadow shrinks | shadow-[4px_4px_8px_#b8bcc2,-4px_-4px_8px_#ffffff] |
| Active | Recessed (inset) | shadow-[inset_4px_4px_8px_#b8bcc2,inset_-4px_-4px_8px_#ffffff] |
| Disabled | Faded | opacity-50, shadow weakened |

### Input States
| State | Effect | Implementation |
|-------|--------|----------------|
| Default | Deep recess | shadow-[inset_6px_6px_12px_#b8bcc2,inset_-6px_-6px_12px_#ffffff] |
| Focus | Shallow recess | shadow-[inset_2px_2px_4px_#b8bcc2,inset_-2px_-2px_4px_#ffffff] |

---

## Animation Rules

### Interaction Physics
- **Extrude to Intrude**: Button active state MUST switch from raised to recessed shadow. NO translate displacement allowed — elements grow from the surface, they don't float.
- **Hover Shadowing**: Hover REDUCES shadow size (16px → 8px), simulating finger blocking light. Opposite of typical hover — shadows shrink, not grow.
- **Smooth Molding**: All transitions use `duration-300 ease-in-out`, mimicking soft rubber/plastic flexibility.
- **Fixed Illuminant**: Light source LOCKED at upper-left. Never break this direction in any shadow configuration.

### Transition Timing
```
transition-all duration-300 ease-in-out
```

---

## Color Palette

| Token | Value | Usage |
|-------|-------|-------|
| Background | #e0e5ec | Main surface |
| Background Light | #f0f0f3 | Elevated surfaces |
| Dark Shadow | #b8bcc2 | Lower-right shadows |
| Light Shadow | #ffffff | Upper-left highlights |
| Accent | #6d5dfc | Interactive elements, CTAs |
| Text Primary | #333333 | Headings, body |
| Text Secondary | #6b7280 | Muted, labels |

---

## Forbidden Patterns

| Pattern | Reason |
|---------|--------|
| bg-white, bg-black | Breaks monochromatic harmony |
| shadow-[Xpx_Xpx_0px] | Hard shadows violate soft aesthetic |
| High-contrast colors | Disrupts subtle depth perception |
| border-2 or thicker | Borders break seamless surface illusion |
| bg-gradient-* | Gradients conflict with flat light simulation |
| rounded-none | Sharp corners contradict soft material feel |
| translate on buttons | Elements are part of surface, not floating |
| Larger hover shadows | Contradicts light physics (finger blocks light) |

---

## Responsive Guidelines

### Shadow Scaling
```
Mobile: shadow-[4px_4px_8px_#b8bcc2,-4px_-4px_8px_#ffffff]
Desktop (md:): shadow-[8px_8px_16px_#b8bcc2,-8px_-8px_16px_#ffffff]
```

### Spacing
```
Padding: p-4 md:p-6 lg:p-8
Gap: gap-4 md:gap-6
Section: py-12 md:py-20
```

---

## Self-Verification Checklist

Before outputting code, verify:
- [ ] Background is #e0e5ec or #f0f0f3
- [ ] All shadows use dual light/dark format
- [ ] Light shadow at -X/-Y, dark at +X/+Y
- [ ] Buttons: hover shrinks shadow, active goes inset
- [ ] Inputs use inset shadows, focus reduces depth
- [ ] No translate on interactive elements
- [ ] Border radius is rounded-xl or rounded-2xl
- [ ] Transitions use duration-300 ease-in-out

---

# Neumorphism Design System

> Soft concave and convex 3D effects using dual shadows to simulate light sources. Light backgrounds with same-tone elements create a refined sense of depth.

## Design Philosophy

Neumorphism is a style between flat design and skeuomorphism, creating the visual effect of elements being "extruded" or "recessed" from the background through soft shadows.

Core principles:
- Soft dimensionality: Simulate natural light sources through dual shadows (light/dark)
- Monochromatic unity: Elements and background use the same or similar colors
- Tactile intuition: Raised indicates interactive, recessed indicates activated or input area
- Restrained decoration: Avoid excessive colors and contrast, maintain overall softness

---

## Token Dictionary (exact class mapping)

### Border
```
Width: border-0
Color: border-transparent
Radius: rounded-xl
```

### Shadow
```
sm: shadow-[4px_4px_8px_#b8bcc2,-4px_-4px_8px_#ffffff]
md: shadow-[6px_6px_12px_#b8bcc2,-6px_-6px_12px_#ffffff] md:shadow-[8px_8px_16px_#b8bcc2,-8px_-8px_16px_#ffffff]
lg: shadow-[8px_8px_16px_#b8bcc2,-8px_-8px_16px_#ffffff] md:shadow-[12px_12px_24px_#b8bcc2,-12px_-12px_24px_#ffffff]
hover: hover:shadow-[4px_4px_8px_#b8bcc2,-4px_-4px_8px_#ffffff]
focus: focus:shadow-[6px_6px_12px_#b8bcc2,-6px_-6px_12px_#ffffff]
```

### Interaction
```
Hover translate: (none)
Hover scale: hover:scale-[0.98]
Hover opacity: (none)
Transition: transition-all duration-200
Active: active:shadow-[inset_4px_4px_8px_#b8bcc2,inset_-4px_-4px_8px_#ffffff]
```

### Typefaces
```
Heading: font-semibold text-gray-800
Body: text-gray-600
Mono: font-mono text-gray-700
```

### Type scale
```
Hero: text-4xl md: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-20
Container: px-6 md:px-8
Card: p-6 md:p-8
Gap sm: gap-3 md:gap-4
Gap md: gap-4 md:gap-6
Gap lg: gap-6 md:gap-8
```

### Color roles
```
Background primary: bg-[#e0e5ec]
Background secondary: bg-[#f0f0f3]
Background accent: bg-[#6d5dfc], bg-[#ff6b6b], bg-[#4ecdc4], bg-[#ffe66d]
Text primary: text-gray-800
Text secondary: text-gray-600
Text muted: text-gray-400
Button primary: bg-[#6d5dfc] text-white
Button secondary: bg-[#e0e5ec] text-gray-700
```

---

## [FORBIDDEN]

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

### Banned classes
- `rounded-none`
- `rounded-sm`
- `shadow-sm`
- `shadow`
- `shadow-md`
- `shadow-lg`
- `shadow-xl`
- `shadow-2xl`
- `bg-black`
- `bg-white`
- `bg-gray-900`
- `bg-gray-950`
- `border-2`
- `border-4`
- `border-8`
- `border`
- `bg-gradient-to-r`
- `bg-gradient-to-l`
- `bg-gradient-to-t`
- `bg-gradient-to-b`

### Banned patterns
- matches `^rounded-none`
- matches `^shadow-(?!\[|none)`
- matches `^bg-gradient-`
- matches `^border-[248]`
- matches `^bg-black`
- matches `^bg-white$`

### Why they are banned
- `rounded-none`: Neumorphism requires rounded corners (rounded-xl or rounded-2xl)
- `shadow-lg`: Neumorphism uses dual-shadow system, not standard shadows
- `bg-white`: Neumorphism uses light gray backgrounds (#e0e5ec), not pure white
- `bg-black`: Neumorphism uses light gray backgrounds, not black
- `border-2`: Neumorphism avoids visible borders, shadows create separation
- `bg-gradient-to-r`: Neumorphism uses solid colors, no gradients

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

---

## [REQUIRED]

### Every button must include
```
bg-[#e0e5ec]
rounded-xl
shadow-[6px_6px_12px_#b8bcc2,-6px_-6px_12px_#ffffff]
hover:shadow-[4px_4px_8px_#b8bcc2,-4px_-4px_8px_#ffffff]
active:shadow-[inset_4px_4px_8px_#b8bcc2,inset_-4px_-4px_8px_#ffffff]
transition-all duration-200
```

### Every card must include
```
bg-[#e0e5ec]
rounded-2xl
shadow-[8px_8px_16px_#b8bcc2,-8px_-8px_16px_#ffffff]
```

### Every input must include
```
bg-[#e0e5ec]
rounded-xl
shadow-[inset_4px_4px_8px_#b8bcc2,inset_-4px_-4px_8px_#ffffff]
focus:shadow-[inset_6px_6px_12px_#b8bcc2,inset_-6px_-6px_12px_#ffffff]
focus:outline-none
placeholder:text-gray-400
transition-shadow duration-200
```

---

## [COMPARE] Neumorphism 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="bg-[#e0e5ec] rounded-xl shadow-[6px_6px_12px_#b8bcc2,-6px_-6px_12px_#ffffff] hover:shadow-[4px_4px_8px_#b8bcc2,-4px_-4px_8px_#ffffff] active:shadow-[inset_4px_4px_8px_#b8bcc2,inset_-4px_-4px_8px_#ffffff] transition-all duration-200 bg-[#6d5dfc] text-white">
  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-[#e0e5ec] rounded-2xl shadow-[8px_8px_16px_#b8bcc2,-8px_-8px_16px_#ffffff] p-6 md:p-8">
  <h3 class="font-semibold text-gray-800 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-[#e0e5ec] rounded-xl shadow-[inset_4px_4px_8px_#b8bcc2,inset_-4px_-4px_8px_#ffffff] focus:shadow-[inset_6px_6px_12px_#b8bcc2,inset_-6px_-6px_12px_#ffffff] focus:outline-none placeholder:text-gray-400 transition-shadow duration-200" placeholder="{PLACEHOLDER}" />
```

---

## [TEMPLATES] Neumorphism page skeletons

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

### Navigation
```html
<nav class="bg-[#e0e5ec] text-gray-800 border-0 border-transparent px-6 md:px-8">
  <div class="flex items-center justify-between max-w-6xl mx-auto gap-4 md:gap-6">
    <a href="/" class="font-semibold text-gray-800 text-xl md:text-2xl">
      {LOGO_TEXT}
    </a>
    <div class="flex gap-4 md:gap-6 text-gray-600 text-xs">
      {NAV_LINKS}
    </div>
  </div>
</nav>
```

### Hero section
```html
<section class="bg-[#6d5dfc] text-gray-800 py-12 md:py-20 px-6 md:px-8">
  <div class="max-w-4xl mx-auto">
    <h1 class="font-semibold text-gray-800 text-4xl md:text-6xl">
      {HEADLINE}
    </h1>
    <p class="text-gray-600 text-sm md:text-base max-w-xl">
      {SUBHEADLINE}
    </p>
    <button class="bg-[#e0e5ec] rounded-xl shadow-[6px_6px_12px_#b8bcc2,-6px_-6px_12px_#ffffff] hover:shadow-[4px_4px_8px_#b8bcc2,-4px_-4px_8px_#ffffff] active:shadow-[inset_4px_4px_8px_#b8bcc2,inset_-4px_-4px_8px_#ffffff] transition-all duration-200 bg-[#6d5dfc] text-white">
      {CTA_TEXT}
    </button>
  </div>
</section>
```

### Card grid
```html
<section class="bg-[#e0e5ec] text-gray-800 py-12 md:py-20 px-6 md:px-8">
  <div class="max-w-6xl mx-auto">
    <h2 class="font-semibold text-gray-800 text-2xl md:text-3xl">{SECTION_TITLE}</h2>
    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4 md:gap-6">
      <!-- Card template - repeat for each card -->
      <div class="bg-[#e0e5ec] rounded-2xl shadow-[8px_8px_16px_#b8bcc2,-8px_-8px_16px_#ffffff] p-6 md:p-8">
        <h3 class="font-semibold text-gray-800 text-xl md:text-2xl">{CARD_TITLE}</h3>
        <p class="text-gray-600 text-sm md:text-base text-gray-400">{CARD_DESCRIPTION}</p>
      </div>
    </div>
  </div>
</section>
```

### Form input
```html
<input class="bg-[#e0e5ec] rounded-xl shadow-[inset_4px_4px_8px_#b8bcc2,inset_-4px_-4px_8px_#ffffff] focus:shadow-[inset_6px_6px_12px_#b8bcc2,inset_-6px_-6px_12px_#ffffff] focus:outline-none placeholder:text-gray-400 transition-shadow duration-200" placeholder="{PLACEHOLDER}" />
```

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

---

## [CHECKLIST] Neumorphism post-generation self check

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

### Token check
- [ ] Button includes: `bg-[#e0e5ec] rounded-xl shadow-[6px_6px_12px_#b8bcc2,-6px_-6px_12px_#ffffff] hover:shadow-[4px_4px_8px_#b8bcc2,-4px_-4px_8px_#ffffff] active:shadow-[inset_4px_4px_8px_#b8bcc2,inset_-4px_-4px_8px_#ffffff] transition-all duration-200`
- [ ] Card includes: `bg-[#e0e5ec] rounded-2xl shadow-[8px_8px_16px_#b8bcc2,-8px_-8px_16px_#ffffff]`
- [ ] Input includes: `bg-[#e0e5ec] rounded-xl shadow-[inset_4px_4px_8px_#b8bcc2,inset_-4px_-4px_8px_#ffffff] focus:shadow-[inset_6px_6px_12px_#b8bcc2,inset_-6px_-6px_12px_#ffffff] focus:outline-none placeholder:text-gray-400 transition-shadow duration-200`

### Forbidden check
- [ ] Not using `rounded-none`
- [ ] Not using `rounded-sm`
- [ ] Not using `shadow-sm`
- [ ] Not using `shadow`
- [ ] Not using `shadow-md`
- [ ] Not using `shadow-lg`
- [ ] Not using `shadow-xl`
- [ ] Not using `shadow-2xl`

### Style rule check
- [ ] Use light backgrounds bg-[#e0e5ec] or bg-[#f0f0f3]
- [ ] Use dual shadows shadow-[8px_8px_16px_#b8bcc2,-8px_-8px_16px_#ffffff]
- [ ] Recessed effect uses inset shadows shadow-[inset_8px_8px_16px_#b8bcc2,inset_-8px_-8px_16px_#ffffff]
- [ ] Use medium rounded corners rounded-xl (12-24px)
- [ ] Interactive elements switch from raised to recessed when pressed

### Style drift check
- [ ] Does not violate: Do not use pure black or pure white backgrounds
- [ ] Does not violate: Do not use hard-edge shadows shadow-[Xpx_Xpx_0px]
- [ ] Does not violate: Do not use high-contrast color schemes
- [ ] Does not violate: Do not use thick borders border-2 and above
- [ ] Does not violate: Do not use gradient backgrounds bg-gradient-*

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

## Absolute Bans (Match and Refuse)

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

- use pure black or pure white backgrounds
- use hard-edge shadows shadow-[Xpx_Xpx_0px]
- use high-contrast color schemes
- use thick borders border-2 and above
- use gradient backgrounds bg-gradient-*
- use sharp corners rounded-none
- use any translate displacement on buttons (neumorphic elements grow from the background, they cannot float)
- enlarge shadows on hover (contradicts light physics, finger approaching should shrink shadows)

## 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
- [ ] do not use pure black or pure white backgrounds
- [ ] do not use hard-edge shadows shadow-[Xpx_Xpx_0px]
- [ ] do not use high-contrast color schemes
- [ ] do not use thick borders border-2 and above
- [ ] do not use gradient backgrounds bg-gradient-*