// the find
Shopify/shopify-app-template-remix
Official Shopify starter template for building Admin-embedded apps using Remix (now React Router v7). Wires up OAuth, session storage, GraphQL Admin API access, webhooks, and Polaris in one go. Aimed at developers who want to skip the boilerplate and start writing actual app logic.
OAuth and session handling are pre-wired via @shopify/shopify-app-remix — no manual token juggling. Webhook routes are file-based and independently deployable, which keeps the handler surface small and easy to test. The embedded-app iframe gotchas (Link vs anchor, authenticated redirect vs plain redirect) are documented directly in the README rather than left for you to discover at 2am. Prisma is preconfigured with a migration for the sessions table, so you have a working DB schema from the first `npm run setup`.
The repo is effectively deprecated — the README's first sentence tells you to go use the React Router template instead, so adopting this means starting on a migration path immediately. Default storage is SQLite, which silently breaks the moment you run more than one instance; the README mentions this limitation but doesn't make it loud enough. The troubleshooting section is long and reactive rather than the template preventing the issues (OAuth scope loops, HMAC failures from admin-created webhooks, MongoDB replica set requirements) — each entry is a known footgun Shopify hasn't eliminated. No testing setup included: zero test files, no example of how to test a loader or webhook handler.