Home
cd ../playbooks
Developer ToolsIntermediate

Distinctive Frontend Design

Design lead guidance for building frontends that don't read as AI-generated — deliberate palette, typography, and layout choices grounded in the actual subject, with a built-in self-critique pass before you write code.

5 minutes
By AnthropicSource
#frontend#ui-design#design-system#typography#css#official

Every AI-built landing page looks the same three ways: warm cream with a serif headline, near-black with one neon accent, or a hairline-rule broadsheet layout. Your product isn't generic — why does its interface look like it was assembled from the same three templates as everyone else's?

Who it's for: full-stack developers who can build but struggle with visual design, indie hackers shipping without a designer, teams tired of their product looking AI-generated, developers building landing pages, dashboards, or marketing sites who want a distinctive look

Example

"Design a landing page for our climate data API" → A two-pass process: first a compact token system (4-6 named hex colors, two type roles, a layout concept, one signature element) grounded in the actual subject matter, then a self-critique pass that checks the plan against the three most common AI-design defaults and revises anything that reads as generic before a single line of code gets written

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

Or install from your terminal:
npx ccplaybooks add distinctive-frontend-design
# Distinctive Frontend Design

## Your Role

Approach this as the design lead at a small studio known for giving every client a visual identity that could not be mistaken for anyone else's. This client has already rejected proposals that felt templated, and is paying for a distinctive point of view: make deliberate, opinionated choices about palette, typography, and layout that are specific to this brief, and take one real aesthetic risk you can justify.

---

## Ground it in the subject

If the brief doesn't pin down what the product or subject is, pin it yourself before designing: name one concrete subject, its audience, and the page's single job — and state your choice.

Get new playbooks like this one

One email a week with new Claude Code workflows. Free, like everything here.

No spam. Unsubscribe anytime.

README.md

What This Does

A design-lead persona for frontend work that names the three visual patterns AI output clusters around by default — and explicitly avoids reproducing them unless your brief actually calls for one. Works in two passes: brainstorm a compact design token system grounded in your subject matter, then critique that plan against the generic defaults before writing any code. Builds to an accessibility and responsiveness floor without you having to ask for it separately.


Quick Start

Step 1: Navigate to Your Project

cd ~/your-project

Step 2: Download the Template

Click Download above, then:

mv ~/Downloads/CLAUDE.md ./

Step 3: Design Something

claude

Then ask: "Design a [page/component] for [what it's actually for]" — the more specific the subject, the more distinctive the output.


The Three AI-Design Defaults This Avoids

Named explicitly so Claude can check its own output against them:

  1. Warm cream background (#F4F1EA-ish) with a high-contrast serif and a terracotta accent
  2. Near-black background with one bright acid-green or vermilion accent
  3. Broadsheet layout — hairline rules, zero border-radius, dense newspaper columns

All three are legitimate for some briefs. The point isn't banning them — it's that they show up regardless of subject when nothing steers the design elsewhere. Where your brief specifies a direction, it always wins, even if that direction happens to be one of these three.

The Two-Pass Process

Pass 1 — brainstorm a token system: 4–6 named hex colors, two-plus type roles (a restrained display face, a body face, an optional utility face), a layout concept sketched in prose and ASCII wireframes, and one signature element the page will be remembered by.

Pass 2 — critique before building: check the plan against what a generic version of the same prompt would produce. Anything that reads as the default gets revised, with the change and reasoning stated explicitly. Only after this pass does code get written.

Tips & Best Practices

  • Ground it in the actual subject — the subject's own materials, vernacular, and world are where distinctive choices come from, not abstract design theory
  • Spend boldness in one place — one signature element, quiet and disciplined everywhere else
  • Numbered markers (01/02/03) need a real sequence to justify them — don't default to them just because they look organized
  • Copy is design material — write from the user's side of the screen, active voice, one job per element
  • Quality floor is non-negotiable: mobile-responsive, visible keyboard focus, prefers-reduced-motion respected

Watch Out For

CSS selector specificity conflicts — a type-based selector like .section and an element-based one like .cta can silently cancel each other out, most often around section padding and margins.

$Related Playbooks

Developer Tools

Network Issue Debugging

Apply falsification-first, layered isolation to pin down the responsible network layer for connection resets, SSE stalls, and fixed-time drops — instead of stacking assumptions.

20 minutes
Advanced
Developer Tools

Docs Cleaner

Consolidate redundant documentation while preserving all valuable content — merge overlapping files, reduce sprawl, and cut bloat without losing anything important.

10 minutes
Beginner
Developer Tools

Database Sync Manager

Automate database synchronization, replication, migration, and cross-platform data integration

10 minutes
Advanced
Developer Tools

Developer Presentation Builder

Create developer-focused presentations with live code demos and diagrams using Slidev.

10 minutes
Advanced
Developer Tools

DevOps Automation Assistant

DevOps and IT Ops automation - CI/CD, monitoring, incident management, and infrastructure workflows

10 minutes
Advanced
Developer Tools

Discord Bot Builder

Discord bot development - community management, moderation, notifications, and AI integration

10 minutes
Advanced
Developer Tools

Docker Containerization

Containerize applications with production-ready Dockerfiles, Docker Compose configurations, and deployment scripts for Next.js, React, and Node.js projects.

15 minutes
Intermediate
Developer Tools

DevOps Server Manager

Manage servers, Docker containers, VMs, and network infrastructure through Claude Code via SSH. Keep your entire infrastructure documented in markdown files.

15 minutes
Advanced
Developer Tools

ETL Pipeline Builder

Design and automate Extract, Transform, Load data pipelines for data integration and analytics

10 minutes
Advanced
Developer Tools

Error Message Explainer — Decode Any Error in Plain English

Paste any error message and get a plain-English explanation, root cause diagnosis, and step-by-step fix. Works with Python, JavaScript, Docker, Git, and any CLI error.

5 minutes
Beginner
Developer Tools

Building Animations in Expo and React Native

A construction discipline for React Native motion: a frequency gate that produces zero lines of code when nothing should animate, a cheapest-tool-that-fits selection table, spring/easing values instead of guesses, and the JS-thread rules that separate 60fps from 20fps on a real device.

10 minutes
Advanced
Developer Tools

Explanatory Coding Mode

Get educational insights about implementation choices and codebase patterns as Claude works — formatted, codebase-specific commentary woven into the session, not a generic tutorial.

2 minutes
Beginner

Browse all Developer Tools playbooks →