- A custom domain (in this case: generart.fit)
- Cloudflare account for tunneling
- Node.js and npm installed
-
Configure Cloudflare Tunnel
- Set up a Cloudflare tunnel for your domain
- Create a subdomain for the app (e.g., discount.generart.fit)
- Configure the tunnel to point to your local development server (usually port 3000)
- Start the tunnel from a terminal, you will get the details on the cloudflared when setting it up
-
Update Shopify App Configuration
- In
shopify.app.toml, set the following:
application_url = "https://discount.generart.fit:3000" [auth] redirect_urls = [ "https://discount.generart.fit:3000/api/auth" ]
- In
-
Update Shopify Partner Dashboard
- Go to your app in the Shopify Partner Dashboard
- Update the App URL to:
https://discount.generart.fit:3000 - Update the Allowed redirection URL(s) to:
https://discount.generart.fit:3000/api/auth
-
Start Development Server
npm run dev -- --tunnel-url https://discount.generart.fit:3000
- If you see
ERR_BLOCKED_BY_CLIENTerrors in the console, these are related to ad blockers and can be safely ignored - If the app shows a blank page, check:
- Cloudflare tunnel is running and accessible
- App URLs are correctly configured in
shopify.app.toml - All redirect URLs match exactly
- The
monorail-edge.shopifysvc.comerrors in console are from Shopify's analytics and don't affect app functionality - Always ensure your tunnel is running before starting the development server
- Use
shopify app config resetif you need to reset the configuration