Ask HN: How do you document CSS / styleguide?

2 points by uxamanda ↗ HN
I have tried a variety of methods / tools for documenting CSS over the years with a goal of creating a "living styleguide". Most methods became stale over time because they were driven from the design side (PDFs, Wikis, manually updated websites).

I recently ran across KSS (Knyle Style Sheets) which has you document CSS/SASS inline with example markup. This method makes more sense to me since it is committed with the code, so it seems like it'd stay more "alive". But, the KSS repo hasn't been updated directly in 4 years ago and doesn't seem to consider things like dark mode / css variables.

Have you tried KSS? Anyone still using it?

Is there a new tool that you've used that is not tied into a specific JS framework? e.g. Storybook seems modern but very JS heavy and 10x more complicated than KSS.

Is there a different approach that's worked for you for medium-sized, long term projects?

0 comments

[ 640 ms ] story [ 708 ms ] thread

No comments yet.