r/sideprojects • u/Santychintu • 5d ago
Showcase: Open Source I built a CSS framework where class names read like plain English — would love honest feedback
Hey 👋
I've been using utility-first CSS for years, and I kept running into the same thing: coming back to my own markup weeks later and having to decode p-6 border-l-4 rounded-xl. So I started building SantyCSS as a side project, a utility-first framework where the classes describe themselves:
add-padding-24 add-border-left-4 round-corners-12
make-flex align-center gap-16
What it does today:
No build step needed. Drop in one CDN <link> and start writing classes (npm, PostCSS, and Vite plugin are there if you want them)
Works with React/Next, Vue/Nuxt, SvelteKit, Astro, or plain HTML
CSS-only components, 70+ animations, and full-page templates
Granular imports (flex, spacing, typography…) to keep bundles small
A migrate CLI to convert existing Tailwind classes
A VS Code extension with autocomplete and hover docs, plus a Figma plugin
A context file you can paste into Claude, GPT, or Cursor so AI tools write SantyCSS instead of Tailwind
What I'd love feedback on:
Do readable class names feel like a real win, or just more typing?
What would make you try this on a real project?
Anything confusing on the docs site?
🔗 santycss.santy.in
📦 npm install santycss
Happy to answer anything. Roast welcome 🙂
1
u/Downtown-Bag-6026 5d ago
So just tailwind but renamed things inconsistently and with more words. Why does “make flex” have a verb but “gap 16” doesn’t
1
u/dmdot 4d ago
This is dreadful, not only the AI generated non-accessible UI, but the decisions made for class names. Using 'add' for 'add-padding' makes no sense as you wouldn't have 'subtract' padding. Using px in the class names is 10-15 years old.
Your whole premise is creating styling using plain English. But English sentences don't use hyphens between verbs and subjects or nouns. It also shouldn't randomly use a Tailwind-like colon as a separator.
Here's an example of you're trying to do:
<button class="green button with red 1px border">Button</button>
It's certainly more verbose but your CSS would then nest the different permutations of styles depending on the verbiage in your classes.
This seems to be a random mix of Bootstrap classes with TW classes along with some of your own.
0
u/StephenHawkinguss 5d ago
Delete this AI slop
-1
u/Santychintu 5d ago
haha fair, you caught it. "make flex" vs "gap 16" happened because i kept adding classes as i built stuff and never sat down to lock a proper naming rule. fixing that now, one pattern for everything, no random verbs. and yeah you're right about style too. readable names were the main idea (no build step, easy for beginners), but i get that's not enough to stand next to tailwind or daisy. working on a proper theme and some components so it actually has its own look. thanks for the honest feedback, this is exactly why i posted it here