Xyppy Help Center

Appearance

2026-03-05: Release Readiness + Shopify API Health ​

Goal ​

Prepare the app for a safe merge to main and validate Shopify platform readiness ahead of upcoming API deprecations.

Context ​

  • Pricing model changed (no free tier, managed billing flow).
  • Current branch is not mergeable yet due to conflicts and failing GitHub checks.
  • Shopify Dev Dashboard/API Health review is required for deprecations flagged for next month.

Scope ​

In scope:

  • Shopify Dev Dashboard/API Health audit for deprecations and required migrations.
  • Validate billing/pricing messaging and behavior against Shopify app best practices.
  • Resolve merge blockers (main conflicts, CI, dependency audit, CLA workflow).
  • Reconfirm app/runtime health after updates.

Out of scope:

  • New feature delivery unrelated to merge-readiness.

Risks ​

  • API deprecations may require code changes in routes/services that touch Admin GraphQL.
  • Dependency upgrades for audit fixes can introduce regression risk.
  • Pricing/trial messaging drift between app copy and Partner Dashboard can create review/compliance issues.

Task Checklist ​

  • [ ] Review Shopify Dev Dashboard API health/deprecations and capture each affected endpoint/field.
  • [ ] Map each deprecation to code locations and create a migration plan.
  • [ ] Confirm billing flow behavior end-to-end in a dev store (subscribe, trial visibility, manage plan).
  • [ ] Validate no “free tier” claims remain where policy/copy should state paid subscription model.
  • [ ] Rebase/merge main into staging and resolve conflicts.
  • [ ] Fix failing PR checks:
    • [ ] audit-and-outdated
    • [ ] cla workflow configuration (cla-token missing)
  • [ ] Re-run full local validation:
    • [ ] npm test --silent
    • [ ] npx playwright test --project=tier-tier3 --workers=1
  • [ ] Push updates and re-check PR status/checks.

Deliverables ​

  • Deprecation impact list with code references.
  • Applied fixes (or issue list) for deprecations and CI blockers.
  • Updated PR in mergeable state with passing required checks.

Exit Criteria ​

  • PR is mergeable into main with no conflicts.
  • Required CI checks are green.
  • No unresolved Shopify deprecation blockers for next month.
  • Billing/pricing behavior and copy are aligned with Shopify-managed pricing setup.