stackrd/

directory
v0.1.4 Latest Latest
Warning

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

Go to latest
Published: Sep 16, 2026 License: Apache-2.0

Directories

Path Synopsis
config
envcompare
Package envcompare answers "how do this stack's environments differ from the first one": one row per tile slug, one cell per environment, the keys that differ, and which of those someone has marked as on purpose.
Package envcompare answers "how do this stack's environments differ from the first one": one row per tile slug, one cell per environment, the keys that differ, and which of those someone has marked as on purpose.
envops
Package envops holds environment lifecycle operations shared by the web UI and automation triggers (PR webhooks): config-only cloning and full teardown.
Package envops holds environment lifecycle operations shared by the web UI and automation triggers (PR webhooks): config-only cloning and full teardown.
envutil
Package envutil parses KEY=VALUE env blobs shared by the deploy engine, databases, and the web Variables tab.
Package envutil parses KEY=VALUE env blobs shared by the deploy engine, databases, and the web Variables tab.
orgconf
Package orgconf is org-level config-as-code (§6): one file from which a fresh stackr server can materialize the entire org, org vars/secrets, org-scoped shared managed instances, and the stacks themselves.
Package orgconf is org-level config-as-code (§6): one file from which a fresh stackr server can materialize the entire org, org vars/secrets, org-scoped shared managed instances, and the stacks themselves.
runpolicy
Package runpolicy is the registry of runnable tile types: how each type's built artifact runs, and which config surface it accepts.
Package runpolicy is the registry of runnable tile types: how each type's built artifact runs, and which config surface it accepts.
secrets
Package secrets encrypts sensitive values (app/db env blobs) at rest with AES-GCM.
Package secrets encrypts sensitive values (app/db env blobs) at rest with AES-GCM.
settings
Package settings holds the cascading defaults: server -> organization -> stack -> environment -> tile.
Package settings holds the cascading defaults: server -> organization -> stack -> environment -> tile.
sharelink
Package sharelink runs one-shot secret exchanges with people who have no account: a drop box they fill in (values land straight in the encrypted variables store) or a share link that shows them existing values once.
Package sharelink runs one-shot secret exchanges with people who have no account: a drop box they fill in (values land straight in the encrypted variables store) or a share link that shows them existing values once.
stackconf
Package stackconf parses stackr-compose.yml, declarative stack config, and resolves it into per-environment tile definitions.
Package stackconf parses stackr-compose.yml, declarative stack config, and resolves it into per-environment tile definitions.
staging
Package staging records pending UI edits into the staged_changes buffer so they apply as one reviewed transaction (see internal/stackconf/staging.go for how the buffer is drained).
Package staging records pending UI edits into the staged_changes buffer so they apply as one reviewed transaction (see internal/stackconf/staging.go for how the buffer is drained).
varref
Package varref resolves ${{ ...
Package varref resolves ${{ ...
Package envcolor resolves the colour an environment is drawn in.
Package envcolor resolves the colour an environment is drawn in.
handlers
api
Package api mounts the REST surface.
Package api mounts the REST surface.
api/v1
Package v1 is the REST API.
Package v1 is the REST API.
middleware
Package middleware holds this application's own Echo middleware, request logging with a propagated request id, the active-organization context, and the guard that keeps config-managed stacks read-only in the UI.
Package middleware holds this application's own Echo middleware, request logging with a propagated request id, the active-organization context, and the guard that keeps config-managed stacks read-only in the UI.
notify
Package notify pushes "something changed" events to browsers over the hamr websocket hub, and records events in the in-app notification center.
Package notify pushes "something changed" events to browsers over the hamr websocket hub, and records events in the in-app notification center.
stream
Package stream is an in-process pub/sub hub used to fan out log lines and status updates to SSE subscribers.
Package stream is an in-process pub/sub hub used to fan out log lines and status updates to SSE subscribers.
web
Package web is the HTML surface: the full route table, the middleware groups behind it, and the shared error rendering.
Package web is the HTML surface: the full route table, the middleware groups behind it, and the shared error rendering.
web/avatar
Package avatar handles the two uploaded images in stackr, a user's avatar and an organization's logo, from the multipart form to the <img> tag.
Package avatar handles the two uploaded images in stackr, a user's avatar and an organization's logo, from the multipart form to the <img> tag.
web/components
templ: version: v0.3.1001
templ: version: v0.3.1001
web/components/canvas
templ: version: v0.3.1001
templ: version: v0.3.1001
web/components/form
templ: version: v0.3.1001
templ: version: v0.3.1001
web/filebrowse
templ: version: v0.3.1001
templ: version: v0.3.1001
web/graph
Package graph derives a project topology (nodes + edges) from apps and databases.
Package graph derives a project topology (nodes + edges) from apps and databases.
web/handler/about
templ: version: v0.3.1001
templ: version: v0.3.1001
web/handler/account
templ: version: v0.3.1001
templ: version: v0.3.1001
web/handler/annotate
Package annotate is the HTTP half of canvas annotations: bind, validate and write one note against a canvas owner key the caller has already authorized.
Package annotate is the HTTP half of canvas annotations: bind, validate and write one note against a canvas owner key the caller has already authorized.
web/handler/app
templ: version: v0.3.1001
templ: version: v0.3.1001
web/handler/auth
Package auth holds web-layer auth helpers shared across the internal/web/handler/auth/* page packages (login, register, etc.).
Package auth holds web-layer auth helpers shared across the internal/web/handler/auth/* page packages (login, register, etc.).
web/handler/auth/invite
Package invite handles org invite links: an existing session joins the org directly, a fresh visitor creates an account through the invite.
Package invite handles org invite links: an existing session joins the org directly, a fresh visitor creates an account through the invite.
web/handler/auth/login
templ: version: v0.3.1001
templ: version: v0.3.1001
web/handler/auth/register
templ: version: v0.3.1001
templ: version: v0.3.1001
web/handler/backups
Package backups is the per-tile Backups tab: the schedules on one tile, their run history, and the buttons that run or restore them.
Package backups is the per-tile Backups tab: the schedules on one tile, their run history, and the buttons that run or restore them.
web/handler/cli
templ: version: v0.3.1001
templ: version: v0.3.1001
web/handler/container
templ: version: v0.3.1001
templ: version: v0.3.1001
web/handler/db
templ: version: v0.3.1001
templ: version: v0.3.1001
web/handler/deployment
templ: version: v0.3.1001
templ: version: v0.3.1001
web/handler/notification
Package notification renders the in-app notification center and the live-updating rail bell badge.
Package notification renders the in-app notification center and the live-updating rail bell badge.
web/handler/org
templ: version: v0.3.1001
templ: version: v0.3.1001
web/handler/prhook
Package prhook turns GitHub pull_request webhooks into ephemeral environments: opened → clone the configured base env and deploy it, synchronize → redeploy the PR branch, closed → tear the env down.
Package prhook turns GitHub pull_request webhooks into ephemeral environments: opened → clone the configured base env and deploy it, synchronize → redeploy the PR branch, closed → tear the env down.
web/handler/project
templ: version: v0.3.1001
templ: version: v0.3.1001
web/handler/search
Package search is the global search palette's backend: one endpoint that substring-matches everything the viewer can navigate to and returns an HTML fragment of result rows.
Package search is the global search palette's backend: one endpoint that substring-matches everything the viewer can navigate to and returns an HTML fragment of result rows.
web/handler/server
Package server renders the servers screen: host stats history, Docker daemon info, and the server-level default settings.
Package server renders the servers screen: host stats history, Docker daemon info, and the server-level default settings.
web/handler/settings
templ: version: v0.3.1001
templ: version: v0.3.1001
web/handler/sharepub
Package sharepub is the public face of a secret link: the pages someone with no account sees at /s/:token.
Package sharepub is the public face of a secret link: the pages someone with no account sees at /s/:token.
web/wsproxy
Package wsproxy bridges a websocket to a plain TCP connection, the server half of `stackr forward`.
Package wsproxy bridges a websocket to a plain TCP connection, the server half of `stackr forward`.
web/wsterm
Package wsterm bridges a browser websocket to a docker exec TTY, the one implementation behind both the container terminal and the db console.
Package wsterm bridges a browser websocket to a docker exec TTY, the one implementation behind both the container terminal and the db console.
infra
agent
Package agent is the node agent: one task per swarm node, proxying the handful of docker calls Swarm's control plane does not forward.
Package agent is the node agent: one task per swarm node, proxying the handful of docker calls Swarm's control plane does not forward.
backup
Package backup writes database dumps, docker volumes, and the panel's own SQLite file to S3-compatible destinations, restores from them, prunes old archives, and runs the schedules that trigger all of it.
Package backup writes database dumps, docker volumes, and the panel's own SQLite file to S3-compatible destinations, restores from them, prunes old archives, and runs the schedules that trigger all of it.
cigate
Package cigate releases push deploys parked behind wait_for_ci: a janitor task polls GitHub's check runs + commit statuses for each waiting_ci deployment and turns green into a queued build, red into an error.
Package cigate releases push deploys parked behind wait_for_ci: a janitor task polls GitHub's check runs + commit statuses for each waiting_ci deployment and turns green into a queued build, red into an error.
cluster
Package cluster is the one door for every docker call the panel makes.
Package cluster is the one door for every docker call the panel makes.
deploy
Package deploy runs the build+release pipeline: fetch → build → run new → health-gate → retire old.
Package deploy runs the build+release pipeline: fetch → build → run new → health-gate → retire old.
envnet
Package envnet maps a tile to its environment's isolated Docker network and slug-based naming.
Package envnet maps a tile to its environment's isolated Docker network and slug-based naming.
forward
Package forward tracks live `stackr forward` tunnels in memory.
Package forward tracks live `stackr forward` tunnels in memory.
githubapp
Package githubapp implements the GitHub App manifest flow for "github" connectors: each connector creates its own private GitHub App in one click, then mints short-lived installation tokens for cloning private repos and validating webhooks.
Package githubapp implements the GitHub App manifest flow for "github" connectors: each connector creates its own private GitHub App in one click, then mints short-lived installation tokens for cloning private repos and validating webhooks.
gitlog
Package gitlog is a list of recent commits on one branch, from GitHub or a local clone, in one shape.
Package gitlog is a list of recent commits on one branch, from GitHub or a local clone, in one shape.
hostmetrics
Package hostmetrics reads one machine's own counters: CPU, memory, disk, network.
Package hostmetrics reads one machine's own counters: CPU, memory, disk, network.
imagewatch
Package imagewatch polls container registries for new image digests and drives the per-tile update policy (notify / auto-redeploy).
Package imagewatch polls container registries for new image digests and drives the per-tile update policy (notify / auto-redeploy).
jobs
Package jobs is the scheduler behind cron tiles: it fires them on their cron expression, runs each as a one-shot container from the tile's own image, and records the outcome in cron_runs.
Package jobs is the scheduler behind cron tiles: it fires them on their cron expression, runs each as a one-shot container from the tile's own image, and records the outcome in cron_runs.
mail
Package mail is stackr's outbound transactional email: one SMTP2GO adapter behind hamr's email.Sender, plus the dev inbox.
Package mail is stackr's outbound transactional email: one SMTP2GO adapter behind hamr's email.Sender, plus the dev inbox.
managedtiles
Package databases provisions and manages database containers: per-engine image/env/volume defaults plus dump & restore commands.
Package databases provisions and manages database containers: per-engine image/env/volume defaults plus dump & restore commands.
metrics
Package metrics samples container CPU/memory into a SQLite ring buffer for the per-service graphs, plus host CPU/mem/disk under "server:local" refs for the servers screen.
Package metrics samples container CPU/memory into a SQLite ring buffer for the per-service graphs, plus host CPU/mem/disk under "server:local" refs for the servers screen.
netpool
Package netpool hands out pre-created swarm overlays.
Package netpool hands out pre-created swarm overlays.
nodes
Package nodes keeps the servers table in step with the swarm, pings the nodes, and issues the one-time keys a node joins with.
Package nodes keeps the servers table in step with the swarm, pings the nodes, and issues the one-time keys a node joins with.
placement
Package placement decides which node a tile's task may run on.
Package placement decides which node a tile's task may run on.
proxy
Package proxy owns Traefik: it runs the Traefik container and writes its dynamic file-provider config.
Package proxy owns Traefik: it runs the Traefik container and writes its dynamic file-provider config.
registry
Package registry manages the Stackr-hosted Docker registry (registry:2 with htpasswd auth) and external registry records.
Package registry manages the Stackr-hosted Docker registry (registry:2 with htpasswd auth) and external registry records.
runtime
Package runtime is the single Docker boundary: no other package may import the Docker SDK or shell out to docker.
Package runtime is the single Docker boundary: no other package may import the Docker SDK or shell out to docker.
storagetiles
Package storagetiles implements §2.7 storage tiles: server-scoped shares (nfs/smb) and local pools, consumed through declared sub-paths, each backed by a docker local-driver volume.
Package storagetiles implements §2.7 storage tiles: server-scoped shares (nfs/smb) and local pools, consumed through declared sub-paths, each backed by a docker local-driver volume.
volmove
Package volmove moves every volume a tile mounts from one node to another.
Package volmove moves every volume a tile mounts from one node to another.
workqueue
Package workqueue is one durable runner for every long job (docs/plans/33-workqueue.md).
Package workqueue is one durable runner for every long job (docs/plans/33-workqueue.md).
Package service holds business logic that outlives any one HTTP handler.
Package service holds business logic that outlives any one HTTP handler.
store
audit
Package audit records reads and writes of secret variable values.
Package audit records reads and writes of secret variable values.
db
Package db opens the SQLite connection and owns the embedded migrations, which run at startup.
Package db opens the SQLite connection and owns the embedded migrations, which run at startup.
db/dumpschema command
repo
Package repo is the data layer: the Store interface every handler talks to, the row structs behind it, and the slug rules shared by both.
Package repo is the data layer: the Store interface every handler talks to, the row structs behind it, and the slug rules shared by both.
testdb
Package testdb spins up a migrated in-memory SQLite store for tests.
Package testdb spins up a migrated in-memory SQLite store for tests.

Jump to

Keyboard shortcuts

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