Deployment Module

Canonical Specification

The canonical deployment-system specification now lives at:

• docs/superpowers/specs/2026-03-28-deployment-system.md

That document supersedes the older design-era deployment docs and defines the authoritative maintainer/agent contract for:

• provisioning vs deployment
• stackpanel.deployment.machines
• app deployment configuration
• flake deployment outputs (nixosModules, nixosConfigurations, colmenaHive)
• stackpanel.deployment.flakeOutputs — gate heavy NixOS outputs on the main flake; optional ./deploy sub-flake for internal infra
• CLI workflows (stackpanel deploy, stackpanel provision)
• local deploy/provision state files

What this module documentation should cover

This internal page should be read as a directory/module entrypoint, not as the full deployment architecture spec.

The code under nix/stackpanel/deployment/ is primarily about provider-specific hosted deployment helpers such as:

• Fly.io
• Cloudflare / Alchemy

It is not the whole deployment story by itself. The NixOS machine deploy/provision path also depends on:

• nix/stackpanel/modules/deploy/module.nix
• nix/stackpanel/lib/deploy.nix
• apps/stackpanel-go/cmd/cli/deploy.go
• apps/stackpanel-go/cmd/cli/provision.go

Relationship to public docs

Public deployment guides remain under apps/docs/content/docs/deployment/. They are user-facing guides and references, while the canonical deployment-system specification is the internal source of truth.