about
une.haus is a platform for unicyclists to share tricks, compete in games, organize tournaments, and connect with each other.
core features
- tricks — browse a comprehensive trick encyclopedia with detail pages showing full trick info, videos, and prerequisites; land tricks with video proof
- games — three collaborative games: rack it up (post creative sets weekly and reply to others), back it up (match the last trick then set a new one, building evolving chains), and stack it up (nail every trick in the stack then add your own to the end)
- vault — explore unicycle.tv videos with community metadata curation, rider attribution, and filtering by discipline
- posts — share stories in posts with tags (freestyle, street, trials, etc.), leave comments, and like content
- tourneys — create and manage bracket-style tournaments with live tournament features
- social — find riders around the world on the map, follow other players, and stay connected
tech stack
hosting
une.haus runs on cloudflare workers — pushing to main is the deploy. the worker (unehaus), its d1 database, and the custom domain are all cloudflare-managed; there is no server to provision. see DEPLOY.md for the pipeline.
getting started
bun install
cp .env.example .env
git config core.hooksPath .git-hooks
bun dev
git config core.hooksPath .git-hooks enables a post-checkout hook that
symlinks the gitignored .env files into any new git worktree (see
.git-hooks/post-checkout). worktrees don't inherit gitignored files, so
without it integration tests and bun dev fail env validation inside a fresh
worktree. it's a local git setting, so each clone runs it once.
scripts
| command | description |
|---|
bun dev | apply local migrations and start the dev server (local D1 starts empty, see below) |
bun run build | build for production |
bun start | run production server |
bun run lint | lint |
bun run format | format with oxfmt |
bun run check | lint with auto-fix and format |
bun run typecheck | type check |
bun preflight | lint, format, typecheck, react doctor, and test |
bun run test:unit | run unit tests |
bun run test:integration | run integration tests |
bun run db:migrate | push database migrations |
bun run db:pull | replace the local database with a copy of the live one (see below) |
bun run clean | find and fix unused code with knip |
local data
bun dev runs against a local D1 database that starts empty. to work against real data, run:
bun run db:pull # asks before overwriting local data
bun run db:pull --yes # skip the prompt
it exports the live unehaus database (read-only) with wrangler, wipes the local one, imports the dump, and deletes the dump. you need to be signed in first (bunx wrangler login).
the copy contains real member data. treat the machine accordingly.
the app only binds D1 (see wrangler.jsonc), so there is no R2 or KV data to pull.
contributing
- fork the repo
- create a branch (
git checkout -b feature/my-feature)
- make your changes
- run checks before committing
bun run preflight
- commit and push
- open a pull request
license
mit
