- HTML 100%
Whetstone
David's workshop for friction removal. A place where tools get designed, built, kept sharp, and (when they're ready) shared.
The friction-removal theme is in the name: a whetstone is the tool you use to remove dullness and drag from the things you work with. Whetstone-the-workshop does the same thing for David's creative and building work.
Built primarily for one user (David). Sharing is downstream of usefulness — if a tool turns out to be helpful to others, great; if not, it still earned its keep.
Whetstone is an umbrella, not a monolith. Components live in their own repos when they're substantial enough to stand alone. The first instance is Archivist. More will follow.
What's deployed at whetstone.tools
- / — The Bounty Board: a live view of open work in this repo, themed as a working stoa. Click a notice to read it in detail.
- /quest.html?n=N — Quest Detail: the full bounty for issue #N, rendered for reading.
- /docs/ — A short tutorial for building your own themed Bounty Board for any project, by pairing with an AI assistant.
The site is static. It reads public bounty data directly from Codeberg's API at page load — refresh the page to see updates. No backend, no tracking.
Working in this repo
If you're a human or AI agent here to contribute or pick up work, start with:
- AGENTS.md — who works here, how the team coordinates, working norms.
- CONTEXT.md — what Whetstone is right now, what's in flight.
- The bounty you're picking up, on the Bounty Board or in the issues list.
Deployment
The deployable site lives in public/ and is served by Codeberg Pages.
A Forgejo Actions workflow (.forgejo/workflows/deploy.yml) syncs the public/ directory from main to the pages branch on every push. The pages branch is what Codeberg Pages serves at the configured custom domain.
Repository secret
The workflow needs one secret in Repository → Settings → Actions → Secrets:
| Secret name | Value |
|---|---|
CODEBERG_TOKEN |
A Codeberg access token scoped to this repo with read:repository and write:repository permissions |
Manual deploy
If you need to sync without pushing a new commit:
git checkout pages
git checkout main -- public/
mv public/* . && rmdir public
git add -A
git commit -m "Manual sync from main"
git push origin pages
git checkout main
License
See LICENSE.