Combine the first letters of CSS properties to create class names.
display: flex → df, gap: 2rem → gap2rem.
No config, no build, just use it.
<div class="df jcc aic
gap2rem p2-4rem
bgFFFFFF br12px">
<h1 class="fs4-8rem fw900">
Hello World
</h1>
</div>/* auto-generated */
.df { display: flex }
.jcc { justify-content: center }
.aic { align-items: center }
.gap2rem { gap: 2rem }
.p2-4rem { padding: 2.4rem }
.bgFFFFFF { background: #FFF }
.br12px { border-radius: 12px }Handle all styling with HTML classes alone — no separate CSS files needed.
.card {
display: flex;
flex-direction: column;
padding: 24px;
background: #ffffff;
border-radius: 12px;
gap: 16px;
box-shadow: 0 1px 3px rgba(0,0,0,.1);
}<div class="df fdc p2-4rem
bgFFFFFF br12px
gap16px">
<!-- No CSS file needed -->
<!-- Auto-generated on save -->
</div>Combine the first letters of CSS property and value to get the class name.
No new vocabulary to memorize.
display: flex→dfjustify-content: center→jccalign-items: flex-start→aifsflex-direction: column→fdcgap: 2rem→gap2rempadding: 24px→p2-4remfont-size: 1.6rem→fs1-6rembackground: #FF5733→bgFF5733border-radius: 8px→br8pxwidth: 100%→w100pposition: absolute→pawhite-space: nowrap→wsnLearn one rule and you can infer the class name for any CSS property.
No complex setup required.
Install the VS Code extension or CLI. No config files or dependencies needed.
npm i -g atomic-css-cliCombine first letters of CSS properties to write classes. Works in any editor.
class="df jcc aic gap2rem"Save and atomic.css is auto-generated. VS Code does it instantly, CLI via watch mode.
atomic-css watch src/A production-ready utility CSS framework.
df jcc aicNo build tools, config files, or dependencies. Start instantly with VS Code extension or CLI.
gap37pxNot limited to predefined values. Use gap37px, w847px, fs1-3rem — any value you want.
gtcrfitPowerful Grid utilities with repeat, auto-fit, minmax — complex layouts in a single class.
sm-dn14 breakpoints from 420px to 2560px. Just add a prefix for responsive design.
hover-bghover, focus, disabled, checked and 32 pseudo-classes supported via prefix.
watchAutocomplete and hover preview in VS Code. CLI watch mode works with any editor.
calc-addExpress calc operations like wcalc100p-200px directly as classes. Complex math made simple.
.atomic.jsonMonorepo and multi-project support with per-project .atomic.json configuration.
MCPOfficial MCP server lets Claude, Cursor, Windsurf and other AI tools fully understand Atomic CSS.
Just add a prefix and it applies below that breakpoint.
<!-- Desktop 3col → Tablet 2col → Mobile 1col -->
<div class="dg gtcr3-1fr gap2rem
md-gtcr2-1fr
sm-gtc1fr">
<!-- Desktop only -->
<div class="db sm-dn">...</div>
<!-- Mobile only -->
<div class="dn sm-db">...</div>
</div>Other utility frameworks require learning custom vocabulary.
If you know CSS, Atomic CSS has zero learning curve.
| CSS Property | Other Frameworks | Atomic CSS | Difference |
|---|---|---|---|
| display: flex | d-flex, flexCommon practice | df | CSS abbreviation as-is, nothing to memorize |
| justify-content: center | justify-center, jc-centerCommon practice | jcc | 3 first letters — intuitive |
| padding: 2.4rem | p-3, pa3 (fixed steps)Most frameworks | p2-4rem | Use exact values — no fixed steps |
| font-size: 18px | text-lg, f5 (fixed steps)Most frameworks | fs18px | Any unit: px, rem, freely |
| gap: 37px | gap-[37px], g-4 (special syntax)Some frameworks | gap37px | No special syntax needed |
| width: calc(100% - 200px) | w-[calc(100%-200px)]Some frameworks | wcalc100p-200px | calc in a single class, no brackets |
| grid: repeat(auto-fit, ...) | Not supported or config requiredMost frameworks | gtcrfit-minmax28rem-1fr | Complex Grid without config |
| background: #FF5733 | bg-danger, bg-[#FF5733]Common practice | bgFF5733 | HEX code directly — no limits |
| hover + opacity | hover:opacity-80, :hover separateSome frameworks | hover-o80 | Pseudo-classes unified via prefix |
| Hidden below 768px | d-md-none, hidden-smCommon practice | sm-dn | Below-based — 14 breakpoints |
d-flex, flexdfCSS abbreviation as-is, nothing to memorize
justify-center, jc-centerjcc3 first letters — intuitive
p-3, pa3 (fixed steps)p2-4remUse exact values — no fixed steps
text-lg, f5 (fixed steps)fs18pxAny unit: px, rem, freely
gap-[37px], g-4 (special syntax)gap37pxNo special syntax needed
w-[calc(100%-200px)]wcalc100p-200pxcalc in a single class, no brackets
Not supported or config requiredgtcrfit-minmax28rem-1frComplex Grid without config
bg-danger, bg-[#FF5733]bgFF5733HEX code directly — no limits
hover:opacity-80, :hover separatehover-o80Pseudo-classes unified via prefix
d-md-none, hidden-smsm-dnBelow-based — 14 breakpoints
Know CSS? Use it immediately. No new vocabulary.
Class names ARE CSS properties. Infer without docs.
No fixed steps. Use 37px, 2.4rem — any value as-is.
No build config, no plugins, no setup files.
Works with VS Code extension and CLI.
Notepad, Eclipse, STS, IntelliJ — if it has a terminal, it works.
# Install
npm install -g atomic-css-cli
# One-time build
atomic-css build src/ -o assets/css
# Watch for changes — auto-generates CSS on save from any editor
atomic-css watch src/ -o assets/cssRun atomic-css watch in your terminal and CSS is auto-generated whenever you save from any editor.
Works anywhere you can write a class attribute.
Official MCP server and AI guide included.
Give the rules to AI and it writes Atomic CSS just like a human.
Add the Atomic CSS guide to your project via CLAUDE.md or prompt, and AI learns naming rules, units, responsive, pseudo-classes — everything.
Tell your AI:
"This project uses Atomic CSS. Don't write CSS files or style tags. Handle all styles with Atomic classes."
AI-generated code:
<div class="dg gtcrfit-minmax28rem-1fr
gap2rem p2-4rem">
<div class="bg111113 br12px p2rem
hover-bc6366F1 tall200msease">Connect MCP and AI can look up classes, convert CSS, and validate — all automatically.
// 1. Learn all rules
get_guide()
// 2. Class → CSS lookup
lookup_class("gtcrfit-minmax28rem-1fr")
// → repeat(auto-fit, minmax(28rem, 1fr))
// 3. CSS → Class conversion
css_to_classes("display: flex; gap: 20px;")
// → df gap2rem
// 4. Validation + suggestions
validate_classes("dfflex jc-center")
// ✗ dfflex → suggest: df
// ✗ jc-center → suggest: jccget_guideTeach AI all rules at once
lookup_classClass name → CSS output lookup
search_by_cssSearch classes by CSS property/value
css_to_classesCSS code → class auto-conversion
validate_classesClass validation + suggestions
list_classesList classes by category
How to connect:
// Remote (설치 불필요)
url: "https://atomiccss.dev/mcp"
// Local
command: "npx atomic-css-mcp"VS Code or terminal — write your first Atomic class in 30 seconds.
ext install Drangon-Knight.atomicssnpm install -g atomic-css-cli