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

docs/resources/troubleshooting.mdx

@@ -0,0 +1,198 @@
+---
+title: Troubleshooting
+description: Common issues and their solutions
+date: 2024-01-31
+---
+
+## Blank Pages
+
+WooCommerce pages (shop, cart, checkout) show blank content.
+
+<div className="pl-4">
+   <Stepper>
+      <StepperItem title="Check SPA Mode Setting">
+         - Go to **WooNooW → Appearance → General**
+         - Ensure **SPA Mode** is set to "Full"
+         - If you want native WooCommerce, set to "Disabled"
+      </StepperItem>
+      <StepperItem title="Flush Permalinks">
+         - Go to **Settings → Permalinks**
+         - Click **Save Changes** (no changes needed)
+         - This refreshes rewrite rules
+      </StepperItem>
+      <StepperItem title="Clear Cache">
+         - If using a caching plugin:
+         - Clear page cache
+         - Clear object cache
+         - Purge CDN cache (if applicable)
+      </StepperItem>
+   </Stepper>
+</div>
+
+---
+
+## 404 Errors on SPA Routes
+
+Visiting `/store/shop` or `/store/product/...` shows a 404 error.
+
+<div className="pl-4">
+   <Stepper>
+      <StepperItem title="Flush Permalinks">
+         - Go to **Settings → Permalinks**
+         - Click **Save Changes**
+      </StepperItem>
+      <StepperItem title="Check Store Page Exists">
+         - Go to **Pages**
+         - Verify "Store" page exists and is published
+         - The page should contain `[woonoow_spa]` shortcode
+      </StepperItem>
+      <StepperItem title="Check SPA Page Setting">
+         - Go to **WooNooW → Appearance → General**
+         - Ensure **SPA Page** is set to the Store page
+      </StepperItem>
+   </Stepper>
+</div>
+
+---
+
+## Product Images Not Loading
+
+Products show placeholder images instead of actual images.
+
+<div className="pl-4">
+   <Stepper>
+      <StepperItem title="Regenerate Thumbnails">
+         - Install "Regenerate Thumbnails" plugin
+         - Run regeneration for all images
+      </StepperItem>
+      <StepperItem title="Check Image URLs">
+         - Ensure images have valid URLs
+         - Check for mixed content (HTTP vs HTTPS)
+      </StepperItem>
+   </Stepper>
+</div>
+
+---
+
+## Slow Performance
+
+SPA feels slow or laggy.
+
+<div className="pl-4">
+   <Stepper>
+      <StepperItem title="Enable Caching">
+         - Install a caching plugin (WP Super Cache, W3 Total Cache)
+         - Enable object caching (Redis/Memcached)
+      </StepperItem>
+      <StepperItem title="Optimize Images">
+         - Use WebP format
+         - Compress images before upload
+         - Use lazy loading
+      </StepperItem>
+      <StepperItem title="Check Server Resources">
+         - Upgrade hosting if on shared hosting
+         - Consider VPS or managed WordPress hosting
+      </StepperItem>
+   </Stepper>
+</div>
+
+---
+
+## Checkout Not Working
+
+Checkout page won't load or payment fails.
+
+<div className="pl-4">
+   <Stepper>
+      <StepperItem title="Check Payment Gateway">
+         - Go to **WooCommerce → Settings → Payments**
+         - Verify payment method is enabled
+         - Check API credentials
+      </StepperItem>
+      <StepperItem title="Check SSL Certificate">
+         - Checkout requires HTTPS
+         - Verify SSL is properly installed
+      </StepperItem>
+      <StepperItem title="Check for JavaScript Errors">
+         - Open browser Developer Tools (F12)
+         - Check Console for errors
+         - Look for blocked scripts
+      </StepperItem>
+   </Stepper>
+</div>
+
+---
+
+## Emails Not Sending
+
+Order confirmation emails not being received.
+
+<div className="pl-4">
+   <Stepper>
+      <StepperItem title="Check Email Settings">
+         - Go to **WooNooW → Settings → Notifications**
+         - Verify email types are enabled
+      </StepperItem>
+      <StepperItem title="Check WordPress Email">
+         - Test with a plugin like "Check & Log Email"
+         - Consider using SMTP plugin (WP Mail SMTP)
+      </StepperItem>
+      <StepperItem title="Check Spam Folder">
+         - Emails may be in recipient's spam folder
+         - Add sender to whitelist
+      </StepperItem>
+   </Stepper>
+</div>
+
+---
+
+## Plugin Conflicts
+
+WooNooW doesn't work after installing another plugin.
+
+<div className="pl-4">
+   <Stepper>
+      <StepperItem title="Steps to Diagnose">
+         - Deactivate other plugins one by one
+         - Switch to default theme (Twenty Twenty-Three)
+         - Check error logs in `wp-content/debug.log`
+      </StepperItem>
+      <StepperItem title="Check WordPress Email">
+         - Test with a plugin like "Check & Log Email"
+         - Consider using SMTP plugin (WP Mail SMTP)
+      </StepperItem>
+      <StepperItem title="Common Conflicting Plugins">
+         - Other WooCommerce template overrides
+         - Page builder plugins (sometimes)
+         - Heavy caching plugins (misconfigured)
+      </StepperItem>
+   </Stepper>
+</div>
+
+---
+
+## Getting More Help
+
+If you can't resolve the issue:
+
+<div className="pl-4">
+   <Stepper>
+      <StepperItem title="Collect Information">
+         - WordPress version
+         - WooCommerce version
+         - WooNooW version
+         - PHP version
+         - Error messages (from debug.log)
+      </StepperItem>
+      <StepperItem title="Enable Debug Mode">
+         - Add to `wp-config.php`:
+         ```php
+         define('WP_DEBUG', true);
+         define('WP_DEBUG_LOG', true);
+         ```
+      </StepperItem>
+      <StepperItem title="Contact Support">
+         - Provide the collected information for faster resolution.
+      </StepperItem>
+   </Stepper>
+</div>