Aurora Commerce README

Latest release v1.0.1 · 2026-07-11 · this is the file that ships inside the package

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.