System Blueprints
02 / Reference

Specifications for how Shipper works

Design notes, architectural decisions, and internal references laid out like a product handbook instead of a loose markdown archive.

Read the first page
34 pages6 sectionsDesign reference
Browse by section
6 areas
01Architecture5
02Commands2
03Configuration4
04Deployment4
05Infrastructure7
06Testing12
Complete index

How the system is shaped

34 entries
01Spec

Spec: Deployment Atomic Rollback

**Date:** 2026-04-26 **Status:** Draft

SpecificationRead page
02Spec

Spec: Build System — PHAR Compilation and Distribution

**Issue:** MAR-41 **Date:** 2026-04-24 **Status:** In Review

SpecificationRead page
03Spec

Spec: CLI Commands

**Issue:** MAR-19 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
04Spec

Spec: Configuration System

**Issue:** MAR-18 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
05Spec

Spec: Deployment Execution

**Issue:** MAR-35 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
06Spec

Spec: Domain Aliases

**Issue:** MAR-30 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
07Spec

Spec: EasyPanel Provider

EasyPanel provider capability contract and ownership rules.

SpecificationRead page
08Spec

Spec: Forge Provider

**Issue:** MAR-39 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
09Spec

Spec: GitHub Actions Integration

Composer-isolated GitHub Action installation, provider discovery, inputs, caching, and workflow requirements.

SpecificationRead page
10Spec

Spec: Implement DeployCommand

**Date:** 2026-04-26 **Status:** Draft

SpecificationRead page
11Spec

Spec: Database Management

**Issue:** MAR-22 **Date:** 2026-04-24 **Status:** In Review

SpecificationRead page
12Spec

Spec: Environment Variables

**Issue:** MAR-23 **Date:** 2026-04-24 **Status:** In Review

SpecificationRead page
13Spec

Spec: Queue Workers

**Issue:** MAR-24 **Date:** 2026-04-24 **Status:** In Review

SpecificationRead page
14Spec

Spec: Cron Jobs

**Issue:** MAR-25 **Date:** 2026-04-24 **Status:** In Review

SpecificationRead page
15Spec

Spec: Daemons

**Issue:** MAR-26 **Date:** 2026-04-24 **Status:** In Review

SpecificationRead page
16Spec

Spec: Deploy Scripts

**Issue:** MAR-32 **Date:** 2026-04-24 **Status:** In Review

SpecificationRead page
17Spec

Spec: PHP Version

**Issue:** MAR-33 **Date:** 2026-04-24 **Status:** In Review

SpecificationRead page
18Spec

Spec: Repository Management

**Issue:** MAR-34 **Date:** 2026-04-24 **Status:** In Review

SpecificationRead page
19Spec

Spec: Network Rules

**Issue:** MAR-28 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
20Spec

Spec: Nginx Configuration

**Issue:** MAR-29 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
21Spec

Spec: Orphan Cleanup — PR Preview Environments

**Issue:** MAR-37 **Date:** 2026-04-24 **Status:** In Review

SpecificationRead page
22Spec

Spec: Plan/Apply Workflow

**Issue:** MAR-36 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
23Spec

Spec: Ploi Provider

**Issue:** MAR-38 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
24Spec

Spec: Provider Architecture

**Issue:** MAR-20 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
25Spec

Spec: Provider Plugin Architecture

How provider packages advertise plugin metadata, expose provider mappings, and are discovered by the Shipper CLI.

SpecificationRead page
26Spec

Shipper CLI Specifications

![Shipper Banner](https://raw.githubusercontent.com/shippercli/assets/main/banner.png)

SpecificationRead page
27Spec

Spec: Redirect Rules

**Issue:** MAR-31 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
28Spec

Spec: Security Hardening — Path Traversal, Env Validation, Rate Limit Retry

**Date:** 2026-04-26 **Status:** Draft

SpecificationRead page
29Spec

Spec: Silent Failure Fixes — DB Deletion, Orphan Cleanup Errors

**Date:** 2026-04-26 **Status:** Draft

SpecificationRead page
30Spec

Spec: Site Lifecycle Management

**Issue:** MAR-21 **Date:** 2026-04-24 **Status:** In Review

SpecificationRead page
31Spec

Spec: SSL Management

**Issue:** MAR-27 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
32Spec

Spec: Strict Type System

**Issue:** MAR-43 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page
33Spec

Spec: Shipper Test Coverage Initiative

**Date:** 2026-04-26 **Status:** Draft

SpecificationRead page
34Spec

Spec: Variable Interpolation

**Issue:** MAR-42 **Date:** 2026-04-23 **Status:** In Review

SpecificationRead page