---
title: "ADR 0001: One public reference monorepo"
sidebar:
  order: 1
---

## Status

Accepted, 2026-10-29.

## Context

Patronage's earlier reference work was spread across several `launch-*` repos, and one of them committed paid plugins and thousands of third-party files. The goal now is an open-source set of Reference sites that anyone can run, with hosted demos.

## Decision

Launch is one public monorepo, started from a fresh snapshot with no imported git history.

- `apps/*` holds deployable apps, `packages/*` shared libraries, and `wordpress-shared/*` Patronage's own WordPress plugins and tooling.
- No third-party plugin, theme or vendor code is committed. WordPress plugins come in through Composer; npm packages are dependencies, never copies.
- No client references anywhere: code, fixtures, docs, issues, PRs or commit messages. The Demo site is invented.
- Engineering docs live in `docs/` (this folder, `docs/agents/`, `docs/spikes/`). Public docs are the `apps/docs-site` Blume site, which publishes `docs/spikes/` as written.

## Consequences

- Everything an agent writes, including issue and PR text, must be fit to publish.
- Plugins that are not on Packagist are installed from their GitHub release zips through Composer `package` repositories.
- Free, GPL software is preferred where a paid option would stop someone running the repo (see [ADR 0010](/decisions/wordpress-fields-in-php)).