Symptom guide / Publishing and display
Works in preview. Breaks live.
The editor demo works, but the same action on the public address fails or returns different data.
Pick one journey, such as opening a page or saving a disposable note. Compare that same journey using the same kind of test account in both environments. Preview and production may intentionally have different data. The useful question is whether the live app is built, configured and connected to the services intended for live visitors.
01 / Procedure
The two-minute check.
- Write down both addresses.
Open preview and the public app in separate tabs. Record the exact failing action and which tab fails. Confirm you are comparing the expected version, not an older browser tab or a different project with a similar name.
- Compare the requests.
In each tab open Inspect, then Network. Run the action once and select the request it triggers. Compare its destination host, path and status. Read the failed Response, with private values removed before sharing.
- Read the production build result.
On Vercel, open the project’s Deployments list, select the relevant deployment and expand Building in its details. On Netlify, open Deploys, select the deploy and read its deploy log. Compare the command, revision and first failure with what preview actually runs.
- Check the production configuration.
Open the host’s environment settings and compare required variable names and production scope with the code. Do not print secret values into logs. Note any variable that exists only in preview, then use the environment guide for the appropriate host.
02 / Evidence
Read the result.
WORKSThe same test journey completes against the intended live service.
BROKENProduction’s build, destination or response differs in a way that prevents the journey.
03 / Repair
Causes and fixes.
Ranked in the order to investigate, not by claimed frequency.
- Live runs another revision or build command.
Select the intended source and production build configuration. Repair the first build failure rather than changing unrelated UI code. Open the resulting deployment address and repeat the exact failing journey.
- Production points at the wrong service.
Correct the production destination and required configuration. Keep test and live projects deliberately separated; copying all preview settings blindly may route real users into test data.
- The published hosting type cannot run the backend.
Confirm whether the app needs a running server or only static files. Deploy the server portion to an appropriate runtime and make the client call that deployed endpoint.
04 / Limits
Edge cases.
- A custom domain can reach a different deployment from the host’s deployment URL. Compare both before assuming the build itself is wrong.
- A homepage loading does not prove an inner route or server action works. Reproduce the exact failing path and action rather than stopping at the first screen.
When to stop and hand it over
Hand over if the build and live requests disagree about which project is running, or if the repair requires changing hosting architecture. Send both URLs, the deployment identifier and the first relevant log excerpt after removing secrets.
05 / Questions
Before the next attempt.
Does a working preview prove deployment is configured?
No. Confirm the live build, service addresses and environment settings separately.
Should I change every setting to match preview?
No. Some differences are intentional. Change only the mismatch supported by the failing request or build log.