Quickstart

Use this page as the index into the host-first setup docs.

New to Accrue and want the what can I build with this picture before the setup steps? Read Jobs to Be Done first — a ~15-minute tour of every billing flow, organized by the life of a paying customer.

Start with First Hour

The canonical setup walkthrough lives in First Hour. Open that guide and pick a capsule (H for an existing Hex app, M for this monorepo’s examples/accrue_host, R for read-only mix verify / mix verify.full) — each joins the same spine; this page stays a hub only.

The walkthrough follows the Phoenix host-app order proved in examples/accrue_host:

• deps and mix deps.get
• mix accrue.install
• config/runtime.exs
• migrations and Oban
• mix mailglass.install then mix ecto.migrate — creates mailglass_deliveries, mailglass_events, mailglass_suppressions. See the email guide for details.
• /webhooks/stripe
• accrue_admin "/billing"
• first Fake-backed subscription
• focused host tests

Focused guides

• Jobs to Be Done — narrative tour of the billing flows (subscribe, change plan, refunds, dunning, portal, admin) plus a scope-and-maturity summary.
• Auth adapters — production Accrue.Auth wiring; pick an adapter instead of inventing callbacks.
• Entitlements — gate features on what they paid for; fail-closed gate API plus Plug and LiveView guards.
• Organization billing (non-Sigra) — session→billable org path when the Stripe Customer should follow an organization, not only the signed-in user.
• Troubleshooting for setup diagnostics and exact verify commands.
• Webhooks for the public use Accrue.Webhook.Handler boundary, raw-body placement, signatures, and replay.
• Testing for use Accrue.Test and Fake-backed host proofs.
• Upgrade for generated-file ownership and installer rerun behavior.