Learn
Observability

How to Know if My Bolt App Is Working

Visit your deployed Bolt app URL in an incognito window — not the Bolt preview, which runs in a WebContainer and behaves differently. For ongoing monitoring, set up UptimeRobot (free) to check your deployed URL every 5 minutes. Add Sentry for error tracking and your hosting platform analytics (Netlify Analytics, Vercel Analytics) for user activity.

Why this matters

Bolt apps run in a WebContainer during development but deploy to real hosting platforms (Netlify, Vercel, Bolt Cloud). The preview and the deployed version can behave differently — something that works in the preview might break in production. Without monitoring the actual deployed URL, you have no way to know if your live app is working.

What's at stake

A deployed Bolt app that breaks silently loses every visitor who tries it. Bolt makes it easy to build and deploy quickly, but that speed means problems can reach production just as quickly. Monitoring is the safety net that catches issues before your users do.

Step by step.

1

Check your deployed URL (not the preview)

Open an incognito window and visit your deployed app URL — the Netlify, Vercel, Cloudflare, or Bolt Cloud URL, not the Bolt.new preview. The preview runs in a WebContainer and does not represent your production environment. Test the core user flow: can someone land on the page, perform the main action, and succeed?

2

Set up UptimeRobot for your deployed URL

Create a free UptimeRobot account and add your deployed app URL as an HTTP(s) monitor. Set checks to every 5 minutes and add your email as an alert contact. This monitors the real production URL, not the Bolt preview.

3

Add Sentry for error tracking

Bolt generates standard JavaScript/React code, so Sentry works the same way as any other project. Install @sentry/react (or the SDK matching your framework), initialize it with your DSN, and configure alert rules for new errors.

import * as Sentry from "@sentry/react";

Sentry.init({
  dsn: "YOUR_SENTRY_DSN",
  tracesSampleRate: 1.0,
});
4

Check your hosting platform dashboard

Netlify, Vercel, and Cloudflare all provide deployment logs, function logs, and basic analytics. Check these dashboards for failed deployments, function errors, and traffic patterns. Bolt Cloud also shows deployment status and build logs.

5

Monitor Edge Function health

If your Bolt app uses Edge Functions (for secrets, API proxying, or authentication), monitor these separately. Edge Function failures mean your app loads but critical features like payments or auth stop working. Check your hosting platform's function logs for errors.

Know your Bolt app is working in production, not just in preview

  • Automated monitoring for your deployed Bolt app URL
  • Real-time alerts when your app or its functions go down
  • Production readiness checks covering the preview-to-production gap
Get started with BWORLDS

Frequently asked questions.

The Bolt preview runs in a WebContainer (an in-browser environment), while your deployed app runs on real server infrastructure. Common differences include: authentication does not work in preview, environment variables may not be configured on the hosting platform, and some APIs behave differently in production. Always test the deployed URL, not just the preview.

Bolt Cloud provides basic deployment status and build logs, but it does not include uptime monitoring, error tracking, or analytics. You still need external tools like UptimeRobot and Sentry for comprehensive monitoring.

Use both. Netlify provides function logs and deployment status, which helps with debugging. UptimeRobot monitors your actual URL from external locations, which tells you if users can reach your app. They complement each other.

If your Bolt app uses a database (Supabase, Neon, or another provider), monitor both the app URL and the database health. A working frontend with a failing database means users see the app but cannot load or save data. Check your database provider dashboard for connection issues.