Welcome! If you've stumbled upon this repository, you've found the source behind the BX Team web platform — our website, documentation, and the downloads API behind every build we publish.
BX Team is an open source community building tools and software that empower Minecraft server owners, developers, and players. Our plugins, server software, and libraries live in separate repositories across the BX-Team organization; this repo holds the web platform that ties them together.
If you're not a developer and just want to use our tools, head to bxteam.org or browse the organization for individual projects like DivineMC, Quark, and NDailyRewards.
This is a Bun workspaces monorepo. Everything is TypeScript, and the entire backend runs on Cloudflare Workers.
| App | Description | Stack |
|---|---|---|
meridian |
Main website, docs and downloads — fully static | Nuxt 4, Vue 3, Tailwind v4 |
azimuth |
Public API — the /atlas downloads route group |
Hono, Cloudflare Workers, D1, R2 |
| Package | Description |
|---|---|
stratus |
D1 (SQLite) schemas and migrations via Drizzle ORM |
types |
Shared Zod schemas for the Atlas wire format |
ui |
Shared Vue 3 component library and design tokens |
Backend state lives entirely on Cloudflare: the atlas-db D1 database for project, version and build metadata, and the builds R2 bucket for the artifacts themselves. meridian is generated with nuxt generate and served as Workers Static Assets — there is no runtime Nitro server.
You'll need Bun (the version is pinned in package.json). Install dependencies once from the repo root:
bun installThen run any app through the workspace scripts:
bun dev # everything in parallel
bun dev:meridian # just the static frontend
bun dev:azimuth # just the APIazimuth runs on wrangler dev and reads secrets from a local .dev.vars — copy .dev.vars.example as a starting point. D1 schemas and migrations live in packages/stratus; apps/azimuth/wrangler.jsonc points its ATLAS_DB binding at packages/stratus/drizzle/d1/atlas. Both apps are built and deployed by Cloudflare directly from this repository. Per-app setup notes live in each project's CLAUDE.md.
We welcome contributions! Open an issue to discuss larger changes first and keep pull requests focused.
Found a vulnerability? Please do not open a public issue. Reach out privately through our Discord so we can address it before disclosure.
- Discord: discord.gg/qNyybSSPm5
- Website: bxteam.org
- Organization: github.com/BX-Team
Copyright © 2022-2026 BX Team.
This project is licensed under the GNU Affero General Public License v3.0 — see LICENSE for the full text. In short: you're free to use, modify, and self-host it, but if you run a modified version as a network service, you must make your source available to its users under the same terms.