# Reference design and sample catalog update — 11 November 2026

This update continues the existing application. It aligns the storefront and admin dashboard with the supplied composite reference: blush/burgundy store, portrait hero, occasion/creator circles, four product cards, benefits/newsletter/footer; navy admin sidebar, KPI cards, sales chart, creator/category panels, recent orders, stock alerts and quick actions. Other operational pages retain their functionality and use the shared admin shell. Exact pixel equality and every operational screen matching the reference are not certified.

## Existing hosting: no reinstall
1. Back up your current files and database using cPanel.
2. Extract this archive on your computer. Merge the contents of app/ and public/ into the matching folders of your existing installation, accepting file replacement. Do not delete .env, writable/, uploads, or your database. Do not upload the enclosing project folder as an extra nested directory.
3. Sign in with your existing owner/admin account.
4. Open More tools → Sample Data, or /index.php/admin/demo-data under your installed public URL.
   For your existing location: https://xbrainsolution.com/xb/public/index.php/admin/demo-data
5. Click Load reference samples. Refresh the storefront.

Fresh browser installation includes a checked sample-data option. That new checkbox wiring has been syntax inspected; this update's automated test exercises the existing-owner sample import, not a fresh installation wizard.

Samples: four editable actual catalog products and stock, six occasion categories, five approved example creator storefronts. Import is idempotent and preserves existing products. Sample creators have unknown random passwords and example.invalid email addresses. Dashboard sample sales/orders/commission totals and sample order rows are read-only presentation data, clearly marked DEMO; no fake order, payment, payout or earnings records are created. Show real dashboard figures disables simulated metrics; sample catalog stays editable/archiveable. Sample stock is real inventory: replace/archive it before accepting real sales.

Images are displayed from regions of the user-supplied reference, not original high-resolution product photographs. Replace them with your own source images before launch. Embedded labels/badges in the reference image are illustrative. No fake review ratings have been inserted. COD stays active; online gateways remain disabled, and creator payouts stay manual.

## Verification
Dedicated MariaDB 11.8 / CI4 4.7.6 / PHP 8.4 environment: migration command successful; 17 HTTP assertions and 15 Chromium browser checks passed. Checks cover owner import/reimport, live cart addition, catalogue listing, full dashboard modules, mounted sidebar navigation, switching back to real dashboard, desktop/mobile layout overflow and JavaScript errors. All application PHP files pass syntax validation. Browser screenshots were inspected internally against the supplied reference. JSON evidence and reproducible test scripts are included. These checks do not establish all 142 requirements or production readiness, and are not tests on your hosting account.

The numbered 142-item audit remains conservative. Previous unverified/partial/missing entries are not silently upgraded by this visual update. Live courier/gateway credentials and hosting verification remain external dependencies. See 142-REQUIREMENT-AUDIT.md and release reports for broader limitations.