Aurora Commerce — Phoenix LiveView Commerce Template
A production-ready Phoenix LiveView starter for a custom online store: a headless-ready catalogue, a native Elixir commerce domain, Stripe payments, merchant operations, localization, PWA behavior, and a signature spatial product experience.
Commercial template. See
license.md. Not open source.
Quick start
# 1. Postgres running (Docker: `docker run -e POSTGRES_PASSWORD=postgres -p 5432:5432 postgres:16-alpine`)
cp .env.example .env # fill in SECRET_KEY_BASE (mix phx.gen.secret) + Stripe test keys
mix setup # deps, db create/migrate, seed demo catalogue, build assets
mix phx.server # http://localhost:4000
Seeded accounts and a full test-payment walkthrough are in
docs/quickstart.md. Stripe test-mode setup and webhook testing are in
docs/guides/stripe-setup.md.
What’s inside
- Native commerce domain — products, variants, options, collections, media, inventory, carts, promotions, orders, payments, refunds, fulfillment, subscriptions, and auditable state transitions. Integer-minor-unit money.
- Adapter boundaries — catalogue (local Ecto + Contentful), payments (Stripe Checkout), tax, shipping, search, email, analytics, and AI are all swappable.
- Experiential storefront — editorial home, collections, product detail, cart drawer, and a Three.js “collection room” signature scene with a full no-canvas / reduced-motion equivalent.
- Checkout & payments — Stripe-hosted Checkout, webhook-driven order state, promotions, tax/shipping estimates, subscriptions via Billing + Customer Portal.
- Accounts & admin — customer accounts, order history/timeline, and a merchant admin workspace for catalogue, inventory, orders, refunds, and analytics.
- Global & resilient — Gettext localization, multi-currency display, PWA offline catalogue, SEO/structured data, observability, and an optional AI layer.
Documentation
-
Architecture & decisions:
docs/adr/,docs/traceability/ -
Guides:
docs/guides/(Stripe, CMS, tax/shipping, rebranding, i18n, deploy) -
Phase evidence:
evidence/phase-NN/report.md
See AGENTS.md / CLAUDE.md for coding conventions.