/unsuckjs.com

Progressively enhance HTML with lightweight JavaScript libraries.

Primary LanguageHTMLMIT LicenseMIT

unsuckjs.com

Progressively enhance HTML with lightweight JavaScript 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/libraries.json following the current examples
  3. Make a PR
  4. ???
  5. Profit!

🤓 Why use coltrane to build this site?

unsuckjs.com looks like a static site (and it mostly is), but I wanted to fetch repository metadata dynamically without having to re-run a static site generator on a schedule. So, I used my personal static site framework, coltrane to write most of the content in Markdown, but still have 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. 🥹

Hacker News Discussion

🔬 Local development

  1. git clone this repo
  2. cd into the newly created directory
  3. poetry install
  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. poetry run coltrane play