Why your Bolt.new or Cursor app works for you and breaks for everyone else
There is a moment in every Bolt.new or Cursor build where the app stops being a demo. Up to that point it is fun. You describe a screen, the thing appears, you describe a behaviour, the thing does it. The demo video writes itself. Then you let one real person use it, and you find the parts that only ever worked because you were the one using it: the seed data that only exists on your laptop, the…
Building an AI-generated application like Bolt.new or Cursor can seem straightforward at first. You describe a screen, an action happens, and the demo video writes itself. However, this illusion crumbles when a real person uses the app for the first time. The problems that only worked in the controlled environment of the developer's machine suddenly surface.
One of the most common issues is the lack of a database. Instead of pulling data from a live database, the app uses seed data hardcoded into the code. This means that adding a fourth item causes it to disappear, leaving a blank screen or an undefined error for the user. The empty state was never designed, making it crucial for new users to have some content from the start.
Another problem is the absence of a proper error handling mechanism. Third-party APIs, such as payments, email, maps, storage, AI inference, or authentication, can fail in various ways. Without a fallback, users might see a spinning spinner that never resolves, leaving them confused and frustrated. Similarly, if the code calls these services without considering failure scenarios, users will encounter a blank screen or a spinner.
Furthermore, the deployment process can be a significant hurdle. The app works only because it is deployed from the developer's machine. The environment variables live in a .env file on the developer's machine, the database is a local file, and the build step assumes a folder that only exists locally. This makes it impossible for other users to access the app, rendering any fixes moot.
To avoid these pitfalls, developers should focus on building a real application that runs somewhere other than the developer's machine. The deployment should include a URL that can be accessed by others, with connection strings stored in the host's environment and migrations run by the deploy step. Once the app is live, test it thoroughly with real data and ensure that it gracefully handles empty states and errors.
Building empty and error states is equally important. Instead of a spinning spinner, provide a sentence that clearly communicates the issue and what the user should do next. This could be a message like, "An error occurred. Please try again later." Additionally, handle third-party API calls with timeouts and fallbacks. For instance, if a payment provider is down, the app should display an error message instead of leaving the user staring at a blank screen.
Finally, ensure that the app is fully functional before considering it complete. Can a new user sign up, perform the primary action, and achieve the expected result without any assistance? If not, the app is still a prototype that needs further development. For those who need help troubleshooting specific issues, resources like AppStuck provide platform-specific guides for Bolt, Lovable, Replit, Cursor, Base44, and v0. The troubleshooting process is similar across all platforms, but the tool names may vary.
Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.