# XShop – Roadmap

## Versioning

SemVer. Start `1.0.0`. `CHANGELOG.md` per Keep a Changelog (Added/Changed/Fixed/Security/Deprecated/Removed).

## Phases

### Phase 0 – Requirements & Discovery ✅ (current)
- Specs: PRODUCT-SPEC, ARCHITECTURE, FEATURE-MATRIX, ROADMAP, UI-SPEC, DATABASE-MODEL, SECURITY, PERFORMANCE, TESTING, COMPATIBILITY.
- Repo scaffolding, initial milestone, commit.

### Phase 1 – Theme Foundation (M1)
- Theme header (`style.css`), screenshot, `functions.php` loader, `inc/setup/*`, menus/sidebars/image sizes.
- Design tokens (`assets/css/tokens.css`), base + logical props, RTL check, dark-mode tokens.
- Core templates: `index.php`, `front-page.php`, `header.php`, `footer.php`, `sidebar.php`, `single.php`, `page.php`, `archive.php`, `search.php`, `404.php`, `comments.php`.
- Template parts + components skeleton.
- Enqueue strategy + conditional loading.

### Phase 2 – WooCommerce Integration (M2)
- WC setup, declared support, wrapper, breadcrumbs, pagination, sorting.
- Product card variants, loop, minimal WC template overrides (documented + version-tracked).
- Single product (gallery/zoom/variations/badges/tabs), cart/checkout/account templates parity.
- Notices, stock, pricing, coupons, shipping, payment gateway compat.

### Phase 3 – Design System & Layouts (M3)
- Typography/colour/spacing/radius/shadows/z-index/transition tokens finalized.
- Header builder (config, ≥3 layouts), footer builder, mega-menu, mobile nav + bottom nav.
- Blog/product/shop layouts, search overlay, filter drawer, modals, etc.
- Dark mode coverage, RTL/LTR visual pass.

### Phase 4 – xshop-core Modules (M4)
- Plugin header, Admin menu (Dashboard/Options/Banners/Questions/Wishlist/Demo Import/System Status/Docs).
- Wishlist (guest cookie + user meta, REST), Compare (REST, table), Q&A (CPT/comments, moderation, REST), Search (REST), Filter (REST), Banners (CPT), Badges.
- Widgets/Elementor widgets (namespaced, translation-ready).

### Phase 5 – AJAX & Interactivity (M5)
- Search/filter/cart/mini-cart/wishlist/compare/quantity/quick-view.
- Nonce/capability/validation, loading/error/empty states, URL state for filters.

### Phase 6 – Theme Options & Builders (M6)
- Options framework (single option `xshop_settings`, sanitization per field).
- Import/Export, Custom CSS, Performance toggles.

### Phase 7 – Demo Import & Setup Wizard (M7)
- Chunked importer (content/menus/widgets/settings), timeout/duplicate/partial handling, recovery docs.
- Setup wizard flow, required plugins notice.

### Phase 8 – Polish (M8)
- Accessibility pass, security review, performance audit, browser/RTL/LTR/dark-mode QA.
- Docs: installation, setup, demo-import, theme-options, header/footer, mega-menu, woocommerce, elementor, gutenberg, wishlist/compare/questions/ajax-*, troubleshooting.
- Release package.

## Milestone Reporting

Each milestone ends with: completed / files changed / tests run / problems found+fixed / remaining / next.

## Exit Criteria for 1.0.0

All Phase 8 items + Definition of Done per feature.