Awesome Bazel

{Fast, Correct} - Choose two

Bazel is an open-source build and test tool similar to Make, Maven, and Gradle. It uses a human-readable, high-level build language. Bazel supports projects in multiple languages and builds outputs for multiple platforms. Bazel supports large codebases across multiple repositories, and large numbers of users. (via docs)

A curated list of Bazel rules, tooling and resources.

Have something to contribute or discuss? Open a pull request or create an issue.

---

Contents

• Rules
• Tooling
  • Toolchains
  • Starlark
  • Migration
  • Editor plugins
  • Misc
• Resources
  • Tutorials
  • Projects
  • Demos
  • Articles
  • Videos
  • Podcasts
  • Books
  • Slides
  • Blogs
  • Community
  • Misc

Rules

Language/Platform	Repository/Documentation
Amazon web services (AWS)	evertz/ev_rules_aws
Android	bazelbuild/rules_android quittle/bazel_android_sdk_downloader : Drop-in replacement for android_sdk_repository to automatically download the Android SDK.
Apple (iOS, macOS, tvOS, watchOS)	bazelbuild/rules_apple line/bazel_rules_apple: LINE's custom rules for building apps and frameworks for Apple platforms ios-bazel-users/ios-bazel-users: Resources for using Bazel for iOS development
ANTLR	marcohu/rules_antlr
ARM Mbed OS	mjbots/rules_mbed
Bison	jmillikin/rules_bison
BOSH	xoebus/rules_bosh
Brotli	Brightspace/rules_brotli
C++	https://docs.bazel.build/versions/master/be/c-cpp.html bazelbuild/rules_cc nelhage/rules_boost: Rules for Boost C++ libraries
C#	bazelbuild/rules_dotnet Brightspace/rules_csharp: an alternative (unofficial) design for C# rules
Clojure	simuons/rules_clojure
Closure	bazelbuild/rules_closure
CSS	bazelbuild/rules_postcss
CMake	bazelbuild/rules_foreign_cc
CocoaPods	pinterest/PodToBUILD
CODEOWNERS	zegl/rules_codeowners
D	bazelbuild/rules_d
Dart	cbracken/rules_dart
Databricks	acqio/rules_databricks
Docker	bazelbuild/rules_docker rmohr/rules_container_rpm: Install RPMs without a container daemon with bazel
ebook (pdf, epub, mobi)	filmil/bazel-ebook
ECS	dan-compton/ecsonnet
Elm	EdSchouten/rules_elm
Emacs Lisp (elisp)	phst/rules_elisp
Emscripten	ribrdb/rules_emscripten
Flex	jmillikin/rules_flex
Go	bazelbuild/rules_go Gazelle: Generate Bazel BUILD files for Go related_projects update-repos: Tool in Gazelle for adding Go dependencies as `go_repository` to WORKSPACE ActiveState/rules_vendor: Bazel support for packaging Go vendored dependencies jmhodges/bazel_gomock: Support for generating code with `mockgen`
Graal	andyscott/rules_graal
Grafana	etsy/rules_grafana
Groovy	bazelbuild/rules_groovy
GWT	bazelbuild/rules_gwt
Haskell	tweag/rules_haskell FormationAI/hazel: Generate rules for third-party Haskell dependencies google/cabal2bazel: Import Cabal packages from Hackage as Bazel packages google/hrepl: Interactive development for Bazel/Haskell rules
Helm (Kubernetes)	tmc/rules_helm dataform-co/dataform/tools/helm: Repository rules for downloading Helm charts, and BUILD rules for templating them
Homebrew	tmc/rules_homebrew
Hugo	stackb/rules_hugo
Idris	BryghtWords/rules_idris
Java	https://docs.bazel.build/versions/master/be/java.html bazelbuild/rules_java bazelbuild/tools_jvm_autodeps (Jadep): Generate BUILD files automatically for an existing Java project with class dependency analysis. salesforce/bazel-java-builder-template: A template for Java based source code generators.
JFlex	jflex-de/bazel_rules
Kotlin	bazelbuild/rules_kotlin buildfoundation/bazel_rules_detekt
Kubernetes	bazelbuild/rules_k8s acqio/rules_k8s_extension Bazel rules for Kubernetes extension for creating configmaps and secrets. adobe/rules_gitops A Kustomize based GitOps workflow implementation.
LaTeX	ProdriveTechnologies/bazel-latex
LLVM toolchain	vsco/bazel-toolchains grailbio/bazel-toolchain samolisov/bazel-llvm-bridge: Bazel repository_rule for using libraries from a local LLVM in your BUILD files. Supports LLVM, Clang and MLIR. Also provides the 'tablegen' rule.
M4	jmillikin/rules_m4
Manifest of build artifacts	kindlyops/rules_manifest: Take a list of artifacts such as zip files for AWS Lambda, and collect them into a single directory with each file named by the content hash, along with a JSON manifest of the files and original labels.
Maven	johnynek/bazel-deps: Generate Bazel dependencies transitively for Maven artifacts, with Scala support. pubref/rules_maven bazelbuild/gmaven_rules: Repository rules for Maven artifacts hosted on Google Maven repository square/bazel_maven_repository: Access maven deps as "@maven//some/maven/group_id:artifact_id" (incorporating transitive dependencies) bazelbuild/rules_jvm_external: Rules to resolve and fetch artifacts transitively from Maven repositories menny/bazel-mvn-deps: A simple Maven dependency graph generator for Bazel
Maya	mdilena/bazel-maya
Microsoft Azure	acqio/rules_microsoft_azure
NativeScript	NativeScript/nativescript-dev-bazel
Nixpkgs	tweag/rules_nixpkgs
Node.js / JavaScript	bazelbuild/rules_nodejs ecosia/bazel_rules_nodejs_contrib dropbox/rules_node pubref/rules_node zenclabs/bazel-javascript vistarmedia/rules_js thelgevold/rules_svelte dataform-co/dataform/tools/gcloud: Rules for deploying Node.js code as gcloud functions (HTTP/PubSub)
OCaml	jin/rules_ocaml
OCI Containers	guymers/bazel_rules_container guymers/containers_by_bazel
OpenAPI/Swagger	meetup/rules_openapi
Packaging (RPM/DEB)	bazelbuild/rules_pkg ericnorris/rules_nfpm
Pandoc	ProdriveTechnologies/bazel-pandoc
PHP	kburnik/php_codebase
Protobuf	https://docs.bazel.build/versions/master/be/protocol-buffer.html: Native protocol buffer rules rules-proto-grpc/rules_proto_grpc: Bazel rules for building Protocol Buffers & gRPC code and libraries stackb/rules_proto: Modern bazel build rules for protobuf / gRPC bazelbuild/rules_proto: Starlark implementation of the Protobuf rules in Bazel
Purescript	felixmulder/rules_purescript
Python	https://docs.bazel.build/versions/master/be/python.html bazelbuild/rules_python benley/rules_pex georgeliaw/rules_wheel: Rules for building Python wheels tuomasr/pazel: Generate Bazel BUILD files for Python zenreach/ramsay: Generate Bazel BUILD files for Python rules_pyz weisi/bazel_for_gcloud_python: Rules to build Python 3 and deploy to Google App Engine and Google Cloud Functions apt-itude/rules_pip: Rules for pip requirements files tubular/rules_pygen: Rules for generating Bazel Python libraries from requirements.txt dillon-giacoppo/rules_python_external: Rules to resolve and fetch artifacts transitively from the Python Package Index (PyPI) TriggerMail/rules_pyz: Python rules with PyPI package support (Unmaintained)
Ragel	jmillikin/rules_ragel
R	grailbio/rules_r
ReasonML, BuckleScript	ostera/rules_reason
Ruby	bazelruby/rules_ruby
Rust	bazelbuild/rules_rust google/cargo-raze: Generate Bazel BUILD files for Rust Crates wildarch/blackjack: Generate Bazel targets for crates.io dependencies in your Cargo.toml
Sass	bazelbuild/rules_sass
Scala	bazelbuild/rules_scala higherkindness/rules_scala
Shell	tweag/rules_sh filmil/bazel-bats (bats: bash automated testing system)
SonarQube	Zetten/bazel-sonarqube
Swift	bazelbuild/rules_swift
Terraform	ceason/rules_terraform mitchelldavis/rules_terraform
Twirl	lucidsoftware/rules_twirl
TypeScript	bazelbuild/rules_typescript sconover/rules_multi_tsc: Bazel rules that support breaking a typescript codebase into small, independently-compilable libraries.
Verilog	Lightelligence/rules_verilog
Web (HTML, CSS, JS, assets)	quittle/rules_web

Tooling

General

• graknlabs/bazel-distribution - Assemble and deploy software distributions to common platforms, e.g. APT, Brew, GitHub, Maven, NPM, PIP, RPM, etc.
• bazelbuild/bazel-watcher - Automatically run Bazel commands when source files change
• nadirizr/dazel - Run Bazel inside a Docker container via a seamless proxy
• spotify/bazel-tools - Spotify's production tools for dealing with very large Bazel-managed repositories.
• atlassian/bazel-tools - Atlassian's reusable bits for Bazel
• gerrit/bazlets - Gerrit's re-usable building blocks for Bazel build tool
• Bazel Code Search - Browse Bazel's codebase with cross references.
• heroku-buildpack-bazel - Heroku buildpack for Bazel
• hchauvin/bazel-coverage-report - A multi-language coverage report generator for Bazel
• acqio/bazel-arcanist - Integration with Arcanist with arc test and arc lint
• Asana/bazeltsc - TypeScript compiler that knows how to run as a Bazel persistent worker
• bazelbuild/sandboxfs - A virtual file system for sandboxing
• JetBrains/teamcity-bazel-plugin - TeamCity plugin for Bazel (blogpost)
• philwo/bazelisk - A user-friendly launcher for Bazel
• bzl-io/bzl - a wrapper around the bazel build tool to extend its functionality
• bazelbuild/bazel-integration-testing - Framework for integration tests that call Bazel
• bazel-diff - Bazel Target Diffing between two revisions in Git, allowing for Test Target Selection and Selective Building

Toolchains

Toolchains enable authors to decouple their rule logic from platform-based selection of tools.

• bazelbuilds/bazel-toolchains - Bazel toolchain configurations to enable Google Cloud Remote Build Execution via Docker containers
• vsco/bazel-toolchains - A collection of Bazel C++ build infrastructure based on Chromium's LLVM toolchain
• grailbio/bazel-toolchain - LLVM toolchain for bazel
• silvergasp/bazel-embedded - Set of bazel toolchains and tools, for compiling and uploading to embedded targets

Starlark

Starlark (formerly called Skylark) is Bazel's domain-specific language for writing BUILD definitions and rules.

• Official documentation
• Language description
• Starlark in Go
• Starlark in Rust
• Skydoc - Starlark documentation generator
• Sphinx-Bazel - Sphinx extension to read Bazel files to generate documentation (GitHub)
• Skylib - Common useful functions for writing custom build rules with Starlark
• Bazel Common Libraries - Common functionality for Google's open-source libraries that are built with Bazel.
• Stardbg - A standalone debugger for Starlark

Remote caching and execution

• bazel-remote - A simple remote cache for Bazel that supports HTTP and gRPC, with optional proxy backends for S3/GCS/HTTP.
• bazelbuild/bazel-buildfarm - Self-hosted remote caching and execution service written in Java
• Buildbarn - Self-hosted remote caching and execution service written in Go
• buildbuddy-io/buildbuddy - Cloud or self-hosted remote caching and execution service written in Go, with Web UI for viewing and debugging build logs
• BuildGrid - Self-hosted remote caching and execution service written in Python
• Asana/bazels3cache - Small web server for a Bazel cache that proxies to S3, allowing Bazel to work offline and has async uploads to make Bazel faster.

Project generators

Tools for generating WORKSPACE and BUILD files from source code.

• blakefiler.py - Generate a Makefile and tarball-able distribution using bazel query
• Lavender - Generate Visual Studio projects that uses Bazel for the actual building
• Jadep: Java Automated Dependencies - Generate BUILD files automatically for an existing Java project with class dependency analysis.
• BUILD File Generator - Similar tool for existing Java projects.
• Gazelle - BUILD file generator for Go projects.
• Pazel - Generate Bazel BUILD files for Python
• Tulsi for Xcode - A project generator for Xcode projects
• pinterest/xchammer - XCHammer generates Xcode projects from a Bazel Workspace
• create-bazel-workspace - Generate a new multi-language Bazel workspace with minimal configuration
• Gazelle JS Plugin Generate BUILD files automatically for an existing Javascript or Typescript project with npm dependency analysis.
• llvmbzlgen - Tools for generating Bazel BUILD targets from LLVM CMakeLists

Editors

• IntelliJ plugin (compatible with Android Studio and CLion)
• Eclipse Support
  • Bazel Eclipse Feature (BEF) - Fork of the abandoned Google Bazel Eclipse plugin
  • B2Eclipse - Bazel Eclipse plugin based on Eclipse JDT LS
• Vim plugin
• Emacs Support
  • codesuki/bazel-mode:
  • brown/bazel-mode
• VSCode Support
  • bazelbuild/vscode-bazel
  • stackb/bazel-stack-vscode. Includes syntax highlighting / flag completion for bazelrc files. Hover support for inline builtin-function and bazel rule documentation. VSCode Marketplace.
  • VSCode Bazel Java extension - Proof-of-concept (POC) of a Bazel Java development extension for VS Code
• PyCharm
• sconover/rules_intellij_generate - Plugin-less Bazel/IntelliJ integration
• georgewfraser/java-language-server - Java Language Server (LSP) with support for Bazel-built projects

BUILD file tools

bazelbuild/buildtools contains:

• Buildifier - Prettifier for BUILD and .bzl files
• Buildozer - Manipulate BUILD file contents from the command line
• unused_deps - Find unneeded dependencies in BUILD files

Migration

• bazelbuild/migration-tooling - Migrate an existing Maven project to Bazel.
• johnynek/bazel-deps - Generate bazel dependencies transitively for Maven artifacts, with scala support.
• rules_maven - Rules to define Maven dependencies
• bazelize-maven-plugin - Maven plugin for migration from Maven to Bazel
• bazelbuild/gmaven_rules - Transitive WORKSPACE rules for Google's Maven repository
• stripe/sbt-bazel - Easily convert SBT projects to Bazel workspaces
• wix-incubator/exodus - Easily migrate your JVM code from Maven to Bazel

Misc

• salesforce/bazel-maven-proxy - A local proxy to access Maven resources behind secure repositories or from the local repo

Resources

Designs

• bazelbuild/proposals - Index of all design documents and proposals for Bazel.
• Bazel's design process

Tutorials

Official

• Java
• C++
• Android
• iOS

Toolchains

• c++ toolchains

Codelabs

• Building Android Apps with Bazel

Community

• Aspects: the fan-fic of build rules
• Real-world Bazel - BUILD files collected from public GitHub projects for reference and learning purposes.
• Bazel Lesson 1 and Bazel Lesson 2 - Gradually build a multi-language Bazel project.

Online courses

• Bazelguides

Projects

A list of projects built with Bazel:

• bazelment/trunk: A collection of C++/Java OSS with BUILD files. e.g. grpc, guava, netty.
• tensorflow/tensorflow: Computation using data flow graphs for scalable machine learning.
• abseil/abseil-cpp - OSS collection of C++ code (compliant to C++11) designed to augment the C++ standard library.
• GoogleCloudPlatform/distroless - Language focused docker images, minus the operating system.
• google/subpar - Subpar is a utility for creating self-contained python executables. It is designed to work well with Bazel.
• alexeagle/angular-bazel-example: Building an Angular application with Bazel
  • ABC: Angular Buildtools Convergence https://g.co/ng/abc
• google/startup-os - Working examples of Google's Open Source tools and Cloud.
• lucperkins/colossus - An example microservice architecture for Kubernetes using Bazel, Go, Java, Docker, Kubernetes, Minikube, Gazelle, gRPC, Prometheus, Grafana, and more.
• squzy/squzy - is a high-performance open-source monitoring system written in Golang with Bazel. Using Bazel for testing, building and dockerize.

Demos

Bazel demo projects:

• kastiglione/bazel-xcode-demo-swift-driver: Demonstrates using Bazel and Xcode, to build apple/swift-driver.

Articles

• Build mobile apps with Bazel. Part 2: iOS - Francois Stephany
• Build mobile apps with Bazel. Part 1: Android - Francois Stephany
• (In Japanese) Building C++ with Bazel / C++ビルド環境としてのBazel導入試行
• Nix + Bazel = fully reproducible, incremental builds
• Production Code Splitting With Bazel - Greg Magolan (Google)
• Build large polyglot projects with Bazel... now with Haskell support
• Managing a Go monorepo with Bazel - Filip Nikolovski (InPlayer)
• How to Create a Persistent Worker for Bazel - Mike Morearty (Asana)
• We Switched from Maven to Bazel and Builds Got 10x Faster - Jason Lunz (Redfin)
• Angular Bazel Build With Dev Server - Torgeir "Tor" Helgevold
• Bazel Conference 2017 - Justin Poehnelt
• What Angular is doing with Bazel and Closure
• Building Docker Images Without Docker
• Bazel Golang Hello World
• Migrating from Gradle to Bazel
• Benchmarking the Bazel build system on real-life C++
• Migrating Gypsum and CodeSwitch to Bazel - Jay Conrod (Google)
• Create Go Monorepo with Go-modules and Bazel - Iurii Panarin

Videos

• KubeCon Europe 2019: Reproducible Development and Deployment with Bazel and Telepresence - Christian Roggia (Engel & Völkers)
• ScalaSphere 2018: Using Bazel to build Scala - Andy Scott (Stripe)
• GopherChina 2018: Bazel build //:Go - Yuan He (流利说/liulishuo.com)
• How I love being ejected: Customizing your Angular build with Bazel - Greg Magolan (Angular team)
• SF Scala: Bazel - a Brief Overview - Ulf Adams (Google)
• Bazel for building Angular applications at Angular Lunch - Kyle Cordes
• Deep Dive of Google's Angular Build Toolchain - Alex Eagle (Google)
• Bazel Conference 2017 Opening Remarks - Helen Altshuler, John Field, Ulf Adams (Google)
• Bazel Remote Execution and Remote Caching w/ Two Sigma and Uber - Alpha Lam (Two Sigma), George Gensure (Uber)
• Tensorflow with Bazel — Lessons Learned - Gunhan Gulsoy (Google)
• Building Real-time Systems with Bazel w/ SpaceX - Matt Sachtler, Patrick Conrad (SpaceX)
• Hacks and Tips for Incremental Adoption of Bazel for iOS w/ Pinterest - Rahul Malik, Brandon Kase, Jerry Marino (Pinterest)
• Front End Development with Bazel: Angular/TypeScript and Persistent Workers w/ Asana - Mike Morearty (Asana), Alex Eagle (Google)
• Scala with Bazel w/ Wix, Stripe, Databricks - Ittai Zeidman (Wix), Oscar Boykin (Stripe), Ahir Reddy (DataBricks)
• Skylark: The Bazel Extensibility Language - Laurent Le Brun (Google)
• Using Bazel for Fast, Correct Docker Deployments w/ Databricks - Miles Yucht (Databricks), Matthew Moore (Google)
• Platforms and Toolchains in Bazel - John Cater (Google)
• Building Kubernetes [a Go binary] with Bazel - Jeff Grafton (Google)
• Integration testing with Bazel w/Dropbox - Benjamin Peterson (Dropbox)
• Bazel Conference 2017 playlist
• GothamGo 2017: A Go implementation of the Skylark Configuration Language - Alan Donovan (Google)
• Bazel: Google's Extensible, Multilingual, Scalable Build System DevTools@Scale2017 - Dmitry Lomov (Google)
• Building Go with Bazel at Golang UK Conference 2017 - Paul Bellamy
• Building Software At Google Scale - Ulf Adams, Helen Altshuler, David Stanke (Google)
• Bazel: Google's own build tool, now publicly available in Beta - Paul Johnston
• Bazel at FrOSCon - Klaus Aehlig (Google)
• Building Python with Bazel - Benjamin Peterson (Dropbox)
• Bazel at the Dart Developer Summit 2016 - Damien Martin-Guillerez (Google)

Podcasts

• Bazel with Tony Aiuto; Google Cloud Podcast #153 Oct 31st, 2018 - Tony Aiuto
• AiA 247: Bazel with Alex Eagle; Adventures in Angular Jul 9th, 2019 - Alex Eagle (Google)

Books

• Beginning Bazel: Building and Testing for Java, Go, and More - P.J. McNerney; Apress, 1st ed. edition (December 24, 2019) 978-1484251935

Slides

• Building Gerrit with Bazel at Gerrit User Conference 2016 - David Ostrovsky

Blogs

• Official Bazel Blog
• Kristina Chodorow's blogposts on Bazel

Community

• #bazelbuild on Slack
• BuildTeamWorld on Slack - A community slack for BuildFarm, BuildGrid, Bazel and general build teams.
• #bazel on Freenode
• Stack Overflow
• Bazel users mailing list
• Bazel developers mailing list

Misc

• Why Google Stores Billions of Lines of Code in a Single Repository (Video at @Scale 2015)