# hashicorp/waypoint architecture

> Architecture diagram of the GitHub repository hashicorp/waypoint, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hashicorp/waypoint
- Repository: https://github.com/hashicorp/waypoint

## Overview

Waypoint is an application-delivery platform: users define build, deploy, and release workflows as code, then operate them through the CLI and extensible platform plugins. The best-evidenced workflow here is pipeline configuration through execution and run inspection: configuration becomes pipeline data, the server schedules dependent jobs, and the CLI streams results. The README documents multiple build and deployment targets; their individual implementations are represented as plugin subsystems. Edges beyond the sampled pipeline path are documented capabilities or unverified integrations, marked accordingly.

Main entry points: [`internal/cli/pipeline_run.go`](https://github.com/hashicorp/waypoint/blob/main/internal/cli/pipeline_run.go) (Pipeline commands), [`pkg/server/singleprocess/service_pipeline.go`](https://github.com/hashicorp/waypoint/blob/main/pkg/server/singleprocess/service_pipeline.go) (Pipeline service), [`internal/cli/main.go`](https://github.com/hashicorp/waypoint/blob/main/internal/cli/main.go) (Waypoint CLI), [`internal/config/pipeline.go`](https://github.com/hashicorp/waypoint/blob/main/internal/config/pipeline.go) (Pipeline configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_cli["Waypoint CLI<br/>[main.go]"]
  node_ui["Waypoint UI"]
end

subgraph group_workflow["Pipeline workflow"]
  node_pipeline_config["Pipeline configuration<br/>[pipeline.go]"]
  node_pipeline_model["Pipeline model<br/>[pipeline.go]"]
  node_pipeline_service["Pipeline service"]
  node_pipeline_state[("Pipeline state<br/>[pipeline.go]")]
  node_run_state[("Run state<br/>[pipeline_run.go]")]
  node_run_tree["Run tree processor<br/>[pipeline_ui.go]"]
  node_pipeline_cli["Pipeline commands<br/>[pipeline_run.go]"]
  node_inspect_cli["Pipeline inspection"]
end

subgraph group_runtime["Execution runtime"]
  node_runner["Job runner"]
  node_server_client["Server client<br/>[client.go]"]
end

subgraph group_plugins["Build and platform plugins"]
  node_build_plugins["Build plugins"]
  node_platform_plugins["Deployment plugins"]
end

node_developer(("Developer"))

node_developer -->|"invokes"| node_cli
node_cli -.->|"runs commands"| node_pipeline_cli
node_pipeline_config -->|"encodes pipeline"| node_pipeline_model
node_pipeline_cli -->|"syncs configuration"| node_pipeline_config
node_pipeline_cli -->|"requests run"| node_pipeline_service
node_pipeline_service -->|"reads state"| node_pipeline_state
node_pipeline_service -.->|"records run"| node_run_state
node_pipeline_cli -.->|"reads run jobs"| node_run_state
node_pipeline_service -.->|"queues jobs"| node_runner
node_runner -.->|"streams job"| node_server_client
node_pipeline_cli -.->|"inspects runs"| node_inspect_cli
node_inspect_cli -.->|"renders run details"| node_run_tree
node_developer -.->|"uses"| node_ui
node_pipeline_cli -.->|"selects build method"| node_build_plugins
node_pipeline_cli -.->|"selects target"| node_platform_plugins

click node_cli "https://github.com/hashicorp/waypoint/blob/main/internal/cli/main.go"
click node_ui "https://github.com/hashicorp/waypoint/tree/main/ui/app"
click node_pipeline_config "https://github.com/hashicorp/waypoint/blob/main/internal/config/pipeline.go"
click node_pipeline_model "https://github.com/hashicorp/waypoint/blob/main/pkg/server/ptypes/pipeline.go"
click node_pipeline_service "https://github.com/hashicorp/waypoint/blob/main/pkg/server/singleprocess/service_pipeline.go"
click node_pipeline_state "https://github.com/hashicorp/waypoint/blob/main/internal/server/boltdbstate/pipeline.go"
click node_run_state "https://github.com/hashicorp/waypoint/blob/main/internal/server/boltdbstate/pipeline_run.go"
click node_run_tree "https://github.com/hashicorp/waypoint/blob/main/pkg/server/ptypes/pipeline_ui.go"
click node_pipeline_cli "https://github.com/hashicorp/waypoint/blob/main/internal/cli/pipeline_run.go"
click node_inspect_cli "https://github.com/hashicorp/waypoint/blob/main/internal/cli/pipeline_inspect.go"
click node_runner "https://github.com/hashicorp/waypoint/blob/main/internal/runner/operation_pipeline_step.go"
click node_server_client "https://github.com/hashicorp/waypoint/blob/main/pkg/serverclient/client.go"
click node_build_plugins "https://github.com/hashicorp/waypoint/tree/main/builtin/docker"
click node_platform_plugins "https://github.com/hashicorp/waypoint/tree/main/builtin/k8s"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_ui toneBlue
class node_pipeline_config,node_pipeline_model,node_pipeline_service,node_pipeline_state,node_run_state,node_run_tree,node_pipeline_cli,node_inspect_cli toneAmber
class node_runner,node_server_client toneMint
class node_build_plugins,node_platform_plugins toneRose
class node_developer toneIndigo
```

## Components

### User interfaces

- [Waypoint CLI](https://github.com/hashicorp/waypoint/blob/main/internal/cli/main.go): `internal/cli/main.go`
- [Waypoint UI](https://github.com/hashicorp/waypoint/tree/main/ui/app): `ui/app`

### Pipeline workflow

- [Pipeline configuration](https://github.com/hashicorp/waypoint/blob/main/internal/config/pipeline.go): `internal/config/pipeline.go`
- [Pipeline model](https://github.com/hashicorp/waypoint/blob/main/pkg/server/ptypes/pipeline.go): `pkg/server/ptypes/pipeline.go`
- [Pipeline service](https://github.com/hashicorp/waypoint/blob/main/pkg/server/singleprocess/service_pipeline.go): `pkg/server/singleprocess/service_pipeline.go`
- [Pipeline state](https://github.com/hashicorp/waypoint/blob/main/internal/server/boltdbstate/pipeline.go): `internal/server/boltdbstate/pipeline.go`
- [Run state](https://github.com/hashicorp/waypoint/blob/main/internal/server/boltdbstate/pipeline_run.go): `internal/server/boltdbstate/pipeline_run.go`
- [Run tree processor](https://github.com/hashicorp/waypoint/blob/main/pkg/server/ptypes/pipeline_ui.go): `pkg/server/ptypes/pipeline_ui.go`
- [Pipeline commands](https://github.com/hashicorp/waypoint/blob/main/internal/cli/pipeline_run.go): `internal/cli/pipeline_run.go`
- [Pipeline inspection](https://github.com/hashicorp/waypoint/blob/main/internal/cli/pipeline_inspect.go): `internal/cli/pipeline_inspect.go`

### Execution runtime

- [Job runner](https://github.com/hashicorp/waypoint/blob/main/internal/runner/operation_pipeline_step.go): `internal/runner/operation_pipeline_step.go`
- [Server client](https://github.com/hashicorp/waypoint/blob/main/pkg/serverclient/client.go): `pkg/serverclient/client.go`

### Build and platform plugins

- [Build plugins](https://github.com/hashicorp/waypoint/tree/main/builtin/docker): `builtin/docker`
- [Deployment plugins](https://github.com/hashicorp/waypoint/tree/main/builtin/k8s): `builtin/k8s`

### Other components

- **Developer**

## Connections

- Developer → Waypoint CLI: invokes (evidence: `README.md`)
- Waypoint CLI → Pipeline commands: runs commands
- Pipeline configuration → Pipeline model: encodes pipeline (evidence: `internal/config/pipeline.go`)
- Pipeline commands → Pipeline configuration: syncs configuration (evidence: `internal/cli/pipeline_run.go`)
- Pipeline commands → Pipeline service: requests run (evidence: `internal/cli/pipeline_run.go`)
- Pipeline service → Pipeline state: reads state (evidence: `pkg/server/singleprocess/service_pipeline.go`)
- Pipeline service → Run state: records run
- Pipeline commands → Run state: reads run jobs
- Pipeline service → Job runner: queues jobs
- Job runner → Server client: streams job
- Pipeline commands → Pipeline inspection: inspects runs
- Pipeline inspection → Run tree processor: renders run details
- Developer → Waypoint UI: uses
- Pipeline commands → Build plugins: selects build method
- Pipeline commands → Deployment plugins: selects target
