SPStackPilotv0.2.6
Documentation · v0.2.6

Build from the golden path.

StackPilot is intentionally small at the surface. You choose the service language and deployment profile; StackPilot supplies tested engineering defaults.

Quickstart

After installing StackPilot, create a production-minded backend service with one command:

stackpilot new payments-api

StackPilot opens its interactive setup. Choose Rust and it resolves Axum automatically; the recommended backend profile uses PostgreSQL, AWS, Docker, GitHub Actions and Terraform.

stackpilot new

Creates a new repository directory from a StackPilot recipe. Interactive mode guides you through the small set of decisions that matter.

# Interactive
stackpilot new <project-name>

# Non-interactive automation
stackpilot new orders-api \
  --non-interactive \
  --kind "Backend API" \
  --language Go \
  --framework Auto \
  --database PostgreSQL \
  --cloud AWS \
  --docker true \
  --ci true \
  --terraform true

stackpilot plan

Preview the files StackPilot intends to generate before it writes anything. Interactive mode asks for the same project choices without touching the filesystem.

stackpilot plan payments-api

stackpilot bootstrap

Transforms a repository created with GitHub's Use this template button into the selected application foundation in place, then removes StackPilot's template-engine internals.

stackpilot bootstrap --recipe base
You can also run Configure StackPilot Template from the repository's GitHub Actions tab instead of bootstrapping locally.

stackpilot doctor

Validates the local StackPilot environment and recipe directory. Installed releases automatically resolve the bundled recipe library beside the StackPilot executable.

stackpilot doctor

stackpilot recipes

v0.2.6 ships around the base recipe, with conditional files implementing the six blessed backend paths.

stackpilot recipes

Project profile

Generated repositories include .stackpilot.toml. This records the choices used to generate the repository, giving future StackPilot operations a stable machine-readable description of the project's foundation.

project_name = "payments-api"
kind = "Backend API"
language = "Rust"
framework = "Axum"
database = "PostgreSQL"
cloud = "AWS"
docker = true
ci = true
terraform = true

What StackPilot does not do yet

v0.2.6 remains focused on backend services. Frontend applications, full-stack applications, workers, CLI applications, libraries, repository remediation and hosted organization policies are later phases—not half-supported switches in the current release.