Soft Utility

STYLEKIT_STYLE_REFERENCE
style_name: Soft Utility
style_slug: soft-utility
style_source: /styles/soft-utility

# 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: Soft Utility

MUST USE:
- Deep teal primary actions with pale surfaces and distinct state colors
- Rounded-xl to rounded-2xl controls that preserve information density
- Mobile-first bottom action bars and thumb-reachable primary actions
- Explicit default, focus, success, error, disabled, and loading states
- Status colors paired with text or icons; never communicate meaning by color alone
- Fast, restrained motion that supports task completion

MUST AVOID:
- Low-contrast text for task-critical information
- Turning a tool screen into a decorative card gallery
- Removing boundaries or state feedback in the name of softness
- Bouncy animations that slow down repeated actions

INTERACTION:
- Use 160-240ms transitions and scale-[0.98] on press
- Keep primary controls in a consistent location across screens
- Provide undo or confirmation for destructive actions

COLOR ROLES:
- Surface: #f4f8f6
- Text: #203b40
- Primary: #2d5b63
- Success/support: #a9d8cc
- Notice: #f3c98b
- Secondary states: #e6b7b0 and #b8c9ed

---

# Soft Utility Design System

> A soft utility style for frequently used mobile tools, balancing efficiency and warmth with calm surfaces, clear state colors, and friendly hierarchy.

## Design Philosophy

A soft utility style for frequently used mobile tools, balancing efficiency and warmth with calm surfaces, clear state colors, and friendly hierarchy.

---

## Token Dictionary (exact class mapping)

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

### Shadow
```
sm: shadow-sm
md: shadow-md
lg: shadow-lg
hover: hover:shadow-md
focus: focus:shadow-md
```

### Interaction
```
Hover translate: (none)
Hover scale: (none)
Hover opacity: hover:opacity-90
Transition: transition-all duration-200
Active: active:scale-[0.98]
```

### Typefaces
```
Heading: font-semibold tracking-tight
Body: font-sans

```

### Type scale
```
Hero: text-4xl md:text-6xl
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 md:text-sm
```

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

### Color roles
```
Background primary: bg-[#f4f8f6]
Background secondary: bg-[#2d5b63]
Background accent: bg-[#a9d8cc], bg-[#f3c98b], bg-[#e6b7b0], bg-[#b8c9ed]
Text primary: text-[#2d5b63]
Text secondary: text-[#a9d8cc]
Text muted: text-zinc-500
Button primary: bg-[#2d5b63] text-white
Button secondary: bg-[#f4f8f6] text-[#2d5b63]
```

---

## [FORBIDDEN]

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

### Banned classes
- (no banned classes registered for this style)

### Banned patterns
- (no banned patterns registered for this style)

### Why they are banned
- Follow this style's own design rules.

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

---

## [REQUIRED]

### Every button must include
```
rounded-lg
border
font-medium
inline-flex
items-center
```

### Every card must include
```
rounded-lg
border
bg-white/80
```

### Every input must include
```
rounded-lg
border
bg-background
focus:outline-none
```

---

## [COMPARE] Soft Utility 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="rounded-lg border font-medium inline-flex items-center bg-[#2d5b63] 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="rounded-lg border bg-white/80 p-5 md:p-6">
  <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="rounded-lg border bg-background focus:outline-none" placeholder="{PLACEHOLDER}" />
```

---

## [TEMPLATES] Soft Utility page skeletons

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

### Navigation
```html
<nav class="bg-[#f4f8f6] text-[#2d5b63] border border-[#2d5b63] px-4 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 tracking-tight text-xl md:text-2xl">
      {LOGO_TEXT}
    </a>
    <div class="flex gap-4 md:gap-6 font-sans text-xs md:text-sm">
      {NAV_LINKS}
    </div>
  </div>
</nav>
```

### Hero section
```html
<section class="bg-[#a9d8cc] text-[#2d5b63] py-10 md:py-20 px-4 md:px-8">
  <div class="max-w-4xl mx-auto">
    <h1 class="font-semibold tracking-tight text-4xl md:text-6xl">
      {HEADLINE}
    </h1>
    <p class="font-sans text-sm md:text-base max-w-xl">
      {SUBHEADLINE}
    </p>
    <button class="rounded-lg border font-medium inline-flex items-center bg-[#2d5b63] text-white">
      {CTA_TEXT}
    </button>
  </div>
</section>
```

### Card grid
```html
<section class="bg-[#f4f8f6] text-[#2d5b63] py-10 md:py-20 px-4 md: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-4 md:gap-6">
      <!-- Card template - repeat for each card -->
      <div class="rounded-lg border bg-white/80 p-5 md:p-6">
        <h3 class="font-semibold tracking-tight text-xl md:text-2xl">{CARD_TITLE}</h3>
        <p class="font-sans text-sm md:text-base text-zinc-500">{CARD_DESCRIPTION}</p>
      </div>
    </div>
  </div>
</section>
```

### Form input
```html
<input class="rounded-lg border bg-background focus:outline-none" placeholder="{PLACEHOLDER}" />
```

### Footer
```html
<footer class="bg-[#2d5b63] text-[#a9d8cc] py-10 md:py-20 px-4 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 tracking-tight text-xl md:text-2xl">{LOGO_TEXT}</span>
        <p class="font-sans text-xs md:text-sm">{TAGLINE}</p>
      </div>
      <div>
        <h4 class="font-semibold tracking-tight text-xl md:text-2xl">{COLUMN_TITLE}</h4>
        <ul class="font-sans text-xs md:text-sm">
          {FOOTER_LINKS}
        </ul>
      </div>
    </div>
  </div>
</footer>
```

---

## [CHECKLIST] Soft Utility post-generation self check

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

### Token check
- [ ] Button includes: `rounded-lg border font-medium inline-flex items-center`
- [ ] Card includes: `rounded-lg border bg-white/80`
- [ ] Input includes: `rounded-lg border bg-background focus:outline-none`

### Forbidden check
- [ ] No class or pattern this style forbids

### Style rule check
- [ ] Follows this style's core rules

### Style drift check
- [ ] No default styling that conflicts with this style

### 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 Soft Utility

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