Files
commerce/app/store/README.md
zeekay 1943f1c093 Hanzo Commerce
Multi-tenant commerce and billing: orders, subscriptions, invoices, plans,
usage metering and a credit ledger. One Go binary. MIT OR Apache-2.0.

Claude-Session: https://claude.ai/code/session_01SAtaDFm8VDiWrhYHNNtxMw
2026-09-23 21:52:16 -07:00

2.1 KiB

Hanzo Commerce

Hanzo Commerce Storefront

A Next.js 15 storefront powered by the Hanzo Commerce API at api.commerce.hanzo.ai.

Prerequisites

To use the Hanzo Commerce Storefront, you need access to the Hanzo Commerce API.

The storefront connects to https://api.commerce.hanzo.ai by default, or you can set HANZO_COMMERCE_API_URL to point to a local or custom backend.

Overview

The Hanzo Commerce Storefront is built with:

Features include:

  • Full ecommerce support:
    • Product Detail Page
    • Product Overview Page
    • Product Collections
    • Cart
    • Checkout with Stripe
    • User Accounts
    • Order Details
  • Full Next.js 15 support:
    • App Router
    • Next fetching/caching
    • Server Components
    • Server Actions
    • Streaming
    • Static Pre-Rendering

Quickstart

Setting up the environment variables

Navigate into your projects directory and get your environment variables ready:

mv .env.template .env.local

Install dependencies

Use Yarn to install all dependencies.

yarn

Start developing

You are now ready to start up your project.

yarn dev

Open the code and start customizing

Your site is now running at http://localhost:8000!

Payment integrations

By default this starter supports the following payment integrations

To enable the integrations you need to add the following to your .env.local file:

NEXT_PUBLIC_STRIPE_KEY=<your-stripe-public-key>

Resources

Learn more about Hanzo Commerce

Learn more about Next.js