builder

command module
v0.3.27 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 23, 2026 License: Apache-2.0 Imports: 6 Imported by: 0

README

👷‍♂️ Builder

Go Report Card Taylor Swift Volkswagen License

Builder is a tool that implements the builder specification. It is the specification to build and deploy software projects with agents. It focuses on speed and simplicity.

🤹‍♀️ This is inspired by quick from Shopify and Magic by WealthSimple.

Usage

  • 👨‍🎨 Design
  • 🏗️ Build
  • 🚢 Ship
builder help

Installation

brew install zeiss/builder-tap/builder

Features

  • 🏛️ Static site hosting
  • 🧭 Spec-driven building
  • ...

🗺️ Discovery

The configuration for the authentication provider and the API can be served on a .well-known/builder-configuration endpoint.

GET /.well-known/builder-configuration

{
  "oidc_issuer": "http://builder.internal:5556/dex",
  "api_url": "http://builder.internal:5556"
}

This is a way to simplify the configuration.

Authentication

The builder authenticates to the server using OpenID Connect. The authentication flow is handled by the server. It supports dex as an OpenID Connect provider.

To authenticate, the builder uses a dex client ID and secret. These are configured in the builder tool.

builder account login --url <builder-server>

This logs you in to the builder server.

builder --help

There are a couple of basic features.

builder

  USAGE


    builder [command] [--flags]


  COMMANDS

    account [command]         Manage accounts
    completion [command]      Generate the autocompletion script for the specified shell
    help [command]            Help about any command
    init                      Initialize a new config
    reset                     Reset the configuration
    sites [command]           Manages sites
    task [command] [--flags]  Manage tasks

  FLAGS

    -c --config               Config file (.builder.yml)
    -d --dry                  Dry run
    -f --force                Force init
    -h --help                 Help for builder
    -p --plugin               Plugin
    -r --root                 Run as root
    -u --url                  Url (http://builder.internal:3000)
    --var                     Variables
    -v --verbose              Verbose output
    --version                 Version for builder

Server

The server implements the deployment features of the builder specification.

Using Helm to run the builder on Kubernetes.

helm repo add builder https://zeiss.github.io/builder
helm repo update
helm search repo builder

License

Apache 2.0

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
cmd
internal
ui
ui/exit
Package exitbanner renders what Crush prints after the TUI exits.
Package exitbanner renders what Crush prints after the TUI exits.
ui/logo
Package logo renders a Builder in a stylized way.
Package logo renders a Builder in a stylized way.
ui/logo/example command
ui/styles
Package styles define styling and theming for the project.
Package styles define styling and theming for the project.
pkg
apis
Package apis provides primitives to interact with the openapi HTTP API.
Package apis provides primitives to interact with the openapi HTTP API.
cmd
middlewares/discovery
Package discovery serves the builder discovery document.
Package discovery serves the builder discovery document.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL