---
title: APOLLO-000 · the rocket factory · README
kind: readme
captured: 2026-05-23
captured_by: APOLLO-README-A004-05-23-22:30 · Claude
parent_project_code: APOLLO-000
back_reference: ../_principia/executing-as-architecting.md
parent_axiom: ../_ops/AXM-LAUNCH-001.md
parent_brief: ../_ops/proposals/APOLLO-SETUP-A000-05-23-21:00-proposal.md
sigil: 🜂
---

# APOLLO-000 · the rocket factory

> *Mission control is the room. The factory is the mechanism. The launch is the single command.*

APOLLO is the reusable site-launch framework. One command produces a complete site folder pre-wired with the canonical viewer skin, the launcher, the eye-landing skeleton, and the chosen theme. Captain stops manually scaffolding each new site by copying patterns from HBS-000 / mythmatrix / omphalos.

## TL;DR

```bash
python3 ~/Desktop/root/_APOLLO/launch-site.py <domain> <project-code>
```

That's it. The site folder lands at `~/Desktop/root/<domain>/`, the launcher inside is executable, the theme tokens are wired, and an entry is appended to `MISSION-LOG.json`. Double-click `LAUNCH-<PROJECT-CODE>.command` inside the launched folder to serve and open it.

## Open mission control

Double-click `LAUNCH-APOLLO.command`. It serves `_APOLLO/` on a free port (8780+) and opens `mission-control.html` — the cyrelium-skinned room that lists every launch APOLLO has fired, surfaces the launch command (copyable), and links to each theme's preview.

## Examples

### Minimal launch (default theme · flat layout)

```bash
python3 ~/Desktop/root/_APOLLO/launch-site.py cosmicmytharium.com CSM-000
```

Lands at: `~/Desktop/root/cosmicmytharium.com/`
Theme: cyrelium (default)
Launcher: `~/Desktop/root/cosmicmytharium.com/LAUNCH-CSM-000.command`

### Entity-anchored launch (HBS-style)

```bash
python3 ~/Desktop/root/_APOLLO/launch-site.py hermeticbusinessservices.com HBS-000 \
  --theme hermetic \
  --entity -HermeticBusinessServices-LLC \
  --tagline "Hermetic Service" \
  --about-name "Hermetic Service LLC"
```

Lands at: `~/Desktop/root/-HermeticBusinessServices-LLC/root/hermeticbusinessservices.com/`
Theme: hermetic
Launcher: `~/Desktop/root/-HermeticBusinessServices-LLC/root/hermeticbusinessservices.com/LAUNCH-HBS-000.command`

### Library cast

```bash
python3 ~/Desktop/root/_APOLLO/launch-site.py mythmatrix.local MYTHMATRIX-000 \
  --theme mythmatrix \
  --brand-mark ~/Desktop/root/.assets/constellation.png
```

### Dry run (preview without writing)

```bash
python3 ~/Desktop/root/_APOLLO/launch-site.py cosmicmytharium.com CSM-000 --dry-run
```

## Options

| flag | default | what it does |
|---|---|---|
| `--theme` | `cyrelium` | one of: `cyrelium · hermetic · mythmatrix · titus · omphalos` |
| `--into` | (see below) | parent folder · wins over `--entity` |
| `--entity` | (none) | entity folder name · target becomes `<root>/<entity>/root/<domain>/` |
| `--brand-mark` | (glyph fallback) | path to brand mark image · copied into the site folder |
| `--tagline` | `<domain>` | one-line tagline (used in `<title>` and below the eye) |
| `--about-name` | `<domain>` | line 1 of the info panel (the business/site name) |
| `--about-line-1..3` | `# CONFIRM` | additional lines of the info panel |
| `--sub-agent-code` | `APOLLO-CLI` | stamps the launch with the spawning agent code |
| `--notes` | (empty) | free-form notes for the mission log entry |
| `--force-relaunch` | off | archives prior launch to `_archive/missions/`, then overwrites |
| `--dry-run` | off | print what would happen, don't write |

### Site-folder location default (Captain Seal Q1)

- `--entity <name>` given → `~/Desktop/root/<entity>/root/<domain>/` (entity-anchored)
- `--entity` absent → `~/Desktop/root/<domain>/` (flat fallback)
- `--into` always wins when explicitly set.

## What APOLLO does NOT do

- **Does not deploy.** APOLLO produces a source folder. Deployment to a real domain is per-site (rsync, GitHub Pages, whatever).
- **Does not write content.** The site lands as a skeleton with placeholder copy. Author content after the launch.
- **Does not register the project elsewhere.** No automatic write to `_osisi/`, `_titus/library.json`, or `_mnemosyne/`. MISSION-LOG.json is the only registry.
- **Does not edit live folders.** Re-launching a project code refuses unless `--force-relaunch` is given (in which case the prior is archived, not overwritten in place).

## Architecture

```
_APOLLO/
├── -bedrock.md              # what APOLLO is and is not
├── README.md                # this file
├── LAUNCH-APOLLO.command    # mission control launcher (double-click)
├── mission-control.html     # the room (cyrelium-skinned)
├── MISSION-LOG.json         # append-only · open-horizon · the factory's own osisus chain
├── launch-site.py           # the CLI
├── template/                # what every launch instantiates
│   ├── index.html           # eye-landing skeleton with {{tokens}}
│   ├── _ptah/               # symlink → ../../_ptah (substrate)
│   ├── case-studies/        # placeholder
│   ├── .well-known/         # stub
│   ├── LAUNCH-{{PROJECT_CODE}}.command  # parameterized per-site launcher
│   └── README.md            # parameterized site-level readme
├── themes/                  # 5 themes (v0.1)
│   ├── cyrelium/  hermetic/  mythmatrix/  titus/  omphalos/
│   │   └── tokens.css · preview.html · -theme.md (each)
│   └── README.md
└── _archive/                # ptah-write archive for APOLLO's own iterations
    └── missions/<project>/v<N>/   # archived prior launches when --force-relaunch fires
```

## How adding a sixth theme works

See `themes/README.md`. Short version: find a cast with a `:root { … }` block you like, copy that block into `themes/<name>/tokens.css`, copy any existing theme's `preview.html` + `-theme.md`, swap names. Done. The theme is selectable via `--theme <name>` from the next launch onward.

## Sister project

`_azrael/` (AZL-000) is the necropolis at the other end of the chain. APOLLO ships rockets; AZL receives them when their work is done. Together: BOW gathers · APOLLO launches · OCTO bears · AZL releases.

## Lineage

- Built per the ratified proposal `_ops/proposals/APOLLO-SETUP-A000-05-23-21:00-proposal.md`.
- Captain Seal granted 2026-05-23 with four defaults locked (entity-anchored fallback flat · 5 themes · AXM-LAUNCH-001 Reading A · HBS retroactive test non-blocking).
- Launcher pattern inherited from `_azrael/LAUNCH-AZRAEL.command`.
- Eye-landing + corner-controls pattern inherited from `-HermeticBusinessServices-LLC/.../index.html` (HBS-000 v0.4).
- Substrate inherited from `_ptah/`.
- Mission log keystones surface through `_ops/AXM-COMMS-001.md`.

*🜂  one command. one rocket. iterate the factory; the next rocket inherits.*