# Factorize Setup — 5-minute quickstart

Turn a fresh WordPress into a complete Factorize store from one admin
screen — no shell, no Docker knowledge.

## Prerequisites

- A WordPress 6.2+ site you can administer (fresh is best — this installs
  plugins, switches the theme, and creates products/pages).
- The server can reach wordpress.org (WooCommerce downloads once) and can
  write its own `wp-content` folder (true on Docker and most hosts).

## Install

1. Upload the `factorize-setup` folder to `wp-content/plugins/` (or the zip
   via **Plugins → Add New**) and activate it.
2. A **Factorize** menu appears in the sidebar with a **Setup** tab and a
   Setup card.

## Build the store in 5 steps

1. **Factorize → Setup.** Read the warning — it changes this site.
2. **Identity:** store name, tagline, address, phone.
3. **What you sell** (tools / clothing / general) and a **color scheme**
   (five dark, four light — *Paper* is the Empire look on white).
4. **Features** to include (Auctions also installs the auction engine;
   Vision needs an Ollama box later) and **demo content** size.
5. Click **Build this store** and watch the steps tick: WooCommerce →
   auction engine → Factorize plugins → theme → palette/logo → products →
   catalog extras → auctions → demo member → storefront/home/menu → finish.
   The result panel links to the store, the hub, and the Customizer.

First build on a fresh site takes 2–4 minutes (the WooCommerce download and
product image generation are the slow parts).

## Afterwards

- Colors: **Appearance → Customize → Empire Theme — Palette** (35 tokens).
- Real products: delete the demo items (SKUs `DEMO-…`) and add yours.
- Each plugin's own knobs: its `README.md` / `QUICKSTART.md` under
  `wp-content/plugins/`, and the per-plugin "what I need from you" PDFs in
  `docs/needs/`.
- Re-run Setup any time to change palette or vertical; products are never
  duplicated.

## Troubleshooting

- **"wordpress.org lookup failed"** — the server has no internet; install
  WooCommerce manually, then run Setup again (it skips what is present).
- **"cannot initialize the WordPress filesystem"** — the web user cannot
  write `wp-content`; add `define( 'FS_METHOD', 'direct' );` to
  `wp-config.php` and fix folder ownership, or unzip `bundle/*.zip` into
  `wp-content/plugins` and `wp-content/themes` by hand and re-run.
- **A feature shows "not bundled"** — its zip is missing from `bundle/`;
  run `build-bundle.sh` from the repo, or copy the plugin folder in.
- **The Factorize menu is missing on a fresh site** — you are not an
  administrator; `manage_options` is required until WooCommerce exists.
