Files
product_inventory/docs/SETUP.md
Ben Miller 418123d742 feat: add troubleshooting side panel and advanced queue controls
- Implemented a global toggle to enable/disable background queue processing.
- Added a Side Panel (Sidebar.html) to view pending edits.
- Added per-item controls: 'Delete' to remove from queue, 'Push' to force update.
- Updated 'onEditQueue.ts' with robust error handling for batch processing.
- Updated documentation (README, ARCHITECTURE) to reflect new features.
- Fixed 'clasp' deployment issues by cleaning up manifest management.
2025-12-24 21:14:19 -07:00

2.1 KiB

Setup Guide

Local Development Environment

  1. Install Node.js This project uses fnm to manage Node versions.

    # Install fnm (if not installed)
    winget install Schniz.fnm
    # Configure environment
    fnm env --use-on-cd | Out-String | Invoke-Expression
    # Install Node version
    fnm use --install-if-missing 22
    
  2. Install Dependencies

    npm install
    npm install -g @google/clasp
    
  3. Clasp Login Authenticate with Google to allow pushing code.

    clasp login
    
  4. Initialize Project You must either create a new Apps Script project or clone an existing one.

    • Option A: New Project
      clasp create --type sheets --title "Product Inventory" --rootDir ./dist
      
    • Option B: Existing Project
      clasp clone <scriptId> --rootDir ./dist
      

    Note: The --rootDir ./dist flag is crucial so that clasp knows where to look for files.

Google Sheets Configuration

  1. Create a Google Sheet (or use existing).
  2. "vars" Sheet: Create a tab named vars with the following columns: key, value. Add the following rows:
    • productPhotosFolderId: ID of the Drive folder for photos.
    • shopifyApiKey: Your Shopify API Key.
    • shopifyApiSecretKey: Your Shopify API Secret.
    • shopifyAdminApiAccessToken: The Admin API access token.
    • shopifyApiURI: e.g., https://your-store.myshopify.com
    • shopifyLocationId: Location ID for inventory.
    • shopifyCountryCodeOfOrigin: Two-letter country code (e.g., US).
    • shopifyProvinceCodeOfOrigin: Two-letter province code (e.g., NY).

Deployment

  1. Build

    npm run build
    
  2. Push to Apps Script

    npm run deploy
    
  3. Install Triggers Open the Apps Script editor (Extensions > Apps Script). Run the reinstallTriggers function manually once to set up the automation.