Files
WooNooW/customer-spa
Dwindi Ramadhana e64045b0e1 feat: Guest wishlist localStorage + visual state
Guest Wishlist Implementation:
Problem: Guests couldn't persist wishlist, no visual feedback on wishlisted items
Solution: Implemented localStorage-based guest wishlist system

Changes:
1. localStorage Storage:
   - Key: 'woonoow_guest_wishlist'
   - Stores array of product IDs
   - Persists across browser sessions
   - Loads on mount for guests

2. Dual Mode Logic:
   - Guest (not logged in): localStorage only
   - Logged in: API + database
   - isInWishlist() works for both modes

3. Visual State:
   - productIds Set tracks wishlisted items
   - Heart icons show filled state when in wishlist
   - Works in ProductCard, Product page, etc.

Result:
 Guests can add/remove items (persists in browser)
 Heart icons show filled state for wishlisted items
 No login required when guest wishlist enabled
 Seamless experience for both guests and logged-in users

Files Modified:
- customer-spa/src/hooks/useWishlist.ts (localStorage implementation)
- customer-spa/dist/app.js (rebuilt)

Note: Categories/Tags/Attributes pages already exist as placeholder pages
2025-12-26 23:07:18 +07:00
..

WooNooW Customer SPA

Modern React-based storefront and customer portal for WooNooW.

Features

  • Product Catalog - Browse products with filters and search
  • Shopping Cart - Add to cart with real-time updates
  • Checkout - Single-page checkout with address autocomplete
  • My Account - Order history, profile, and addresses
  • Mobile-First - Responsive design for all devices
  • PWA Ready - Offline support and app-like experience

Development

# Install dependencies
npm install

# Start dev server (https://woonoow.local:5174)
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

# Lint code
npm run lint

Project Structure

customer-spa/
├── src/
│   ├── pages/          # Page components (Shop, Cart, Checkout, Account)
│   ├── components/     # Reusable UI components
│   ├── lib/
│   │   ├── api/        # API client and endpoints
│   │   ├── cart/       # Cart state management (Zustand)
│   │   ├── checkout/   # Checkout logic
│   │   └── tracking/   # Analytics and pixel tracking
│   ├── hooks/          # Custom React hooks
│   ├── contexts/       # React contexts
│   └── types/          # TypeScript type definitions
├── public/             # Static assets
└── dist/               # Build output (generated)

Tech Stack

  • React 18 - UI framework
  • TypeScript - Type safety
  • Vite - Build tool
  • React Router - Routing
  • TanStack Query - Data fetching
  • Zustand - State management
  • TailwindCSS - Styling
  • shadcn/ui - UI components
  • React Hook Form - Form handling
  • Zod - Schema validation

API Integration

The SPA communicates with WordPress via REST API endpoints:

  • /wp-json/woonoow/v1/shop/* - Product catalog
  • /wp-json/woonoow/v1/cart/* - Shopping cart
  • /wp-json/woonoow/v1/checkout/* - Checkout process
  • /wp-json/woonoow/v1/account/* - Customer account

Deployment Modes

1. Shortcode Mode (Default)

Works with any WordPress theme via shortcodes:

  • [woonoow_shop]
  • [woonoow_cart]
  • [woonoow_checkout]
  • [woonoow_account]

2. Full SPA Mode

Takes over entire frontend for maximum performance.

3. Hybrid Mode

SSR for product pages (SEO), SPA for cart/checkout/account.

SEO & Tracking

  • SEO-Friendly - Server-side rendering for product pages
  • Analytics - Google Analytics, GTM support
  • Pixels - Facebook, TikTok, Pinterest pixel support
  • PixelMySite - Full compatibility

License

Proprietary - Part of WooNooW plugin