designmd.sh

designmd.sh is the public registry for DESIGN.md files — structured markdown documents that describe design patterns such as colors, typography, spacing, elevation, and component behavior in a format AI coding agents can consume before generating UI. Maintained by the VoltAgent team, the registry is community-driven and indexes DESIGN.md files sourced from public GitHub repositories. The CLI downloads files directly from their source repositories to your local machine; designmd.sh itself does not host the files.

What It Is

DESIGN.md is a convention for capturing a project's visual design language in a plain-text markdown file. When an AI coding agent or web builder reads a DESIGN.md before generating UI, it can produce output that matches the intended look and feel rather than defaulting to generic styles. designmd.sh acts as the searchable, community-curated index of these files, making it easy to discover, install, and share DESIGN.md files for a wide range of design systems — from brand analyses of well-known companies to original community-created design systems.

How the Registry Works

The registry is organized around public GitHub repositories. Anyone can submit a DESIGN.md file by publishing it to a public repo; the registry indexes it and makes it discoverable. Users install a file via the CLI:

• npx designmd.sh add <owner/repo> fetches the DESIGN.md directly from the source repository
• The registry tracks installs, bookmarks, and audits per file, surfacing the most-used entries
• Files are community-contributed reference material and are explicitly not official design files unless published by the company itself

Supported Agents and Builders

The registry homepage lists compatibility with a broad set of AI coding agents and web builders, including:

• Coding agents: Claude, Cursor, Gemini, ChatGPT, VS Code, GitHub Copilot
• Web builders: Lovable, v0, Bolt, Google Stitch, Framer, Webflow, WordPress, Wix, Squarespace, Canva, GoDaddy

CLI Setup Path

Installation requires no global setup. Running npx designmd.sh add <owner/repo> in a project directory is the primary entry point. The documentation at designmd.sh/docs covers CLI usage, the DESIGN.md format specification, and the submission process for listing new files in the registry.

Update: Maintained by VoltAgent

designmd.sh is maintained by the VoltAgent team, the same organization behind the open-source VoltAgent AI Agent Engineering Platform (MIT-licensed, TypeScript). The registry itself is a standalone web service at designmd.sh, separate from the VoltAgent framework, but shares the same team and GitHub organization. Contact for the project is available at necati@voltagent.dev.