# Your Factorize demo site — setup guide

This folder is a complete, self-contained WooCommerce store: the Factorize
theme, the Factorize plugins you selected, and a demo seed that fills it
with placeholder products, generated images, a logo in your palette, and
every bundled feature switched on and visible.

## Requirements

- **Docker** (Docker Desktop on Windows/Mac, Docker Engine on Linux) — running.
- Internet on first run only (WordPress + WooCommerce download once).
- One free port (the installer asks; default **8650**).

## Install

```
./start.sh
```

That's the whole thing. The installer asks, in order:

| Question | Default | Notes |
|---|---|---|
| Port | 8650 | where the site will listen |
| Admin username | admin | wp-admin login |
| Admin password | random | shown again in the final summary — save it |
| Admin email | admin@example.com | |
| Site URL | http://localhost:PORT | use your LAN IP or domain if others will browse it |
| Auction length | 7 days | only asked when Auctions is bundled |

It then boots the containers, installs WordPress and WooCommerce, activates
the theme and your Factorize plugins, and seeds the demo store. First run
takes a few minutes (image downloads); the summary prints every URL and
credential when it finishes.

Answers can be pre-set for unattended installs:
`ST_PORT=8123 ST_ADMIN_USER=boss ST_ADMIN_PASS=secret ./start.sh`

On Windows (Git Bash) the questions appear as native Windows dialogs; on
Linux/macOS as terminal dialogs; `ST_NO_TUI=1 ./start.sh` forces plain
prompts anywhere.

## What the demo contains

- **A catalog that matches what you sell** — the builder asked "tools",
  "clothing", or "general" and seeded that vertical's categories, product
  names, and tile art (garment silhouettes for clothing).
- **Your palette, dark or light** — five dark schemes and three light ones
  (linen / cloud / blush); every one of the theme's 35 color tokens is set,
  so a light store has light cards, panels, form fields, and scrims too.
- **Products** with generated placeholder images, six to eight categories, retail
  prices (so the "% below retail — source" line shows), varied stock (some
  out-of-stock items prove the stock-always-last sorting) and sales history
  (sold badges, Best deals rank).
- **Auctions** (if bundled): ~60% of in-stock products become live auctions
  with opening bids, reserves, Buy Now prices, and the one-tap quick bid.
- **A paid demo member** — `member@example.com` / `DemoMember1!` — log in
  with it to see the member discount and shipping credit at checkout.
- **A generated logo + favicon** from your store name in your palette, a
  storefront photo band, and a Visit-the-Store map section with your
  address and phone.
- **The Factorize hub**: wp-admin → Factorize — category tabs with a card
  for every bundled plugin (Store Stats, Marketplace, Vision Intake open
  from there when bundled).

## Customize it

- **Colors**: Appearance → Customize → *Empire Theme — Palette* (35 tokens,
  including panels, secondary text, alert, hero gradient ends, and scrim —
  enough to go fully light or fully dark).
- **Chrome**: Appearance → Customize → *Empire Theme — Features* (bottom
  bar, desktop nav, account icon…).
- **Store identity**: address/hours/phone live in the
  `factorize-storefront_options` option; each plugin's knobs are documented
  in its `README.md` and `QUICKSTART.md` under `wp-content/plugins/`.
- **Real products**: delete the demo items (they're tagged with SKUs
  `DEMO-0001…`) and add your own — every feature keeps working.

## Day-2 commands

```
docker compose down       # stop (data kept)
docker compose up -d      # start again
docker compose down -v    # wipe EVERYTHING and start fresh
./start.sh                # safe to re-run; re-applies settings
```

## Troubleshooting

- **"Docker is not running"** — start Docker Desktop, re-run `./start.sh`.
- **Port already in use** — re-run and pick another port; then
  `docker compose down` the old stack if you started one.
- **Vision Intake shows "server unreachable"** — it expects an Ollama box
  (see `wp-content/plugins/factorize-vision/QUICKSTART.md`); every other
  feature works without it.
- **Blank site right after install** — give it ~30 seconds on first load
  while WordPress warms up, then refresh.
