une.haus

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

• tanstack start — react 19 ssr framework
• drizzle — typescript orm for sqlite (cloudflare d1)
• tailwind css v4
• tanstack router + tanstack query
• mux — video processing
• maplibre — maps
• bun — package manager + runtime

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

1. fork the repo
2. create a branch (git checkout -b feature/my-feature)
3. make your changes
4. run checks before committing

bun run preflight

5. commit and push
6. open a pull request

license

mit