Table of Contents
Quick Answer
Use the official Shopify CLI with the Remix template, then use Cursor or Claude Code to build embedded admin pages, webhook handlers, and GraphQL Admin API queries. Submit to the Shopify App Store or distribute as a custom app.
- Time to MVP: 1-2 weeks
- Cost: $0 dev; $99/yr for Partner Store if selling
- Stack: Remix, Prisma, Shopify Polaris, App Bridge
What You'll Need
- Shopify Partner account (free)
- Development store (created in Partner dashboard)
- Node.js 20+, pnpm
- Cursor or Claude Code
- Cloudflare tunnel or ngrok for local webhooks
Steps
- Install Shopify CLI. Run pnpm dlx @shopify/create-app@latest. Choose Remix template. CLI handles OAuth scaffolding.
- Run dev tunnel. shopify app dev opens a tunnel and installs the app on your dev store. The URL hot-reloads.
- Design admin UI with Polaris. Ask AI: "Build a Polaris v12 admin page with a ResourceList of products fetched via GraphQL Admin API." Shopify App Bridge handles navigation.
- Add webhooks. In shopify.app.toml, declare webhooks (orders/create, app/uninstalled). AI can generate the handler in app/routes/webhooks.*.
- Implement billing. Use Shopify's Billing API via the billingRequire helper. Support monthly recurring charges and usage charges. Test in development store (waived).
- Handle GDPR mandatory webhooks. customers/data_request, customers/redact, shop/redact — required for App Store submission.
- Submit for review. Complete the App Store listing, screenshots, privacy policy, and demo video. Review takes 1-4 weeks.
Common Mistakes
- Not using App Bridge: Embedded apps require it for session tokens and navigation.
- Using REST when GraphQL is mandatory: Shopify deprecated REST Admin API for new apps in 2024+.
- Skipping GDPR webhooks: Auto-rejection on submission.
- Hardcoding shop domains: Always derive from session.
- Not testing uninstall cleanup: app/uninstalled must remove sensitive data.
Top Tools
Tool
Best For
Price
Shopify CLI
Scaffolding + tunneling
Free
Polaris
Shopify design system
Free
Prisma
ORM for shop sessions
Free
Partner Dashboard
App management
Free
App Store
Distribution
15-20% rev share
FAQs
Q: Public app vs custom app?
Public = App Store + revenue share. Custom = single merchant, no review, faster to ship.
Q: Do I need React?
The Remix template uses React. You can use Vue/Svelte but lose Polaris components.
Q: How does billing work?
Shopify charges the merchant and pays you monthly minus 15-20%. Use billingRequire to gate features.
Q: What's App Bridge?
A library that lets your iframe-embedded app communicate with Shopify admin (navigation, toasts, modals).
Q: Where do I store session tokens?
Prisma + PostgreSQL (Supabase self-hosted works). The template scaffolds this automatically.
Q: Can I test without a real store?
Yes — Partner dashboard gives unlimited free development stores.
Conclusion
Shopify apps are a profitable niche — merchants pay well for tools that save time. Follow the Remix template, layer on Polaris, and ship a focused app. One good app can replace a salary.