◀Pass the VIP Pass
FLOW+LOGIC Kyon147/laravel-shopify #527 · ★ 499Forward the signed id_token to the install routeA real, public pull request, signed as made with Claude Code. See it on GitHub ↗
IN THE WORLD

Store owners opening Shopify apps avoid broken login loops and extra redirects.

REACH

Maintained by volunteers, this open-source Laravel package has over 401,000 Packagist downloads and 499 GitHub stars, helping PHP developers build Shopify apps.

WHAT IT MEANS

Merchants opening an app load right in via their signed token instead of hitting an OAuth redirect, and expired tokens fall back to a proper login link instead of crashing.

  • HulkAppsuses it
RED · how I did it
  • GONE Opening an uninstalled app drops any pass and sends you to the installer empty-handed.
  • An installer with no pass or code sends you to the manual login screen.
  • GONE An installer with a pass or code trades it to finish installation.
  • If you arrive with no pass at all, send to the permission screen.
  • If you have any pass and the trade succeeds, finish the installation.
  • GONE If you have any pass and the trade fails, stop with a missing address error.
GREEN · how I do it now
  • NEW Opening an uninstalled app forwards a signed pass to the installer, but drops unsigned ones.
  • An installer with no pass or code sends you to the manual login screen.
  • NEW An installer with a pass or code trades it; if trading a pass fails, go to manual login.
  • If you arrive with no pass at all, send to the permission screen.
  • If you have any pass and the trade succeeds, finish the installation.
  • NEW If an instant identity pass fails the trade, send to the permission screen.

WHERE Inside the Shopify store dashboard, right when a merchant clicks to open a newly added app.

SCENE You are a store owner opening a new app in your Shopify dashboard. Shopify hands you a signed pass so the app can set itself up without making you click through extra login screens.

Uninstalled
Your store is not set up in the app yet.
No pass
At the installer without any pass or login code.
Has pass
At the installer holding a signed pass from Shopify.
Has code
At the installer holding a login code from manual approval.
Login prompt
Sent to Shopify's manual login screen to approve the app.
Installed
Your store is connected and ready to use the app.
Error page
Setup failed with a missing login address error.
What can happen
Signed open · Unsigned open · Start setup · Swap works · Swap fails · Approve app
Login pass provided
What kind of temporary pass your store dashboard brings to the app. (None · Approval code · Instant identity pass)
Pass trade result
Whether Shopify accepts the pass when the app trades it for a permanent key. (Succeeds · Fails)