jxramos / awesome-bazel

A curated list of Bazel rules, tooling and resources.

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
  • Articles
  • Videos
  • Podcasts
  • Books
  • Slides
  • Blogs
  • Community
  • Misc

Rules

Language/Platform	Repository/Documentation
.NET (C#, Nuget)	bazelbuild/rules_dotnet
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 ios-bazel-users/ios-bazel-users: Resources for using Bazel for iOS development thii/rules_apple_extras: Extra rules for Apple platforms
ANTLR	marcohu/rules_antlr
ARM Mbed OS	mjbots/rules_mbed
Bison	jmillikin/rules_bison
BOSH	xoebus/rules_bosh
C++	https://docs.bazel.build/versions/master/be/c-cpp.html bazelbuild/rules_cc nelhage/rules_boost: Rules for Boost C++ libraries
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	dart-lang/bazel
Docker	bazelbuild/rules_docker rmohr/rules_container_rpm: Install RPMs without a container daemon with bazel
ECS	dan-compton/ecsonnet
Elm	EdSchouten/rules_elm
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
Helm (Kubernetes)	tmc/rules_helm
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.
Kotlin	bazelbuild/rules_kotlin cgruber/rules_kotlin (a temporary maintenance fork of the legacy rules above, until Google releases their updated rules, including 1.3 support)
Kubernetes	bazelbuild/rules_k8s
LaTeX	ProdriveTechnologies/bazel-latex
LLVM toolchain	vsco/bazel-toolchains grailbio/bazel-toolchain
M4	jmillikin/rules_m4
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
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
OCaml	jin/rules_ocaml
OCI Containers	guymers/bazel_rules_container guymers/containers_by_bazel
OpenAPI/Swagger	meetup/rules_openapi
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 TriggerMail/rules_pyz: Python rules with PyPI package support 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
Ragel	jmillikin/rules_ragel
R	grailbio/rules_r
ReasonML, BuckleScript	ostera/rules_reason
Ruby	yugui/rules_ruby
Rust	bazelbuild/rules_rust google/cargo-raze: Generate Bazel BUILD files for Rust Crates
Sass	bazelbuild/rules_sass
Scala	bazelbuild/rules_scala higherkindness/rules_scala
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.
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
• 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

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

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.

Remote caching and execution

• bazel-remote - A remote cache for Bazel using HTTP/1.1 with --remote_rest_cache
• bazelbuild/bazel-buildfarm - Self-hosted remote caching and execution service written in Java
• Buildbarn - Self-hosted remote caching and execution service written in Go
• 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.
• Zenreach/hydroponics - Serverless CI for Bazel making use of S3 for caching.

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 plugin
• Vim plugin
• Emacs Support
  • codesuki/bazel-mode:
  • brown/bazel-mode
• VSCode
• bazelbuild/vscode-bazel
• 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 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

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.

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.

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)

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 31, 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)