Skip to content
don’t make it ugly
All resources

GuideTools

Josh W. Comeau's blog

Interactive, deeply explained articles on CSS, layout, animation and polish.

Visit website (opens in a new tab)
Preview of Josh W. Comeau's blog

What it is

Josh Comeau writes some of the best educational content on the web about CSS and front-end craft: the interactive guides to Flexbox and Grid, a modern CSS reset, designing beautiful shadows, spring animations, and many details of building things that feel good. Free articles; paid courses.

Why it’s here

The articles on shadows, the CSS reset and "designing beautiful focus states" are worth handing to an agent verbatim. The interactive guides are the best way to learn layout yourself.

Best for

  • learning CSS properly
  • shadow and depth
  • focus states
  • a good CSS reset

Can my agent use this?

Agent good agent friendliness

Yes. The articles are public and detailed. Link a specific article (for example the CSS reset or the shadows guide) and ask your agent to apply it.

Good: Publicly accessible and useful to reference, but the agent will need to interpret it rather than install it.

Access methods

  • Public website
  • Copy/paste

Related resources

  • Refactoring UI
    Preview of Refactoring UI

    Refactoring UI

    The book that teaches developers to design, by the creators of Tailwind.

    Guidelimited agent friendliness
    Staff pickUsed by me
  • Laws of UX
    Preview of Laws of UX

    Laws of UX

    The psychology principles behind good interfaces, one page each.

    GuideFreegood agent friendliness
  • Accessible Palette
    Preview of Accessible Palette

    Accessible Palette

    Build colour scales where every step has predictable, accessible contrast.

    ToolFreegood agent friendliness
  • Chrome DevTools MCP
    Preview of Chrome DevTools MCP

    Chrome DevTools MCP

    Let your agent inspect, debug and profile a live Chrome tab.

    MCP serverFreeOpen sourceexcellent agent friendliness