Skip to documentation
oh-my-design
Getting started

FIRST 5 MINUTES

Install, verify, make one visible change.

The fastest successful path is deliberately short. Install the bundle, let doctor check the real files, then ask for one product surface.

Before you begin

  • 01 / 03

    Node.js 18 or newer

    Ready20+
  • 02 / 03

    A project repository

    Readygit
  • 03 / 03

    Claude Code, Codex, OpenCode, or Cursor

    ReadyAI

Quick start

  1. 01

    Open your project root

    The project-level install keeps the design context versioned with the product.

  2. 02

    Install the bundle

    Interactive mode detects the tools already present and defaults to the complete product bundle.

    npx oh-my-design-cli@latest
  3. 03

    Reload and verify

    Restart your coding agent so it discovers the new skills. Doctor reports missing catalogs, agents, or DESIGN.md instead of declaring a false green.

    npx oh-my-design-cli@latest doctor
  4. 04

    Ask for the first outcome

    Start with a concrete surface. The agent will inspect the repository before it asks for design decisions.

    Improve the home screen using our DESIGN.md. Preserve behavior and verify the result.

Non-interactive channel installs

Claude Code

Installs skills, sub-agents, catalog, and safely merged project hooks.

npx oh-my-design-cli@latest install-skills --agent claude-code --all

You are done when the product changed, not when installation succeeded.

A healthy first run leaves a visible UI improvement, a project DESIGN.md, and a clear next prompt. The installer is only activation infrastructure.