builder

command module
v0.3.31 Latest Latest
Warning

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

Go to latest
Published: Nov 2, 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 has a server and a CLI.

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

[!WARNING] There will be an upcoming change to a full rename to sparkles. This will effect the CLI and configuration.

🔧 Usage

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

📦 Installation

brew install zeiss/builder-tap/sparkles

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, builder uses a dex client ID and secret. These are configured in the builder tool.

sparkles account login --url <builder-server>

This logs you in to the builder server.

sparkles --help

There are a couple of basic features.

  sparkles

  USAGE


    sparkles [command] [--flags]


  COMMANDS

    account [command]     Manage accounts
    check                 Check the configuration
    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

  FLAGS

    -c --config           Config file (.builder.yml)
    --continue            Continue
    --debug               Debug mode
    --experimental        Experimental mode
    -f --force            Force init
    -h --help             Help for sparkles
    -p --path             Path (.sparkles)
    --plugin              Plugin
    -s --session          Session
    -u --url              Url
    --var                 Variables
    -v --verbose          Verbose output
    --version             Version for sparkles
    -y --yolo             Yolo mode

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
clipboard
Package clipboard provides cross-platform clipboard access behind build-tag guards so that unsupported platforms (e.g., Android, iOS) compile without requiring CGO or platform-specific dependencies.
Package clipboard provides cross-platform clipboard access behind build-tag guards so that unsupported platforms (e.g., Android, iOS) compile without requiring CGO or platform-specific dependencies.
ui
ui/console
Package console provides console UI utilities.
Package console provides console UI utilities.
ui/exit
Package exitbanner is
Package exitbanner is
ui/experimental
Package experimental is a banner to display when the experimental flag is enabled.
Package experimental is a banner to display when the experimental flag is enabled.
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