design-bites

CLI to install DESIGN.md files for 270+ websites — design systems decoded for AI agents.

design-bites is a zero-dependency CLI that downloads curated DESIGN.md files from the design-bites repository on demand. Drop one into your project and point your AI agent at it for design-consistent UI generation.

Unlike template-bundled CLIs, design-bites fetches everything at runtime — so the tarball stays tiny and the catalog is always fresh.

What is a DESIGN.md?

A DESIGN.md is a concise, machine-readable description of a website's visual design system: colors, typography, spacing, component patterns, motion, and voice. It's written to be handed to an AI coding agent as a design reference, so the agent produces UI that actually looks intentional instead of generic.

Browse the full catalog at sparkbites.dev/design-bites.

Install

No install required — use npx:

npx design-bites add linear.app

Or install globally:

npm install -g design-bites
design-bites add linear.app

Usage

design-bites add <domain>     # Download DESIGN.md for a domain
design-bites list             # List all available domains
design-bites search <query>   # Fuzzy search the catalog
design-bites --help
design-bites --version

Examples

# Add Linear's design system to the current project
npx design-bites add linear.app

# Find all sites with "stripe" in the name
npx design-bites search stripe

# See everything available
npx design-bites list

Where files land

• If ./DESIGN.md does not exist → written to ./DESIGN.md
• If ./DESIGN.md already exists → written to ./{domain}/DESIGN.md

After adding, tell your AI agent:

"Use DESIGN.md as the design reference for this UI task."

Environment variables

| Variable | Description | |---|---| | DESIGN_BITES_TELEMETRY_DISABLED | Set to 1 or true to disable anonymous install telemetry. | | DESIGN_BITES_TELEMETRY_URL | Override the telemetry endpoint (defaults to https://sparkbites.dev/api/cli/installs). |

Telemetry is fire-and-forget, runs with a 2-second timeout, and only sends: domain, cliVersion, command, installMode, nodeVersion, and platform. No personal data is collected.

Requirements

• Node.js 18+ (uses native fetch)

Links

• Catalog: sparkbites.dev/design-bites
• Source of DESIGN.md files: github.com/educlopez/design-bites
• Sparkbites: sparkbites.dev

License

MIT © Eduardo Calvo Lopez