================================================================================
                    WOOCOMMERCE POS - CLIENT SETUP & USER GUIDE
================================================================================

This package contains the standalone WooCommerce Point of Sale (POS) application
for Linux (64-bit).

--------------------------------------------------------------------------------
1. QUICK START (TWO WAYS TO RUN)
--------------------------------------------------------------------------------

OPTION A: Run directly without installing (Portable Mode)
  Open your terminal inside this folder and run:
      ./run.sh

OPTION B: Install to your Linux Application Menu (Recommended)
  Open your terminal inside this folder and run:
      ./install.sh

  Once installed:
  - Search for "WooCommerce POS" in your application launcher.
  - Or run the command in your terminal:
      woocommerce-pos

--------------------------------------------------------------------------------
2. DEMO LOGIN CREDENTIALS
--------------------------------------------------------------------------------
  Store URL:  https://woodemo.webkul.in/woocommerce-pos-app/
  Username:   mobikul
  Password:   admin

--------------------------------------------------------------------------------
3. FEATURES TO TEST
--------------------------------------------------------------------------------
1. ONLINE MODE:
   - When connected to the internet, navigating to Home will show a loading spinner
     while syncing the latest product catalog from the WooCommerce store.
   - As soon as products arrive, the loader automatically hides and the catalog
     is displayed.

2. OFFLINE MODE:
   - Disconnect your Wi-Fi or internet connection.
   - The app instantly switches to Offline mode.
   - Products are read directly from high-speed local cache with NO loader/waiting.
   - You can search products, add them to cart, and complete orders offline.

3. CHECKOUT & INVOICING:
   - Add items to the cart, navigate to payment, select payment type (Cash/Other),
     and click "Confirm Order".
   - View order confirmation and generate/print customer invoice receipts.

4. AUTOMATIC RESYNC:
   - Turn your Wi-Fi back on. Any orders created while offline will sync back
     to WooCommerce automatically.

--------------------------------------------------------------------------------
4. UNINSTALLATION
--------------------------------------------------------------------------------
To remove the application from your system at any time, run:
    ./uninstall.sh

--------------------------------------------------------------------------------
5. SYSTEM REQUIREMENTS
--------------------------------------------------------------------------------
- Linux 64-bit (x86_64) desktop (Ubuntu, Debian, Linux Mint, Fedora, Arch, etc.)
- GTK 3.0+ and SQLite3 libraries (pre-installed on standard Linux desktops).
================================================================================
