Note

    production-plan

    Workstream checklist for listing, billing, compliance, and QA before launch

    Dates

    Created
    Not recorded
    Last updated
    Not recorded

    Document Metadata

    • title: Shopify App Store Launch Plan
    • description: Workstream checklist for listing, billing, compliance, and QA before launch
    • status: evolving
    • lastUpdated: "2026-03-06 14:34 ET (America/New_York)"
    • owner: Product/Engineering

    Shopify App Store Launch Plan This plan captures the remaining work required to move Bulk Product Editor from “review-read

    Shopify App Store Launch Plan

    This plan captures the remaining work required to move Bulk Product Editor from “review-ready” to “production-ready” on the Shopify App Store. Tasks are grouped by workstream so they can be owned in parallel. Check items off in the Partner Dashboard as you complete them.

    1. App Store Listing & Go‑To‑Market

    • Finalize listing copy
      • Description (short + long), feature bullets, target audience.
      • Primary and secondary keywords.
      • Pricing plan descriptions aligned with in-app messaging.
    • Visual assets
      • App icon (1200×1200 PNG/JPG, no rounded corners).
      • 3–5 screenshots (New bulk edit, Preview table, Job logs & duplicate, Usage/Billing).
      • Optional: 30–90s captioned promo video.
    • Listing metadata
      • Primary language, category, countries, tags.
      • Support, privacy, and terms URLs (ensure live pages with SUPPORT_EMAIL).
      • Emergency developer contact phone/email.
    • Reviewer package
      • Confirm docs/internal/listing/reviewer-instructions.md matches current UI, includes billing test and uninstall notes.
      • Prepare screencast (script + raw recording).

    2. Billing & Plan Validation

    • Enable production billing (test=false automatically when NODE_ENV=production).
    • Validate subscribe → confirm → redirect flow in a development store.
    • Validate cancellation via Shopify Admin billing page, ensure app reacts (e.g., downgrade usage gating).
    • Confirm plan copy matches listing pricing table (Starter / Standard / Advanced, no free tier).
    • Confirm Managed Pricing handles are configured and mapped correctly (starter, standard, advanced).

    3. Compliance & Data Handling

    • Verify privacy webhooks in Partner Dashboard (customers/data_request, customers/redact, shop/redact), re-test via CLI after deploys.
    • Confirm app/uninstalled and app/scopes_update remain green.
    • Ensure privacy policy reflects 90‑day log retention, uninstall behavior, contact info.
    • If not using protected customer data, opt out in Partner Dashboard.

    4. Deployment & Environment Readiness

    • Set production env vars (Render or hosting provider); app now validates these on boot:
      • SHOPIFY_API_KEY, SHOPIFY_API_SECRET, SCOPES (read_products,write_products)
      • SHOPIFY_APP_URL (public HTTPS), SHOPIFY_API_VERSION (2025-07), SUPPORT_EMAIL
      • DATABASE_URL, DIRECT_URL, JOB_QUEUE_ENABLED=1, NODE_ENV=production
    • Confirm webhook API version 2025-07 and Admin API version (SHOPIFY_API_VERSION, default July25) match deployed code.
    • Configure monitoring/error reporting (e.g., Sentry) and uptime checks for /app/health.
    • Document deploy checklist (db migrations, background job worker).

    5. QA & Review Readiness

    • Manual test pass in fresh development store:
      • Install → Auth → New bulk edit flow
      • Preview counts & tables
      • Job status transitions and cancellation
      • Billing gating (plan cap reached redirects to Upgrade)
      • Uninstall → reinstall workflow
    • Verify no console errors, loading/empty/error states show correctly.
    • Run automated checks in Partner Dashboard (App Setup).
    • Resolved QueryRoot.productsCount API health warning in code (limit: null) with regression coverage (tests/shopifyProducts.server.test.ts).
    • Verify in Shopify Dev Dashboard that deprecated-call warnings clear after deployment (deadline: April 1, 2026).
    • Record screencast after final UI polish.

    6. Submission & Post-Launch

    • Submit listing for review once all above is complete.
    • Monitor reviewer feedback, respond same day where possible.
    • Prepare launch comms and marketing landing page (separate repo).
    • After approval, tag production release and monitor logs + billing for first installs.

    Status tracking: use the repo TODOs or Partner Dashboard checklist to ensure nothing is missed. Update this document as tasks are completed or new items emerge.

    Provenance