The Vapor Internals Book

Status: target outline.

This book is for people working on Vapor’s repos and implementation.

Repository Map

Status: target outline.

Explain Vapor, SDK, Launcher, Examples, Registry, and future repos.

Source Tree

Status: target outline.

Explain repo-local source tree layout.

Core Crates

Status: target outline.

Explain vapor_core and vapor_macros.

SDK Architecture

Status: target outline.

Explain SDK core, CLI, command specs, handlers, and output.

Launcher Architecture

Status: target outline.

Explain Launcher core, CLI, command specs, and future handlers.

App Root Layout

Status: target outline.

Explain app-root files, state, outputs, aliases, and activation scripts.

Toolchain Backend

Status: target outline.

Explain Rustup wrapping, app-local state, and possible archive fallback.

Workspace Execution

Status: target outline.

Explain managed Cargo execution, target dirs, environment, and deploy.

Manifest, Lock, Artifact

Status: target outline.

Explain human-authored manifests and generated state boundaries.

Testing And Release

Status: target outline.

Explain test and release expectations once they stabilize.

Invariants

Status: target outline.

List implementation invariants that must stay true.

Code Cleanup

Status: target outline.

Explain safe cleanup slices and boundaries.

Documentation Rules

Status: target outline.

Explain README, rustdoc, roadmap, glossary, and design-intent documentation rules.