Skip to content

Latest commit

 

History

History
69 lines (39 loc) · 2.44 KB

README.md

File metadata and controls

69 lines (39 loc) · 2.44 KB

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