READY

CatalogGuard demo setup status

The web runtime is configured and can serve install, callback, and webhook routes.

UAT / Boxhill lane. Shopify billing test mode is effective for UAT / Boxhill. Real charges are intentionally disabled.

Effective billing test mode. Enabled. UAT / Boxhill Shopify billing test mode is configured correctly.

Shopify-managed install and session mode. This deployment is configured for Shopify-managed install and token exchange. Managed embedded entry and protected route authority now rely on managed admin session establishment, while hosted rollout still requires aligned Shopify app configuration and store-level validation.

Use this page to confirm local setup before opening Shopify install, Meta connect, or webhook flows.

Environment readiness

Variable Type Status
CATALOGGUARD_APP_BASE_URL Required Configured
CATALOGGUARD_APP_DISTRIBUTION_LANE Optional Configured
CATALOGGUARD_AUTOMATED_REFRESH_INTERVAL_HOURS Optional Using default (24)
CATALOGGUARD_EMBEDDED_APP_PATH Optional Using default (/app)
CRON_SECRET Optional Configured
CRON_SECRET_PRIVILEGED Optional Using default (available)
META_API_VERSION Optional Configured
META_APP_ID Required Configured
META_APP_SECRET Required Configured
CATALOGGUARD_META_INITIAL_SYNC_LOOKBACK_DAYS Optional Using default (30)
CATALOGGUARD_META_OAUTH_CALLBACK_PATH Optional Configured
META_APP_SCOPES Required Configured
SHOPIFY_API_VERSION Optional Configured
CATALOGGUARD_PRODUCT_WEBHOOK_INGESTION_MODE Optional Using default (manual_sync_only)
CATALOGGUARD_SYNC_AUTOMATION_MODE Optional Configured
CATALOGGUARD_META_DIRECT_ID_DEFAULT_AUTOMATION_SHADOW_MODE Optional Configured
CATALOGGUARD_META_DIRECT_ID_DEFAULT_AUTOMATION_PROVIDER_READBACK_MODE Optional Configured
CATALOGGUARD_META_DIRECT_ID_DEFAULT_AUTOMATION_EXECUTE_MODE Optional Configured
CATALOGGUARD_SHOPIFY_INSTALL_MODE Optional Configured
SHOPIFY_APP_HANDLE Required Configured
SHOPIFY_APP_KEY Required Configured
SHOPIFY_APP_SECRET Required Configured
SHOPIFY_APP_SCOPES Required Configured
CATALOGGUARD_OAUTH_CALLBACK_PATH Optional Configured
CATALOGGUARD_OAUTH_STATE_COOKIE_NAME Optional Using default (catalogguard_oauth_state)
CATALOGGUARD_OAUTH_STATE_SECRET Required Configured
CATALOGGUARD_OAUTH_STATE_TTL_MS Optional Using default (600000)
CATALOGGUARD_TOKEN_ENCRYPTION_SECRET Required Configured
CATALOGGUARD_BILLING_PLAN_NAME Optional Configured
CATALOGGUARD_BILLING_AMOUNT_USD Optional Configured
CATALOGGUARD_BILLING_CURRENCY_CODE Optional Configured
CATALOGGUARD_BILLING_INTERVAL Optional Configured
CATALOGGUARD_BILLING_IS_TEST Optional Configured
CATALOGGUARD_BILLING_TRIAL_DAYS Optional Configured
CATALOGGUARD_SHOPIFY_INITIAL_ORDER_SYNC_LOOKBACK_DAYS Optional Using default (30)
CATALOGGUARD_SHOPIFY_OAUTH_CALLBACK_ENTRY_DEBUG_ENABLED Optional Configured
CATALOGGUARD_SHOPIFY_OAUTH_CALLBACK_HMAC_DEBUG_ENABLED Optional Configured
DATABASE_URL Required Configured

Demo checklist

  • Start the web runtime and confirm /health and /status respond.
  • Shopify billing test mode is effective, as required for UAT / Boxhill acceptance testing.
  • Keep CATALOGGUARD_SHOPIFY_INSTALL_MODE explicit. Current mode: shopify_managed.
  • Set Shopify app credentials and callback URL to https://uat.catalogguard.com/auth/callback.
  • Set Meta OAuth callback URL to https://uat.catalogguard.com/auth/meta/callback.
  • Open the embedded app in Shopify Admin or load /app?shop=your-store.myshopify.com when validating the managed embedded entry flow.
  • Connect Meta with /auth/meta/connect?shop=your-store.myshopify.com.

JSON diagnostics for automation, CI smoke checks, or deploy probes.

Founder trial readiness

This deployment is ready for repeated founder demos and internal trial walkthroughs.

Checkpoint Status Detail
Runtime and diagnostics ready The web runtime, setup diagnostics, and current operational checks are healthy enough for a founder-led trial.
Lane expectation info UAT / Boxhill is correctly using Shopify billing test mode, so acceptance testing cannot create real charges.
Shopify install mode info This deployment is configured for Shopify-managed installation and token exchange. Embedded entry and protected app routes now require managed admin session establishment before CatalogGuard marks Shopify Admin as openable, but hosted install rollout still depends on matching Shopify app configuration and a real store smoke pass.
Callback readiness ready Confirm Shopify and Meta point at https://uat.catalogguard.com/auth/callback and https://uat.catalogguard.com/auth/meta/callback before install/connect walkthroughs.
Support posture ready Keep `/status`, `/health`, and `pnpm queue:list` available during the trial so support and recovery checks stay quick.

Next commands

  • npx vercel env ls
  • npx vercel env add CATALOGGUARD_APP_BASE_URL production
  • npx vercel env add CATALOGGUARD_SHOPIFY_INSTALL_MODE production
  • npx vercel env add SHOPIFY_APP_HANDLE production
  • npx vercel env add SHOPIFY_APP_KEY production
  • npx vercel deploy --prod
  • pnpm queue:list

Operational readiness

Database diagnostics succeeded and the worker queue is within the current operational thresholds.

Check Status Detail
database ready Database queries completed successfully for runtime diagnostics.
worker queue ready Pending, retry, and processing job counts are within the current operational thresholds.

Queue summary

  • Pending: 0
  • Processing: 0
  • Retry scheduled: 0
  • Dead letter: 0
  • Completed: 203916

Recovery actions

  • No immediate recovery action is required.
  • Keep `/status` and worker logs available during demos, trials, and deploy smoke checks.

Expected services

  • Shopify app configuration
  • Meta app configuration
  • Postgres database
  • Web runtime
  • Worker runtime

Trial routes

Route Path Action
health /health Open route
app /app?shop=your-store.myshopify.com Open route
metaConnect /auth/meta/connect?shop=your-store.myshopify.com Open route
status /status Open route