ioy.aiFind the blocked step
Use the setup stage and exact error to choose your next action.
The local site does not open
Check Node version, dependency installation, migrations and the running npm run dev terminal. Open exactly http://127.0.0.1:5188. If changing the host or port, update both the browser address and wrangler.local.jsonc APP_URL; local authentication uses that origin.
Authentication is not configured
Run node scripts/local-secrets.mjs in the project. Preserve the generated .dev.vars; an empty copied example is not a valid authentication secret. Local email reading also needs LOCAL_TEST_TOKEN and the running server.
I expected a real email or AI result
The default local reference is a simulation. Follow service configuration, configure your independent preview and inspect actual results. Never infer delivery or payment from the presence of a Key or a returned page.
Google or Turnstile rejects the request
Check exact origin, Web OAuth Client, authorized redirect /api/auth/callback/google, test users, HTTPS requirements, widget hostname and paired site/secret keys. localhost and 127.0.0.1 are different origins.
A payment option is unavailable
Check billing mode, provider, all required keys and the current test:<planId> or live:<planId> mapping. Stripe requires price_…. Check the matching webhook secret, not the API key or a different endpoint's secret.
A task or payment stays unknown
Keep the task/order ID, request ID and provider reference. Inspect stored state and reconcile the original operation. Do not clear an unknown reservation or retry an external paid call blindly.
The generated product still describes the template
The generator sets siteMode="product" and replaces operator content with end-user starting content. For older projects, compare the new generator/content changes with upgrade:diff, preserve custom work, and update the site mode and content deliberately. Merely renaming the template's homepage is not enough.
The dashboard or GA4 report is missing
Check administrator email, TOTP and a recent session. GA4 browser Measurement ID and numeric Property ID are different; backend reports need service account access and the Data API. Consult the full README configuration table, then repeat the affected flow only.