Instasupport

Engineering hub

Shopify engineering guides for app and storefront teams

This hub is for engineers and technical leads working on extension architecture, auth flows, Admin API usage, backend boundaries, and implementation quality inside serious Shopify systems.

What this hub covers

If the bottleneck is architecture rather than copy or merchandising, this is the technical entry point into the site.

Updated April 5, 2026

Curated topic archive

6 pages grouped around platform engineering

Search the library
React frontend plus Rails backend for Shopify embedded apps cover image
Developer guide
Guides
16 min readUpdated March 12, 2026

React frontend plus Rails backend for Shopify embedded apps

How to structure a Shopify embedded app with React on the frontend and Rails on the backend, including auth boundaries, deployment shape, and the operational tradeoffs that matter in production.

guidesShopify developerRails
Shopify OAuth and managed install in Rails apps cover image
Developer guide
Guides
15 min readUpdated March 12, 2026

Shopify OAuth and managed install in Rails apps

A guide to the current Shopify installation model for Rails apps, explaining where managed install replaces older OAuth assumptions and where authorization code grant still matters.

guidesShopify developerOAuth
Shopify session tokens in Rails cover image
Developer guide
Guides
15 min readUpdated March 12, 2026

Shopify session tokens in Rails

A Rails-focused guide to Shopify session tokens for embedded apps, covering the Shopify App gem, token exchange, frontend request flow, and the mistakes that still break production auth.

guidesShopify developersession tokens
Shopify Admin GraphQL patterns in Rails cover image
Developer guide
Guides
18 min readUpdated March 12, 2026

Shopify Admin GraphQL patterns in Rails

Production patterns for using the Shopify Admin GraphQL API from Rails, including service boundaries, pagination strategy, throttling, partial failure handling, and when to switch to bulk operations.

guidesShopify developerAdmin GraphQL API
Checkout UI Extensions with a custom backend architecture cover image
Developer guide
Guides
15 min readUpdated March 12, 2026

Checkout UI Extensions with a custom backend architecture

A practical backend architecture guide for Shopify Checkout UI Extensions, covering when to call your own backend, how to keep the extension thin, and where teams overbuild the server side.

guidesShopify developerCheckout UI Extensions
Shopify Bulk Operations in Rails cover image
Developer guide
Guides
16 min readUpdated March 12, 2026

Shopify Bulk Operations in Rails

A Rails implementation guide for Shopify Bulk Operations covering job orchestration, JSONL downloads, polling versus webhooks, and the service boundaries that make large syncs maintainable.

guidesShopify developerbulk operations