# EasySite Pro — Install Guide

**Full documentation index:** [docs/README.md](README.md)

## Requirements

- WordPress 6.0+
- PHP 7.4+
- (Optional) WooCommerce for shop sections

## Install

1. Download `easysite-pro-ultimate-bundle.zip` or `easysite-pro-basic.zip` from `dist/`
2. In WordPress admin go to **Appearance → Themes → Add New → Upload Theme**
3. Upload the zip and click **Activate**
4. For Ultimate Bundle, activate the **EasySite Pro Child** theme (recommended)

## First run

1. You will be redirected to **EasySite Setup**
2. Complete the 5-step wizard (site name, colors, starter site)
3. Click **Edit your site visually** on the homepage

## Ultimate Bundle license

1. Go to **EasySite Setup → License**
2. Enter your key (format `ESITE-XXXX-XXXX`) and click **Activate**
3. For local development without a key, leave the field empty (no remote license server required)

## Updating

When a remote update URL is configured, updates appear under **Appearance → Themes**.

## Basic vs Ultimate

| Feature | Basic | Ultimate |
|---------|-------|----------|
| Visual editor | ✓ | ✓ |
| Core sections | 10 | 17 + shop |
| Client role & white-label | — | ✓ |
| Site kit import/export | — | ✓ |
| Section library | — | ✓ |
| License required | No | Yes (when selling) |

See [CLIENT-HANDOFF.md](CLIENT-HANDOFF.md) for agency workflows.
See [CLIENT-GUIDE.md](CLIENT-GUIDE.md) to share with site owners.
See [guides/AGENCY-SETUP.md](guides/AGENCY-SETUP.md) for the full build-and-handoff workflow.
See [DISTRIBUTOR.md](DISTRIBUTOR.md) for license server setup.
See [ROADMAP-1.7.md](ROADMAP-1.7.md) for the next release plan.
