Documentation

Two guides: one for the people who run a store day to day, and one for whoever installs and hosts it.

Running a shop that is already set up? Start with Signing in and your account, then Products and variants. No terminal needed.

Installing one? Getting started goes from a clone to a working checkout on the sandbox. Before a store takes real money, read Payments.

Running the shop

• Signing in and your account

  The admin, your profile settings, your password, and what your role lets you do.

• Products and variants

  Adding a product, its sizes or formats, prices, stock, and a picture.

• Categories

  Grouping products so shoppers can filter the catalog.

• Digital products

  Selling downloads: attaching files and choosing who gets which.

• Orders

  Finding an order, packing and shipping it, emails, and download access.

• Your team

  Adding people, choosing their role, resetting passwords, and disabling accounts.

• AI assistants

  Letting an assistant such as Claude manage products and orders for you.

Hosting the store

• Getting started

  The local stack, a demo catalog, and the first administrator.

• Configuration

  What it needs to boot, secrets, and the settings most stores change.

• Payments

  Setting up PayFast and SnapScan, and going live safely.

• Theming

  Restyling with custom properties, overriding templates, and using a theme in a deployment.

• Deploying

  The two ready-made Compose stacks, backups, and running it anywhere else.

These pages are a guide. The full reference — every setting, and the reasoning behind each decision — is the docs/ directory in the repository.