Moving away from Tailwind, and learning to structure my CSS
134 points
6 hours ago
| 16 comments
| jvns.ca
| HN
TonyAlicea10
2 hours ago
[-]
> I got curious about what writing more semantic HTML would feel like.

I've been teaching semantic HTML / accessible markup for a long time, and have worked extensively on sites and apps designed for screen readers.

The biggest problem with Tailwind is that it inverts the order that you should be thinking about HTML and CSS.

HTML is marking up the meaning of the document. You should start there. Then style with CSS. If you need extra elements for styling at that point, you might use a div or span (but you should ask yourself if there's something better first).

Tailwind instead pushes the dev into a CSS-first approach. You think about the Tailwind classes you want, and then throw yet-another-div into the DOM just to have an element to hang your classes on.

Tailwind makes you worse as a web developer from a skill standpoint, since part of your skill should be to produce future-proof readable HTML and CSS that it usable by all users and generally matches the HTML and CSS specs. But devs haven't cared about that for years, so it makes sense that Tailwind got so popular. It solved the "I'm building React components" approach to HTML and CSS authoring and codified div soup as a desirable outcome.

Tailwind clearly never cared about any of this. The opening example on Tailwind's website is nothing but divs and spans. It's proven to be a terrible education for new developers, and has contributed to the div soup that LLMs will output unless nudged and begged to do otherwise.

reply
danaw
18 minutes ago
[-]
you're unfairly conflating things and putting the blame for a lack of care or understanding on tailwind vs on the dev themselves. nothing about tailwind forces you to build inaccessible or "div soup" apps

can tailwind be used poorly? absolutely. but that's true of any tool

i've been writing CSS for ~20 years and am quite capable with it, having used CSS, Less, SASS/SCSS, Stylus, PostCSS etc. the reason i have settled on Tailwind for the last few years is precisely because it enables me to build more robust application styling.

tailwind frees you from having to spend excessive time building abstractions of styles/classes that will invariably change. placing the styles directly into the markup that is affected by it reduces cognitive load, prevents excessively loose selectors affecting styles unintentionally and really aids in debugging. jumping into codebases with bespoke css frameworks is always more complex and fragile than a tailwind codebase for anything but the most simple sites/apps

add to that the ability to have consistent type, color and sizing scales, reduced bundle sizes, consistency for any developer who knows tailwind and a very robust ecosystem (and thus llms are very familiar with it) and tailwind is a really excellent choice for a lot of teams

tailwind is like most tools; it can be used well or poorly depending on who is using it

reply
flossly
1 hour ago
[-]
While I agree I do think there's some "aspiration of purity/correctness" in your approach that I've long let go of.

I look at the royal mess that is HTML/CSS/JS as a necessary evil, required when we want to target browsers. To me it's "just the presentation layer".

In my work I put a lot more emphasis on correctness in the db schema, or business logic in the backend.

When it comes to the messy presentation layer I prefer to write a little as possible, while still ending up with somewhat maintainable code. And for this Tailwind fits the bill really well: LLMs write it very well, new devs understand it quick, and it's quite easy to read-back/adjust the code later.

I 100% agree a Tailwind project is not the best way for a new dev to learn HTML/CSS. But then I prefer the new dev to focus on great db schemas, intuitive APIs, test-able biz logic, etc. Fiddling with the mess that's HTML/CSS is not the place where I consider human attention is best spent on (or where developers pick up skills to become much better developers).

reply
TonyAlicea10
1 hour ago
[-]
This isn't about "purity/correctness" it's about the real experience of a blind person. Accessibility means caring about the HTML.

Your comment only mentions developers as the audience of HTML authoring, as opposed to users, which is a common attitude and the core problem with Tailwind.

reply
flossly
1 hour ago
[-]
I use Tailwind and have all kinds of "screen reader" directives in my templates.

Not sure if it helps, but if we get our first blind user I will gladly make some admends to make it more usable for them.

It seems that Tailwind is now blamed for the mess that is HTML/CSS. Tailwind certainly allows for accessible designs; it may not be the ideal solution, sure, but what we aim for is "good enough".

reply
embedding-shape
21 minutes ago
[-]
> but if we get our first blind user I will gladly make some admends to make it more usable for them.

Isn't this slightly backwards? Why would blind users sign up if the platform isn't usable for them in the first place? It has to be usable for them for them to become users :)

reply
throwaway24274
18 minutes ago
[-]
It's not just blind people, but also people with reduced eyesight. As I'm getting older, I really appreciate good contrast and the possibility to zoom in without breaking the layout.
reply
u_fucking_dork
15 minutes ago
[-]
And how does tailwind or the structure of the underlying html of the page change or affect that?
reply
reaperducer
57 minutes ago
[-]
if we get our first blind user I will gladly make some admends to make it more usable for them.

Not good enough. You have to be accessible before it is needed in order to avoid legal liability.

And how do you expect to get a blind user if they already cannot use your product?

None of the doctors I build web sites for are currently blind. I know this because I talk to them regularly. But I still build the web sites for the future, when HR might hire a doctor or nurse or other person who is blind, or partially sighted, or has trouble with their muscles, or has difficulty distinguishing colors.

Doing the right thing isn't that hard. Not doing it is just lazy.

reply
flossly
48 minutes ago
[-]
You call it lazy. I call it "focus" or avoiding pre-mature optimization.

I find the "legal liability" claim hilarious... I do better than 95% of the web: as I said I HAVE some screen reader directives (just did not test it), and labels to make the app more accessible.

reply
0x3f
26 minutes ago
[-]
Sounds like you're kind of just talking your book though. Person who makes accessible sites suggests you need an accessible site. Blind people aren't the only ones who might need modifications. You could have an infinitely long list of adjustments for all kinds of disabilities, and tell me I'm lazy for not doing each of them. Why are blind people special?
reply
well_ackshually
1 minute ago
[-]
You are lazy for not doing accessibility adjustments, because accessibility isn't for blind users. It's for the deaf ones, the ones with poor eyesight, the ones with mental deficiencies, the ones with motor issues like Parkinson's, the ones browsing your site shitfaced at 4AM, and so on and so on.

Accessibility isn't a checklist to cover your ass for a percentage of the population: it's for everyone. It literally makes your website less shit. You slapping an aria-label doesn't fix things.

reply
jbreckmckye
10 minutes ago
[-]
What does Tailwind have to do with accessibility? Most significant HTML markup is block level elements. The CSS is completely orthogonal.

I feel like old-school frontend devs bring up accessibility as a kind of bogeyman.

It reminds me of the myth that CSS style X or Y breaks accessibility "because screen readers expect semantic CSS classes". Zeldman (of A List Apart) promulgated that disinformation for years, until someone actually told him screen readers don't work that way. 90% of people who use a11y as a rhetorical cudgel have never actually used AT themselves.

reply
gjsman-1000
19 minutes ago
[-]
But why would I spend any time mastering this skill when we have AI now?

Disability software that uses both the markup and the on-screen visual for decision making is likely imminent and would render most of this no longer necessary.

Claude Cowork is already doing navigation and web browsing by screenshot showing this is possible.

reply
hidelooktropic
9 minutes ago
[-]
I guarantee you no one is working on this.
reply
vehemenz
1 hour ago
[-]
A few counterpoints:

Treating markup and styles separately is great, in principle, but you'll always need additional markup for certain things. We knew this going back to the early 2000s.

There is nothing about Tailwind itself that forces you to use divs and spans instead of the appropriate HTML tag.

Documents and interfaces are different. Tailwind makes a lot more sense for interfaces. You can use Tailwind for the interface and scoped HTML selectors for other content.

Tailwind is around 4x faster and has practically no overhead compared to writing a complex CSS codebase. Whatever you think of it, this is always a benefit in its corner.

reply
efortis
46 minutes ago
[-]
Benchmarks?
reply
spiderfarmer
39 minutes ago
[-]
As someone who wrote CSS for 20 years and who was against using Tailwind because of “principles” I must say that Tailwind is just awesome. Every minute spent trying to make sense of the structure past you or your colleagues came up with is a minute that could be spent on something more important.

Every time someone says that Tailwind sucks, it’s like hearing the old me speak.

reply
mhitza
34 minutes ago
[-]
Using tailwind doesn't lead to any inherent concession of accessibility. How do you come to that conclusion?

If I look at their component library, they also do the work of including aria attributes for you https://tailwindcss.com/plus/ui-blocks/marketing/sections/pr... (first exsmple with free code I've found).

If we're not talking landing pages, which are more like digital brochures, I always start with markup and then add css classes on top.

reply
uxcolumbo
1 hour ago
[-]
What's a good source to learn how to develop like this - to create HTML / CSS structure that's accessible?

EDIT: ignore. I can see you have some links in your profile. Will check it out.

reply
antran22
46 minutes ago
[-]
> Tailwind instead pushes the dev into a CSS-first approach. You think about the Tailwind classes you want, and then throw yet-another-div into the DOM just to have an element to hang your classes on.

To be fair plopping a `div` everywhere started way before Tailwind. I blame React and the mess that is CSS in JS for this.

reply
evilduck
42 minutes ago
[-]
Divitis was a thing long before React came along. It was a common solution to styling problems even in the jQuery/Dojo days. Getting stuff to look similar across IE6 and FF before CSS3 relied heavily on divs.
reply
freedomben
1 hour ago
[-]
You're not wrong, and I mostly agree with you. I die inside when I see the div soup that a lot of sites have become. However, I think there is value in being able to have the important parts of CSS merged into the HTML a bit. Where that line is, is certainly up for debate (and I don't have the answer), but I've found a lot of my tailwind sites are more readable to me than my pre-tailwind sites, often because I don't have to context-switch and open a different file to be able to reason about the styling on an element. For big stuff the second file can be nice, but there's a lot of style tweaking that is great to be able to do right there in the HTML. Tailwind does really lead you to ignore the css file though (or keep it highly minimal), which I agree is becoming an anti-pattern.
reply
TonyAlicea10
1 hour ago
[-]
The "open a different file" reasoning piece is a common pro-Tailwind statement and I do see the upsides.

I think that upside became more prevalent in the reusable components era, whereas previously CSS was targeting an entire HTML file (and thus the reasoning was more like SQL query than "this one element's styling").

With LLMs I think this upside is much smaller now though.

reply
reaperducer
49 minutes ago
[-]
I don't have to context-switch and open a different file to be able to reason about the styling on an element

Unless you're coding on a VT100 terminal, you just put the HTML in one window and the CSS in another. Subdivide as necessary, or as your monitor space allows.

Heck, we were doing that back in 1989 on IBM PCs with MDA displays.

If your CSS is so out of control that you can't wrap your brain around it, it's time to refactor or split into individual CSS component files.

reply
skydhash
1 hour ago
[-]
It seems that everyone is forgetting the web inspector as a tool for designing web pages. You can tweak properties and styles in a live environment, and then transfer your preferences to the css files.
reply
7bit
1 hour ago
[-]
> Tailwind instead pushes the dev into a CSS-first approach. You think about the Tailwind classes you want, and then throw yet-another-div into the DOM just to have an element to hang your classes on.

I wholeheartedly disagree. That mindset is not caused by Tailwind, but by being ignorant.

You can perfectly create an HTML document with semantic meaning and the add Tailwind just as any other CSS framework or pure CSS to it.

And DIVs do not carry meaning, they are specifically to add functionality or styling, so you can throw in as many as you like. Using them abundantly isn't good style, but the way you make it sound that they're evil isn't good either.

reply
reaperducer
53 minutes ago
[-]
HTML is marking up the meaning of the document. You should start there. Then style with CSS.

This is precisely how I do it.

Code that generates HTML. Once I can see all the content on the screen in some kind of Netscape Navigator 1.0 nightmare, then I go back and add styles to make it look pretty.

It's not hard. It just requires thought and planning.

(The best planning tool I've found is a pencil and grid paper, not the web design SaaS-of-the-moment. However, it's surprisingly hard to find good pencil sharpeners these days.)

reply
bryanhogan
55 minutes ago
[-]
I have been writing a "clean" web development guide focusing on writing HTML and CSS that scales well: https://webdev.bryanhogan.com/

Maybe it's useful for people here. I don't use Tailwind or similar for styling, just CSS with modern frameworks like Astro or Svelte.

For every project I have the following CSS files:

- reset.css

- var.css

- global.css

- util.css

Other styling is scoped to that specific component or layout.

reply
aejm
53 minutes ago
[-]
Using a JavaScript framework kind of defeats the whole purpose doesn’t it?
reply
hstaab
12 minutes ago
[-]
css modules with react are really nice to work with. Plain css scoped to a component. The two arnt always at odds
reply
JimDabell
56 minutes ago
[-]
One thing that has always struck me about Tailwind is that practically every argument its proponents use more or less boils down to “I never learnt CSS beyond a junior level”. It’s super common to hear Tailwind advocates say things like “Without Tailwind, we would just have one big disorganised CSS file that always grows uncontrollably and ends up with loads of obsolete stuff in it and !important everywhere! Tailwind is so much better!”.

CSS is a skill just like any other technical skill. If all you do is learn the bare minimum so you can bodge things until you get something that looks right, then your ambitions are going to outpace your ability to keep things organised very quickly.

reply
timr
44 minutes ago
[-]
It's worse than that; the common arguments for Tailwind literally derive from total ignorance of how CSS is made to work, and a disposal of guidelines that developers would worship in any other context (i.e. Don't Repeat Yourself).

It's really frustrating to be talking with someone about Tailwind and CSS, and realize that not only do they not know what "cascading" means, they never even considered the concept might be useful in the context of a stylesheet.

reply
u_fucking_dork
7 minutes ago
[-]
The common arguments against Tailwind usually derive from total ignorance of working with CSS on large scale projects with many team members.

And when this is pointed out you’ll usually get replies that just hand wave it away as not a problem, as if things like BEM were invented for no reason.

reply
chistev
54 minutes ago
[-]
Isn't Tailwind easy to understand when you look at the codebase, rather than putting in more effort to learn a pure CSS codebase? Isn't that part of the argument of Tailwind being easier to scale?
reply
JimDabell
47 minutes ago
[-]
> Isn't Tailwind easy to understand when you look at the codebase, rather than putting in more effort to learn a pure CSS codebase?

No, I don’t think that’s the case at all.

reply
reaperducer
47 minutes ago
[-]
Isn't that part of the argument of Tailwind being easier to scale?

I think that was true at the beginning. But Tailwind is quickly approaching the multi-headed hydra it was trying to replace.

reply
bdcravens
22 minutes ago
[-]
Isn't the same true of those who use a library that wraps SQL?
reply
Alifatisk
4 minutes ago
[-]
Oh, have we reached the end of the pendulum swing and are now swinging back to ordinary CSS again.
reply
KolmogorovComp
1 hour ago
[-]
For me Svelte and LLM completely removed my need for Tailwind. Turns out I was using it primarily to avoid CSS collision, and (to me) more logical syntax, rather than the self-imposed constraints.
reply
esafak
52 minutes ago
[-]
Why did Svelte affect your stance towards Tailwind?
reply
agus4nas
7 minutes ago
[-]
Curious if you noticed any performance differences after switching — did bundle size or load times change at all?
reply
grzes
7 minutes ago
[-]
tailwind is an anti-pattern that breaks separation of concerns rule. i'm amazed how it became so popular.
reply
pjmlp
1 hour ago
[-]
Tailwind crazy adoption is something that makes me happy to nowadays be doing mainly boring stuff in distributed cloud systems and agents, instead of WebUIs.
reply
Polarity
9 minutes ago
[-]
oh is this stupid hype of defining design in html with a random framework finally over? thank god!
reply
neya
1 hour ago
[-]
So, we're just going a full circle back now. Interesting.
reply
eYrKEC2
18 minutes ago
[-]
_tailwind_ was the full circle. We had individual controls. We went to semantic controls, then back to individual controls a la tailwind.
reply
4lx87
46 minutes ago
[-]
Hope so. I’d like to be able to read the HTML templates again.
reply
zamalek
12 minutes ago
[-]
What I don't get about tailwind is: why not just use the style attribute at the point?
reply
0x3f
9 minutes ago
[-]
It's much more verbose and can't do everything Tailwind can anyway.

E.g. how do you style a child on parent hover with the style attribute?

reply
stephbook
1 hour ago
[-]
I'm lucky to have learned the web with Angular 2.x

It scopes CSS to components by default, and keeps HTML, CSS and JavaScript seperate.

reply
CharlieDigital
1 hour ago
[-]
Vue single-file components (SFC[0]) still works this way.

    <template>
    <!-- Largely just HTML -->
    </template>

    <script setup lang="ts">
    // JS/TS as you would expect
    </script>

    <style scoped>
    /* Component scoped styles here */
    </style>
Very clean, easy to understand, and (as someone who started hand writing DHTML) it still feels very much like DHTML with more convenience and modern affordances.

[0] Vue SFC docs: https://vuejs.org/guide/scaling-up/sfc.html

reply
NetOpWibby
20 minutes ago
[-]
Nature is healing
reply
BoredPositron
1 hour ago
[-]
I am so happy that the only time I have to touch css anymore is for simple internal tools and pico is usually enough for them.
reply
hit8run
55 minutes ago
[-]
Thats why I maintain the successor to tachyons: https://tachyonsneo.com No build pipeline. Resort to CSS when utilites make no sense. No lock in.
reply
keybits
20 minutes ago
[-]
Can you clarify how this relates to Tachyons - do all Tachyons features work? Or is it a subset of Tachyons?
reply
villgax
2 hours ago
[-]
Relying on React or Typscript in LLM era seems very stupid, just have the LLM setup whatever dom manipulation you want and have it write decent JS without slop. Far more offline compatible development almost negligible supply chain issues as well. At least ones you can control.
reply
bel8
10 minutes ago
[-]
React maybe (because there are alternatives).

But for mid/large projects, I find that TypeScript brings sanity to JavaScript.

I love some quick and dirty JS project. But after a certain project size I begin the see runtime errors like undefined, NaN, 'false/true' concatedted to URLs, and so on. TypeScript eliminates a ton of those.

reply
jfengel
1 hour ago
[-]
Layout design issues are orthogonal to choice of language and framework. You can apply the article's approach to plain static pages and to SPAs.

I tend to work closer to the latter end and find that both React and Typescript are extremely helpful to make my code extensible and maintainable. YMMV.

reply
freedomben
1 hour ago
[-]
This works great for small sites/apps, but really starts to fall apart if/when it gains complexity where React starts to make sense. I've tried a few times to "just use plain javascript" with the LLM and initial results are often much better, but if the site grows a bit too complex, the LLM starts making a lot of mistakes and it can be hard to reason about as a human and get it on the right track. That hasn't been the case with the React apps IME.
reply
dwb
1 hour ago
[-]
This makes no sense. LLMs and agents benefit from (good) abstraction as much as humans do.
reply
thekingshorses
1 hour ago
[-]
I agree, specially for simple apps. it's much easier to upgrade if you are not relying on 3rd party or NPM's. Don't have to worry about code injections.

I have these two https://reddit.premii.com and https://hn.premii.com/ both works without any changes. Reddit will stop working once they kill the apis but until then it will work.

reply
wakamoleguy
1 hour ago
[-]
What a strange take. LLMs produce plausibly correct output, which is exactly where plain JavaScript and DOM manipulation will result in a spaghetti mess.

Frameworks like React that add structure to the data flow, component encapsulation, and a huge repertoire of patterns to train on, plus Typescript for immediate compile-time feedback loops… those are what LLMs thrive on.

reply