Tier access validation
Last updated: June 2, 2026. This page records code-level validation that StoreFix AI gates subscription features by the current active Shopify app subscription while recognizing the Shopify-managed $5/month Founding plan for the first-10 customer cohort. It is intended as launch evidence before opening the later monthly tiers.
First-10 customer shops keep Remediation-level features with no recurring StoreFix AI subscription charge.
Catalog scans, saved reports, CSV export, and quick review are available.
Adds merchant approval controls, editable drafts, bulk selection, rollback, and score tracking.
Adds larger catalog review, priority support triage, media retry queue, import workflow, and advanced reporting.
Access-control assertions
| Scenario tested | Expected entitlement | Higher-tier result |
|---|---|---|
| First 10 Founding-plan customers before later subscriptions launch | Legacy Lifetime access with Remediation-level features | Allowed |
| First-10 customer shop after subscriptions launch | Legacy Lifetime access from the shop allowlist | No subscription required |
| Active Approval Workflow subscription after subscription launch | Approval features enabled; Remediation-only features locked | Remediation locked |
| Cancelled Remediation subscription with no active paid subscription | Starter fallback | Approval and Remediation locked |
| Active Starter subscription plus cancelled Remediation history | Starter access only | Approval and Remediation locked |
| Plan-handle override set in env during subscription mode | Ignored unless explicit override flag is also set | No accidental unlock |
| Explicit test/operator override flag enabled | Override available for controlled validation only | Allowed only with flag |
Automated test evidence
node --test app/lib/billingPlans.test.mjspassed 17/17 after the Legacy Lifetime tier addition.- The failing red test proved the prior risk: a cancelled Remediation subscription could resolve as Remediation.
- The fixed entitlement resolver now uses only
ACTIVEShopify subscriptions for paid-tier feature access after the Founding phase. STOREFIX_CURRENT_PLAN_HANDLEno longer grants paid-tier access by itself in subscription mode;STOREFIX_ALLOW_PLAN_OVERRIDE=trueis required for controlled testing.- Legacy stores are identified by
STOREFIX_LEGACY_LIFETIME_SHOPSplus the current Shopify shop domain, or bySTOREFIX_LEGACY_LIFETIME_ACCESS=truefor controlled validation.
Feature gate mapping
| Feature family | Legacy Lifetime | Starter | Approval Workflow | Remediation |
|---|---|---|---|---|
| Catalog QA scans, saved reports, CSV export, quick review | Included | Included | Included | Included |
| Approval controls, editable drafts, bulk selection, rollback, score tracking | Included | Locked | Included | Included |
| Large catalog support, priority support, media retry queue, import workflow, advanced reporting | Included | Locked | Locked | Included |
Remaining pre-subscription action
Before enabling live subscription checkout, populate the first-10 shop allowlist, then run one Shopify billing sandbox walkthrough for Starter, Approval Workflow, and Remediation using test charges. Confirm the in-app Billing page displays Legacy Lifetime for allowlisted shops and the active paid tier plus locked features for non-legacy shops.