# Impeccable > Impeccable is an open-source design skill, CLI, browser extension, and website for improving AI-generated frontend design with 24 commands, live browser iteration, and deterministic anti-pattern detection. Use the website pages below as the current public documentation. Use the GitHub repository when you need source code, implementation details, tests, or release history. The fastest install path is `npx impeccable install` from a project root. ## Start Here - [Home](https://impeccable.style/): Product overview, install options, supported AI coding harnesses, and download entry points. - [Designing with Impeccable](https://impeccable.style/designing): The end-to-end workflow from setup and brief to iteration, polish, and maintenance. - [Documentation](https://impeccable.style/docs): Task-based guides for building and improving interfaces, image setup, checks, and command reference. - [Install & first steps](https://impeccable.style/tutorials/getting-started): Install Impeccable, save product context, then build something new or improve an existing design. - [Live Mode](https://impeccable.style/live-mode): Browser-based UI iteration from a named element in chat or visual picking, with generated variants and source writeback. - [Slop](https://impeccable.style/slop): Catalog of AI-generated UI anti-patterns and the detection overlay behind the CLI, extension, and critique workflow. - [Enable image generation](https://impeccable.style/docs/image-generation): Built-in coding-tool support, OPENAI_API_KEY fallback, billing, readiness checks, and troubleshooting. ## Design Workflows - [Build something new](https://impeccable.style/docs/new-work): Choose a direction, compare comp-led and code-led workflows, and build a new page or redesign. - [Improve an existing design](https://impeccable.style/docs/improve-design): Review a page, make focused improvements, and decide when to redesign. - [Work with a design system](https://impeccable.style/docs/design-system): Record the current system, reuse components, and keep future work consistent. - [Tutorials index](https://impeccable.style/tutorials): Step-by-step guides for installation, live iteration, and visual critique. - [Iterate on UI with Live Mode](https://impeccable.style/tutorials/iterate-live): Use `/impeccable generate` or `/impeccable live` against a running dev server to compare and accept UI variants. - [Critique with the visual overlay](https://impeccable.style/tutorials/critique-with-overlay): Combine `/impeccable critique`, deterministic detection, and the browser overlay. ## Checks and Reference - [Design Context](https://impeccable.style/docs/context): PRODUCT.md, DESIGN.md, surface briefs, the four visitor modes, the platform axis, and the design sidecar. - [Config and ignores](https://impeccable.style/docs/config): `.impeccable/config.json`, detector exceptions, inline ignore comments, and project roots. - [Detector CLI](https://impeccable.style/docs/detector): `npx impeccable detect` over files, directories, and rendered URLs. - [Design hooks](https://impeccable.style/docs/hooks): Provider-native hooks that run the detector as the agent edits UI files. - [Doctor](https://impeccable.style/docs/doctor): Find and repair drift between a project's Impeccable files and the installed version. ## Command Reference - [impeccable](https://impeccable.style/docs/impeccable): Main command for recommendations, freeform design work, and loading the full design guide. - [init](https://impeccable.style/docs/init): Save product context in `PRODUCT.md` and establish setup preferences; use `document` separately for the visual system. - [shape](https://impeccable.style/docs/shape): Run a discovery interview and produce a design brief before code. - [live](https://impeccable.style/docs/live): Select browser elements, generate UI variants, and write accepted changes back to source. - [generate](https://impeccable.style/docs/generate): Name an element, direction, and optional count in chat; compare variants in the browser and accept one into source without manual picking. - [document](https://impeccable.style/docs/document): Generate a `DESIGN.md` file from the current visual system. - [extract](https://impeccable.style/docs/extract): Consolidate repeated patterns, components, and design tokens. - [critique](https://impeccable.style/docs/critique): Evaluate UX, hierarchy, cognitive load, brand fit, and anti-patterns. - [audit](https://impeccable.style/docs/audit): Run technical checks for accessibility, performance, theming, responsiveness, and anti-patterns. - [polish](https://impeccable.style/docs/polish): Perform a final quality pass for alignment, spacing, consistency, and micro-details. - [harden](https://impeccable.style/docs/harden): Add production resilience for errors, edge cases, i18n, and text overflow. - [optimize](https://impeccable.style/docs/optimize): Improve UI performance, rendering, images, animations, and bundle cost. - [adapt](https://impeccable.style/docs/adapt): Adapt designs across screens, devices, contexts, and platforms. - [clarify](https://impeccable.style/docs/clarify): Improve UX copy, labels, errors, empty states, and instructions. - [onboard](https://impeccable.style/docs/onboard): Design onboarding, first-run experiences, empty states, and activation paths. - [typeset](https://impeccable.style/docs/typeset): Improve typography, font choices, hierarchy, sizing, weight, and readability. - [layout](https://impeccable.style/docs/layout): Improve composition, spacing, rhythm, alignment, and visual hierarchy. - [colorize](https://impeccable.style/docs/colorize): Add strategic color without falling into generic AI palettes. - [animate](https://impeccable.style/docs/animate): Add purposeful motion, transitions, feedback, and reduced-motion support. - [delight](https://impeccable.style/docs/delight): Add memorable details and moments of joy without compromising usability. - [bolder](https://impeccable.style/docs/bolder): Push safe designs toward stronger impact. - [quieter](https://impeccable.style/docs/quieter): Reduce visual intensity while preserving quality. - [distill](https://impeccable.style/docs/distill): Strip unnecessary complexity and focus the interface. - [overdrive](https://impeccable.style/docs/overdrive): Build ambitious effects such as shaders, spring physics, and scroll-driven reveals. ## Developer Resources - [GitHub repository](https://github.com/pbakaus/impeccable): Source code, tests, issues, pull requests, and release workflow. - [Repository README](https://github.com/pbakaus/impeccable#readme): Package overview, command list, install methods, and supported harnesses. - [Changelog](https://impeccable.style/changelog): Release notes for the skill, CLI, extension, and detector. - [FAQ](https://impeccable.style/faq): Installation paths, update commands, pinning, troubleshooting, and harness-specific setup. ## Optional - [Neo Mirai case study](https://impeccable.style/cases/neo-mirai): Example of Impeccable turning generated references into a shipped website. - [Design system](https://impeccable.style/design-system): Public style system reference for the Impeccable website itself. - [Privacy](https://impeccable.style/privacy): Website analytics, download logging, and browser extension privacy notes.