all things une

une.haus

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
• 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

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

une.haus is self-hosted on a homelab server — bun running natively under systemd, postgres on the same box, exposed via a cloudflare tunnel (no open ports). no platform-as-a-service, no managed database. the repo itself is deploy-agnostic; any host that can run bun + postgres works. see DEPLOY.md for the build/run contract.

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.

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

mit