EcommerceCursorClaude CodeCodex

Ecommerce

A minimal, editorial ecommerce DESIGN.md: bright neutral canvas, near-black ink, generous whitespace, and a strict product grid where imagery is the hero.

Tokens
13
Components
8
Themes
Light + Dark
Responsive
3 breakpoints

Preview Lab

Live

Inspect theme and responsive behavior

Design system overview

A quiet storefront that puts the product first

A minimal, editorial ecommerce system: bright neutral canvas, near-black ink, generous whitespace, and a strict product grid where imagery is the hero.

The template defines the working system behind the preview: product grid rhythm, buy-box anatomy, availability states, cart feedback, responsive collapse, keyboard focus, and implementation rules for AI coding agents.

Primary

One clear action

Active navigation and primary controls

Typography

$482,900

Total revenue

+8.2% this month

Controls

Search customers…

Status

HealthyHealthy
PendingPending
FailedFailed

Tokens

Color system

Named roles from the template contract. Every swatch is keyboard-copyable and includes its intended use, so the palette stays meaningful outside this preview.

Brand

Surfaces

Text

Semantic

Source file

Raw DESIGN.md and export formats

This is the single canonical source view. Anonymous visitors see a short preview; signed-in users get the complete Markdown and generated implementation formats.

# Ecommerce DESIGN.md

## Product feel

Build a minimal, editorial storefront where product imagery is the hero and the UI recedes.
Use a bright neutral canvas, near-black ink for text and primary actions, generous whitespace,
and a strict typographic grid. Restraint reads as premium; decoration reads as noise.

## Color system

### Brand
- Ink: #111111 β€” text, primary buttons, active state
- Surface: #ffffff β€” page and card background

### Surfaces
- Canvas: #fafafa β€” page background behind cards
- Subtle: #f5f5f5 β€” hover rows, section bands
- Panel: #f0f0f0 β€” quiet fills, image placeholders
- Border: #e5e5e5 β€” hairline separators and card outlines

### Text
- Text Primary: #111111 β€” headings, prices, body
- Text Secondary: #666666 β€” labels, descriptions, meta
- Text Muted: #999999 β€” captions, disabled, placeholders

### Semantic
- Success / In stock: #16a34a
- Sale / Danger: #dc2626
- Warning / Low stock: #d97706
- Info: #2563eb

## Dark mode

- Canvas: #0d0d0d, Surface: #171717, Border: #262626
- Text Primary: #f5f5f5, Text Secondary: #a3a3a3
- Keep product images unmodified; never tint imagery for theme.

## Typography

- Display Font: Inter (or a refined grotesk)
- Body Font: Inter
- Code Font: JetBrains Mono
Checking your session…

Use with AI Coding Agents

Copy one of these prompts into your AI coding agent to apply the Ecommerce DESIGN.md design system to your project. The DESIGN.md file in your repo root is the source of truth.

# .cursor/rules (or DESIGN.md)
You are working in a project that uses the Ecommerce DESIGN.md design system.

Read the DESIGN.md file in this project root and follow it strictly when generating UI.
Match the brand's exact colors, typography, spacing scale, and border radius.
Do not create generic Tailwind UI β€” apply the visual language from DESIGN.md.

Key rules:
- Use the defined color palette, not arbitrary hex values
- Apply the correct font family and weight scale
- Follow spacing tokens (4/8/12/16/24/32px scale)
- Match component patterns: buttons, cards, inputs, badges as specified

More templates

Explore other ready-to-use DESIGN.md templates for your next project.

Frequently Asked Questions

Can I use the Ecommerce DESIGN.md with Cursor, Claude Code, or Codex?

Yes. Copy the DESIGN.md file into your project root and reference it in your agent rules. For Cursor, add it to .cursor/rules. For Claude Code, include it as CLAUDE.md. For Codex, add it to your system prompt. The agent will read it and apply the Ecommerce visual system to any UI it generates.

Is this an official Ecommerce file?

No β€” this is an independent reference created for AI coding agent compatibility. It is not officially endorsed by Ecommerce. The visual system was analyzed and documented to help AI agents produce UI that matches the Ecommerce aesthetic. Always verify against official Ecommerce documentation.

What is a DESIGN.md file?

A DESIGN.md file is a Markdown document that describes a product's visual design system in a format that AI coding agents can read and follow. It captures color palettes, typography, spacing, component patterns, and usage rules β€” giving AI agents like Cursor, Claude Code, and Codex a source of truth for consistent UI generation.

Can I use the Ecommerce color tokens and visual style in my own project?

The design tokens and visual patterns documented here are for reference and AI agent guidance. If you are building a project inspired by the Ecommerce visual style, ensure your use is consistent with Ecommerce's brand guidelines and any applicable trademark or copyright rules. This file helps AI agents understand a style β€” it does not grant license to use proprietary brand assets.

How do I add this to my project?

Download the DESIGN.md file (requires free account) and place it in your project root. Then tell your AI agent to read it: "Read the DESIGN.md file in this project and follow its design system when generating UI." The agent will pick it up automatically in most modern AI coding tools.