Skip to content
KBVE org · open source

Build with us on GitHub

Open-source games, cloud infrastructure, and the contributors building them. PRs land against dev and ship through CI to main. Pick an issue, fork the repo, open a worktree — the walkthrough is under Contribute.

Open the monorepo

Good first issuesHow to contribute →

Jump to GitHub

KBVE/kbveMonorepo
devPRs target
OSSLicense
Nx + ActionsCI

Thank you

Top contributors

Live from the org

Recent activity

Up for grabs

In flight

Browse every open issue →

The catalog

Repositories

Web + Apps

14

Astro, React, Tauri.

Games + Sim

3

Unity, Bevy, Phaser, Lua.

Rust Services

2

axum-kbve, jedi, codegen, FFI.

Other

22

Your first PR

How to contribute

  1. Fork + clone

    Fork `KBVE/kbve`, then clone your fork. Origin stays on your fork; upstream points at KBVE/kbve.

    						git clone [email protected]:<you>/kbve.git
cd kbve
git remote add upstream https://github.com/KBVE/kbve.git
git fetch upstream

  2. Worktree for the task

    KBVE uses `./kbve.sh -worktree <slug>` so each PR gets its own checkout off `dev`. No accidental commits on `main` or `dev`; pnpm installs and `.env.local` are copied for you.

    						./kbve.sh -worktree fix-auth-redirect
cd ../kbve-fix-auth-redirect

  3. Install + run targets

    `./kbve.sh -nx` wraps `npx nx run …` and sources `.env.local`. Use it for builds, dev servers, codegen, anything Nx.

    						./kbve.sh -nx astro-kbve:dev
./kbve.sh -nx axum-kbve:test
./kbve.sh -nx astro-kbve:test:unit

  4. Push + open a PR

    Push the worktree branch to your fork (or to the kbve remote if you have access). Base the PR against `dev`, not `main`. Conventional Commits in the subject; explain the *why* in the body.

    						git push -u origin trunk/fix-auth-redirect-<ts>
gh pr create --base dev --title "fix(auth): ..." --body "..."

  5. Sync your fork later

    After your PR lands, pull upstream `dev` and prune the worktree.

    						git fetch upstream
git checkout dev
git merge --ff-only upstream/dev
git worktree remove ../kbve-fix-auth-redirect
git push origin --delete trunk/fix-auth-redirect-<ts>

Useful pointers

Elsewhere

Keep going

KBVE/kbveThe monorepo behind every KBVE project — games, services, infra.DiscordAsk questions, pair on issues, and catch the Saturday dev stream.ProjectsEvery shipped crate, game, plugin, and service with its own doc.