# 00 — Overview: The Soapbox Stack Operator Manual

One manual answering: can TresPies/DojoGenesis run community ops, company ops, funding, client sites, and publishing on the Soapbox.pub / Nostr stack — and where do we build?

## About this manual (build-in-public)

Built and maintained by TresPies Design / DojoGenesis. Researched and written via orchestrated AI agent waves — recon agents → adversarial kill-passes → writer agents → human-operator direction — not a single pass, and not one model.

- **Provenance:** every chapter carries its own Verified/Amended dates and per-claim confidence tiers; a public correction-log discipline means errors found in our own working documents get logged, not hidden.
- **Platform-agnostic by design:** nothing here assumes a specific agent or model lane — bring Claude Code, Cursor, Windsurf, OpenCode, DojoGenesis Gateway, or a plain terminal.
- **How to adapt:** fork the reading order, keep the protocol chapters as reference, swap the worked-example specifics (a firm's niche, a team's hooks) for your own.
- **Canonical home:** nostr.trespies.dev/manual · agent-readable faces at `/manual/llms.txt` and `/manual/index.json` (per-chapter sha256).

**Verified: 2026-07-09.** Research: 8 parallel agents (chapters 01–06, 08–09), each primary-sourced with numbered citations. Synthesis (this file + ch. 07): main thread, per the amended orchestrator gate (operator-ratified 2026-07-09). One mid-flight adjudication is recorded honestly: Armada was first verdicted nonexistent, then found at the repo level, verified, and corrected (ch. 02) — the product is 26 days old and simply unindexed. **Delta pass 2026-07-10** (ch. 05 + ch. 10): NostrHub velocity 866 commits/29 days; no bounty/contest program exists anywhere in the 60-post blog index; new MCP/agent-surface addendum — the "acting NostrHub MCP server" niche is verified empty; ⚠ nostrdeploy.com is DNS-dead (Stacks deploy lane tripwired, affects ch. 04's route too); Stacks 1.0 = the generic template platform, MKStack = one published stack on it.

## The four original questions

| Asked | Verdict (one line) | Where |
|---|---|---|
| "Armada for community and company operations — can it do filesharing?" | Armada is real (b. 2026-06-13): E2E Discord-shaped chat on the new Concord protocol — pilot for internal ops; Ditto is the mature public-community layer. Filesharing: media yes (Ditto plaintext, Armada E2E) — folders/ACLs/versioning **no**; keep Drive | [02](02-community-ops.md) |
| "Agora for funding" | Yes, today, permissionless: $0 platform fee, non-custodial wallet-to-wallet BTC (on-chain, not Lightning). Caveats: activist brand gravity, donors need BTC, no tax-receipt path for anonymous gifts | [03](03-agora.md) |
| "Shakespeare for sites and funnels — free mockups?" | Mockups: effectively free (free Gemini tier / BYO cheap key / local models; Soapbox takes no cut). Funnels: top-of-funnel native (forms, Lightning/Cashu); conversion capture wires to Beehiiv/ManyChat/Cal.com/Stripe | [04](04-shakespeare.md) |
| "Get deep into NostrHub — I have credentials" | Dev hub relaunched as 2.0 on 2026-06-28: NIPs + apps + git-over-Nostr, "configurable meritocracy." Sign in with NIP-07 extension or NIP-46 bunker — never paste your nsec. Publishing = kinds 30617 (repo), 31990 (app), 30023 (long-form) | [05](05-nostrhub.md) |

## The stack at a glance

```mermaid
flowchart TB
    subgraph identity [Identity and payment rails]
        K[Nostr keypair - nsec custody, no reset] --> N05[NIP-05 name at trespies.dev]
        K --> SIG[Signer: NIP-07 extension / NIP-46 bunker]
        Z[Zaps NIP-57 · NWC NIP-47 · Cashu NIP-60/61]
    end
    subgraph substrate [Substrate]
        R[Relays - NIP-65 outbox, 2-4 write]
        B[Blossom blob storage - won vs NIP-96]
    end
    subgraph products [Soapbox products - apps AGPL-3.0, frameworks MIT]
        D[Ditto - public community server, Mastodon-API]
        A[Armada - E2E team chat, Concord protocol, 0.x]
        AG[Agora - BTC fundraising, non-custodial]
        SH[Shakespeare - AI site/app builder on MKStack]
        NH[NostrHub 2.0 - NIPs, apps, git-over-Nostr]
    end
    subgraph trespies [Worked example: TresPies surfaces - ch. 07 §9]
        C1[Branded community]
        C2[Client sites, funnels, mockups]
        C3[Campaigns]
        C4[Published repos/tools - Nostr-anchored, DojoGenesis mirror]
    end
    identity --> substrate --> products
    D --> C1
    A -. internal pilot .-> C1
    SH --> C2
    AG --> C3
    NH --> C4
```

Full portfolio (45+ products incl. Toybox experiments): master map in [ch. 01](01-soapbox-company.md).

## Verdicts in brief

| Dimension | Verdict | Confidence |
|---|---|---|
| Company durability | Alive and shipping (same-day commits; 12 humans; OpenSats/HRF grants since 2023) — risk is grant non-renewal, not product death; Ditto/Shakespeare fork-survivable, Armada not yet | High |
| Licensing boundary | Apps AGPL-3.0 (client-facing mods must be published); Nostrify MIT confirmed; MKStack template ships NO license file (ask Soapbox before closed commercial reuse — ch. 10); mkstack-nsp AGPLv3 | High |
| Community ops | Ditto now (themes, 50+ Mastodon apps, real self-host: Deno+Postgres); no native DMs, no NIP-29 yet | High |
| Internal/company ops | Armada pilot only — E2E by default, serverless over public relays, unaudited 0.x moving daily | Med |
| Filesharing | Media-in-feed/chat yes; Drive/Dropbox replacement **no** (no folders/ACLs/versions; Blossom Drive deprecated → Bouquet) | High |
| Funding | Agora: permissionless, $0 fees, on-chain BTC only; fiat off-ramp + receipts are your problem | Med-High |
| Sites/funnels | Near-$0 mockups; native Lightning/Cashu; conversion stack external; no CMS for client self-edit | High |
| Publishing | NostrHub = discovery/credibility layer (metadata only, no artifact hosting); interop with gitworkshop/ngit verified | High |
| i18n readiness | Stack is EN-only **except Agora** (i18next, 16 locales, es 99.96%) — fork that pattern; no ratified Nostr language-tag NIP | High |
| Visualization | Recharts ships inside MKStack; Atlas-class census dashboards run zero-server (MapLibre+PMTiles+DuckDB-WASM); Ditto has no widget surface; 30023 forbids HTML | High |

## How to read this manual

- **Operator quick path:** this page → [07 — Integration Playbook](07-integration-playbook.md) (runbooks + a worked-example integration blueprint).
- **Builder path (v2, added 2026-07-10):** [11 — Nostrify](11-nostrify.md) → [12 — Building Consumer Apps](12-building-consumer-apps.md) → [06 — Foundations](06-nostr-foundations.md) as reference → [15 — Production](15-production-secrets-longevity.md) before anything ships. Relay decisions: [13](13-relay-operations.md); shipping channels: [14](14-distribution-native.md).
- **Product deep-dives:** 01 (company) · 02 (Ditto+Armada) · 03 (Agora) · 04 (Shakespeare) · 05 (NostrHub) · 10 (MKStack — the framework layer and agent contract).
- **Protocol layer:** [06 — Nostr Foundations](06-nostr-foundations.md) — read §1 (keys) before touching your credentials; master NIP table at the end.
- **Steering direction (build phase):** [08 — i18n](08-i18n-integration.md) → [09 — Visualization](09-visualization-integration.md) → [07 §9 blueprint](07-integration-playbook.md).

## Chapter index

| Ch. | File | One line |
|---|---|---|
| 01 | [01-soapbox-company.md](01-soapbox-company.md) | Who Soapbox is: history, funding, licenses, 45-product master map, durability |
| 02 | [02-community-ops.md](02-community-ops.md) | Ditto (public community) + Armada (E2E team chat) + the filesharing verdict |
| 03 | [03-agora.md](03-agora.md) | Non-custodial BTC fundraising: mechanics, fees, compliance reality, white-label |
| 04 | [04-shakespeare.md](04-shakespeare.md) | AI site builder: cost mechanics, mockup economics, funnel wiring, deploy paths |
| 05 | [05-nostrhub.md](05-nostrhub.md) | NostrHub 2.0: auth with your keys, publishing repos/apps/articles, governance |
| 06 | [06-nostr-foundations.md](06-nostr-foundations.md) | Keys, relays, kinds, payments, Blossom, moderation, DVMs — the protocol reference |
| 07 | [07-integration-playbook.md](07-integration-playbook.md) | Runbooks A–D, integration matrix, build opportunities, a worked-example modded-stack blueprint (TresPies) |
| 08 | [08-i18n-integration.md](08-i18n-integration.md) | i18n platforms × stack readiness: fork Agora's pattern, add Lingo.dev, symmetric parity gate |
| 09 | [09-visualization-integration.md](09-visualization-integration.md) | Viz components × stack: MapLibre+PMTiles+ECharts, the zero-server Atlas pattern |
| 10 | [10-mkstack.md](10-mkstack.md) | The framework layer: scaffold anatomy, AGENTS.md agent contract + `.mcp.json`, provider lanes, license flag |
| 11 | [11-nostrify.md](11-nostrify.md) | Nostrify: one interface, many backends — stores, pools, signers, schema, 20 policies, uploaders, the 9-package map |
| 12 | [12-building-consumer-apps.md](12-building-consumer-apps.md) | The builder curriculum: all 19 skills as definition-of-done, the Shakespeare→OpenCode→clone ladder, scaffold-vs-product, the AI-team pattern |
| 13 | [13-relay-operations.md](13-relay-operations.md) | Relay ops for an app team: strfry/khatru/Ditto/ditto-relay menu, archive-first pattern, monitoring, spam, budget |
| 14 | [14-distribution-native.md](14-distribution-native.md) | Distribution + native: Zapstore, Capacitor, Lockdown Mode, the PWA-push gap, signer channels |
| 15 | [15-production-secrets-longevity.md](15-production-secrets-longevity.md) | Production: durability economics, deletion vs law, operator liability, degradation, secrets/custody, exit playbook, incident catalog |

**v2 wave (2026-07-10):** chapters 11–15 added under the consumer-app builder lens; chapters 01/04/06/10 amended (see each chapter's Amended line). Gap analysis and production audit: maintainers' companion notes (not part of this public chapter set).

**v2.1 editorial pass (2026-07-10):** generalized for public, platform-agnostic readers; provenance section added.

Source of truth: this repository's `notes/manual/` directory, mirrored to the maintainers' internal workspace (internal: OTH-24 manual v1, OTH-25 v2 + hosting, PIP-94 build).