System Blueprints

Specifications for how Shipper works

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

Start reading
32 pages6 sectionsInternal design notes
Sections
ArchitectureCommandsConfigurationDeploymentInfrastructureTesting
01Spec

Spec: Deployment Atomic Rollback

Open page
02Spec

Spec: Build System — PHAR Compilation and Distribution

Open page
03Spec

Spec: CLI Commands

Open page
04Spec

Spec: Configuration System

Open page
05Spec

Spec: Deployment Execution

Open page
06Spec

Spec: Domain Aliases

Open page
07Spec

Spec: Forge Provider

Open page
08Spec

Spec: GitHub Actions Integration

Open page
09Spec

Spec: Implement DeployCommand

Open page
10Spec

Spec: Database Management

Open page
11Spec

Spec: Environment Variables

Open page
12Spec

Spec: Queue Workers

Open page
13Spec

Spec: Cron Jobs

Open page
14Spec

Spec: Daemons

Open page
15Spec

Spec: Deploy Scripts

Open page
16Spec

Spec: PHP Version

Open page
17Spec

Spec: Repository Management

Open page
18Spec

Spec: Network Rules

Open page
19Spec

Spec: Nginx Configuration

Open page
20Spec

Spec: Orphan Cleanup — PR Preview Environments

Open page
21Spec

Spec: Plan/Apply Workflow

Open page
22Spec

Spec: Ploi Provider

Open page
23Spec

Spec: Provider Architecture

Open page
24Spec

Shipper CLI Specifications

Open page
25Spec

Spec: Redirect Rules

Open page
26Spec

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

Open page
27Spec

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

Open page
28Spec

Spec: Site Lifecycle Management

Open page
29Spec

Spec: SSL Management

Open page
30Spec

Spec: Strict Type System

Open page
31Spec

Spec: Shipper Test Coverage Initiative

Open page
32Spec

Spec: Variable Interpolation

Open page