Skip to content

This project is a pure front-end Bazel Build Event Protocol (BEP) viewer.

License

Notifications You must be signed in to change notification settings

fzakaria/build-event-protocol-viewer

Repository files navigation

Build Event Protocol Viewer

https://visible.build

built with nix github master branch workflow

This project is a front-end only Build Event Protocol (BEP) Viewer.

It provides a user-friendly interface to visualize and analyze build events generated by Bazel.

Motivation

Being a pure front-end is a core tenet of this codebase. The goal is to provide as much diagnostic insight into your Bazel build without the need of a server.

I was really inspired by all the awesome other tools that are available that provide similar diagnostics with the use of a server such as: BuildBuddy, bb-portal, blade and Bzl UI.

Getting Started

If you are using Nix, you can easily run this locally.

nix run github:fzakaria/build-event-protocol-viewer

Development

npm install
npm run dev

The application will be available at the printed port for a development server.

Usage

  1. Open your browser and navigate to http://localhost:3000.
  2. Upload your Bazel build event binary proto file.
  3. Explore and analyze the build events using the provided interface.

Questions

  1. Why is the Typescript/Javascript/Svelte so bad!?

I am not a frontend developer and this is my best attempt. Please contribute improvements.

  1. Why not just use X (BuildBuddy, etc..) ?

I wanted a front-end only solution so that I can contribute it to the community and not have to manage any infrastructure. If you want more insights across invocations, I recommend those solutions.

  1. Why doesn't this use Bazel to build!?

See #1. I'm happy to learn how to maket his an idiomatic Bazel build as well.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

This project is not affiliated with Google or Bazel.

Screenshots

Image of the Build Event Protocol Viewer

Image of the Build Event Protocol Viewer

About

This project is a pure front-end Bazel Build Event Protocol (BEP) viewer.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project