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 devopens 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 inapp/routes/webhooks.*. - Implement billing. Use Shopify's Billing API via the
billingRequirehelper. 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/uninstalledmust 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 |
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.