Building a Store
You have Porulle installed and a database wired up. Now you need to ship a store. This section is the recipe shelf — each page solves one task end-to-end.
Customer-facing
Section titled “Customer-facing” Authentication Roles, permissions, API keys, social login. The auth surface adopters configure first.
Email Notifications Order confirmations, password resets, custom transactional emails through Resend or SES.
Analytics SQL-backed analytics with scoped access for admin / vendor / customer views.
Retail operations
Section titled “Retail operations” Store Settings Org-scoped typed settings — currency, timezone, branding, policies — that other features read at runtime.
Receipts & Invoices HTML receipts, dependency-free PDF invoices, and atomic idempotent fiscal invoice numbering.
Tax Classes Per-product tax rates with variant overrides and per-line, discount-aware checkout tax.
Refunds & Exchanges Line-level refunds with daily caps and an undo window, plus atomic POS exchanges.
Bundled plugins
Section titled “Bundled plugins” Gift Cards Issue, redeem, and reconcile gift cards as a first-class commerce primitive.
Point of Sale In-store terminals, shift management, split payments, end-of-day Z-reports.
Layaway Partial-payment plans: reserve stock with a deposit, pay in installments, auto-complete to an order.
Supply Chain Procurement, production runs, warehouse transfers, wastage tracking.
Where to next
Section titled “Where to next”- Extending Porulle — when the bundled features don’t cover your case and you need to add hooks, plugins, or custom routes.
- Reference — the exhaustive API + configuration surface.
- Concepts — design rationale for the entity model, hook pipeline, and identity layer.