code

The BX Team web platform in one repository — the site and documentation at bxteam.org, the downloads API behind it, and the Discord bot that announces what we publish. TypeScript end to end, running entirely on Cloudflare Workers.

BX Team is an open source community building tools for Minecraft server owners, developers and players. The plugins and server software live in their own repositories across the organization; this one holds the web platform that ties them together. If you only want to use our projects, start at bxteam.org.

📂 What is in here

A bun workspaces monorepo. Each app is a Cloudflare Worker deployed on its own domain; the packages are consumed from source, never published.

App	Domain	What it is
apps/meridian	bxteam.org	The website and documentation — Nuxt 4, statically generated and served as Workers Static Assets
apps/azimuth	api.bxteam.org	The downloads API — Hono, D1 and R2, publish tokens
apps/beacon	beacon.bxteam.org	The Discord bot — Hono, GitHub and publish webhooks, release announcements

Package	What it is
packages/types	Shared Zod schemas for the downloads API and the publish notification
packages/ui	Shared Vue 3 components and design tokens

azimuth is the only app that stores anything — every project, version, build and release, with the artifacts in R2 and the download URLs pointing straight at the bucket. meridian reads it for /downloads, and beacon reads a publish back from it to announce. Nothing here builds an artifact: that happens in a release workflow in the project's own repository, which uploads through azimuth with a project token.

🚀 Getting started

You need Bun; the version is pinned in package.json. Install once from the repository root:

bun install

Then run whichever app you are working on:

bun dev             # everything in parallel
bun dev:meridian    # the site, on nuxt dev
bun dev:beacon      # the bot, on wrangler dev
bun dev:azimuth     # the downloads API, on wrangler dev

azimuth and beacon read local secrets from a .dev.vars — copy the .dev.vars.example next to each as a starting point. Per-app notes live in each project's CLAUDE.md.

🧪 API

Downloads live at https://api.bxteam.org/v1. Reads are public and need no credentials; the OpenAPI document is at /v1/openapi.json and the rendered reference at /docs/api. Publishing takes a token that belongs to one project.

🔨 Build from source

bun run build       # every app
bun build:meridian  # nuxt generate
bun build:beacon    # wrangler deploy --dry-run
bun build:azimuth   # wrangler deploy --dry-run
bunx biome check .  # formatting and lint, the source of truth

Cloudflare builds and deploys the Workers straight from this repository — every pull request gets a preview deployment, and a merge to master ships. There are no CI workflows here and no manual deploy step.

🤝 Contributing

Contributions are welcome — open an issue to discuss anything larger before you write it, and keep a pull request to one subject. The organization-wide guidelines are in CONTRIBUTING.md.

The documentation for every BX Team project lives here too, under apps/meridian/content/docs. Read apps/meridian/content/README.md first — it documents the frontmatter, the MDC components and the icon set the pages are written against, and review the result on the pull request's preview deployment rather than in the Markdown source.

⚖️ License

This project is licensed under the GNU Affero General Public License v3.0 — see the LICENSE file for details. In short: use it, modify it and self-host it freely, but a modified version run as a network service has to offer its source to the people using it.