mataba/shop/docs/ROADMAP.md

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.