unsuckjs.com

unsuckjs.com / unsuckcss.com

Progressively enhance HTML with lightweight JavaScript/CSS libraries. No build tools and no compiling necessary. Most libraries should be 10 KB or less (minified).

? Why?

Sometimes you don't need an entire SPA framework just to load a progress spinner.

? Shouldn't this just be an awesome repo?

Yeah, probably.

Add a new library

1. Fork this repo
2. Update data/js.json or data/css.json following the current examples
3. Make a PR
4. ???
5. Profit!

? Why use coltrane to build this site?

unsuckjs.com and unsuckcss.com look like static sites (and they mostly are), but I wanted to fetch repository metadata dynamically without having to re-run a static site generator on a schedule. So, I used coltrane which gives the flexibility of using Django templatetags for server-side functionality. It's the best of both worlds.

Also... because it's my site and I wanted to. ?

? Local development

1. Install uv
2. git clone this repo
3. cd into the newly created directory
4. Create a personal access token at https://github.com/settings/tokens
5. cp .env.example .env
6. Update .env with your GitHub username and personal access token that was just created
7. uv run coltrane play; note: this will take a while on the first load because it loads a lot of data from the GitHub API