https://github.com/adamghill/unsuckjs.com
Progressively enhance HTML with lightweight JavaScript libraries.
https://github.com/adamghill/unsuckjs.com
ajax html javascript
Last synced: 3 months ago
JSON representation
Progressively enhance HTML with lightweight JavaScript libraries.
- Host: GitHub
- URL: https://github.com/adamghill/unsuckjs.com
- Owner: adamghill
- License: mit
- Created: 2021-07-20T12:40:12.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-12-06T04:15:16.000Z (7 months ago)
- Last Synced: 2025-03-28T18:16:16.576Z (4 months ago)
- Topics: ajax, html, javascript
- Language: HTML
- Homepage: https://unsuckjs.com
- Size: 309 KB
- Stars: 136
- Watchers: 5
- Forks: 23
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
1. Update `data/js.json` or `data/css.json` following the current examples
1. Make a PR
1. ???
1. Profit!
## 🤓 Why use [coltrane](https://coltrane.adamghill.com) to build this site?
[unsuckjs.com](https://unsuckjs.com) and [unsuckcss.com](https://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](https://coltrane.readthedocs.io) 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](https://docs.astral.sh/uv/getting-started/installation/)
1. `git clone` this repo
1. `cd` into the newly created directory
1. Create a personal access token at https://github.com/settings/tokens
1. `cp .env.example .env`
1. Update `.env` with your GitHub username and personal access token that was just created
1. `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