refactor: Migrate documentation content, rebuild UI components, and update core architecture.

docs/marketing/wishlist.mdx

@@ -0,0 +1,39 @@
+---
+title: Wishlist
+description: Allow customers to save products for later purchasing.
+---
+
+The **Wishlist** module allows customers to save their favorite products to a dedicated list, increasing retention and future purchases.
+
+## Overview
+
+A wishlist provides a way for shoppers to create personalized collections of products they want to buy and save them for future reference.
+
+### Key Features
+*   **Guest Wishlists**: Allow non-logged-in users to save items (stored in their browser).
+*   **User Integration**: Logged-in users' wishlists are saved to their account.
+*   **One-Click Add**: Customers can move items from wishlist to cart instantly.
+
+## Configuration
+
+To access Wishlist settings, go to **Settings > Modules > Wishlist**.
+
+![Wishlist Settings](/assets/screenshots/wishlist_settings_screenshot.png)
+
+### General Settings
+*   **Enable Guest Wishlists**: If enabled, guests can add items to a wishlist which is stored in their browser's local storage. If disabled, users must log in to use the wishlist.
+*   **Show Icon in Header**: displays a heart icon with a counter in the site header.
+*   **Max Items Per Wishlist**: Set a limit on how many items can be saved (Set to `0` for unlimited).
+*   **Show "Add to Cart"**: Display a direct add-to-cart button next to each item in the wishlist view.
+
+## Usage
+
+### For Customers
+1.  **Adding Items**: Click the Heart icon on any product card or product page.
+2.  **Viewing Wishlist**: Click the Heart icon in the header or visit `/wishlist`.
+3.  **Managing**: Removing items is done by clicking the Heart icon again or the "Remove" button in the list.
+
+### Future Features (Coming Soon)
+*   **Sharing**: Ability to share public wishlist links.
+*   **Back in Stock**: Auto-notifications for saved items.
+*   **Multiple Lists**: Create detailed lists (e.g., "Birthday", "Holiday").