Bazel Monorepo

Central Bazel-based monorepo with Rust backend services and Angular frontend applications. This root README.md focuses on shared workflows. Project-specific details live in their own guides.

Subproject Guides

• Nicknamer Server: nicknamer/README.md
• Angular Apps: angular/AGENTS.md
• Monorepo Overview: AGENTS.md

Prerequisites

Install Bazelisk (manages Bazel versions):

Linux:

sudo wget -O /usr/local/bin/bazel https://github.com/bazelbuild/bazelisk/releases/latest/download/bazelisk-linux-amd64
sudo chmod +x /usr/local/bin/bazel

macOS:

brew install bazelisk

Windows (PowerShell):

choco install bazelisk

If you use Nix + direnv, direnv allow enters a flake shell that provides the common local CLI tools (bazel, bazelisk, aspect, buildifier, prettier, pnpm, go, java, starpls, pre-commit, plus format/coverage commands). For now, the flake assumes x86_64-linux, and aspect comes from LowkeyLab/nix. Bazel still owns the build, test, format, and coverage behavior for the repo.

Quick Start

git clone https://github.com/LowkeyLab/bazel-repo.git
cd bazel-repo

# (Optional) enter the flake-based dev shell
direnv allow

# (Optional) install NPM deps when touching frontend code
bazel run @pnpm -- --dir $PWD install

# Build everything
aspect build //...

# Run all tests
aspect test //...

Common Commands

# Build everything
aspect build //...

# Run all tests
aspect test //...

# Format code (Rust, BUILD files, etc.)
format

# Lint (Aspect CLI)
aspect lint

# Format only BUILD files
bazel run //tools:buildifier

# Keep going on failures for investigation
aspect build //... --keep_going

# Run arbitrary pnpm command
bazel run @pnpm -- <args>

Repo Tooling

• Centralized toolchain definitions under tools/ (Rust, Node.js/PNPM, Angular CLI wrappers, formatters, linters).
• Bazel manages reproducible builds and dependency pinning.
• Use MODULE.bazel / Cargo.toml edits followed by repin steps for dependency changes (see project guides).

Troubleshooting

# Clean build cache
bazel clean

# Repin Rust dependencies
CARGO_BAZEL_REPIN=1 bazel sync --only=crate_index

# Reinstall NPM dependencies
bazel run @pnpm -- --dir $PWD install

# Verbose failure output
aspect build //... --verbose_failures

For service-specific environment variables, runtime instructions, or database setup, consult the respective project guide listed above.

License

GNU Affero General Public License v3.0 (AGPLv3). See LICENSE.

Further Documentation

• Monorepo reference: AGENTS.md
• Nicknamer service details: nicknamer/README.md
• Angular workflows: angular/AGENTS.md