Documentation

Introduction

Start with the product model, terminology, and how the control plane actually works today.

Section Overview

Introduction

Start with the product model, terminology, and how the control plane actually works today.

What is StackShift

A precise description of StackShift as it exists today: a self-hosted application platform control plane for deploying and operating workloads across connected nodes.

Live

Goal

Understand the platform model before you start reading deployment or operations guides.

Expected result

You can explain the difference between the control plane, nodes, projects, stacks, templates, databases, and operations.

Core concepts

A glossary and mental model for projects, stacks, templates, nodes, databases, deployments, and operations.

Live

Goal

Give new users enough vocabulary to understand the rest of the docs.

Expected result

Terms used across the dashboard and docs feel consistent instead of ambiguous.

How StackShift works

A product-level walkthrough of how the control plane, worker, agent, and runtime hosts cooperate.

Live

Goal

Show the end-to-end flow from dashboard action to runtime state.

Expected result

You can reason about where a failure occurred: control plane, worker, node agent, or workload runtime.

Current platform status and terminology

A maturity guide for reading the platform docs without collapsing every user-visible surface into the same confidence level.

Live

Goal

Set expectations so users do not confuse user-visible UI with uniformly finished behavior across the whole product.

Expected result

Readers know how much confidence to place in a given area before adopting it heavily.