Deploying Your App

You’ve built something great in Vibecode. Now it’s time to share it with the world. This guide walks you through deploying your project so anyone can access it—not just you.

​

What is Deployment?

When you build an app in Vibecode, it lives inside the Vibecode environment. You can test it, tweak it, and play with it all you want. But if you want other people to use your app—whether that’s your friends, your customers, or anyone with your testflight build, your project needs to be deployed. Think of deployment like publishing a book. Writing the book is one thing, but it needs to go to a printer and get distributed before anyone can read it. Deployment is the “printing and distribution” step for your app. Once deployed, your app gets its own public URL (and API endpoint) that works anywhere — on any device, any browser, anytime. Your project goes from a private experiment to a live, working product.

​

Why Vibecode Deployments?

You may have heard of AWS, Railway, Render, or others hosting providers, but they come with trade-offs:

• AWS is powerful but notoriously complex. It’s built for engineers with infrastructure experience.
• Railway and Render are simpler, but you’ll still need to configure environments, manage build pipelines, and troubleshoot on your own.

Vibecode Deployments is built specifically for apps created on our platform. Everything just works—no configuration headaches, no separate accounts, no DevOps knowledge required. Your app goes live in a few clicks. Now, if you’re excited to fully launch your project, find out how by following the step-by-step guide with images below!

​

Step 1: Open the Deployment Menu

In your project, look for the Deploy button in the top right corner of the screen. Click it to open the deployment dropdown menu. This menu is your home base for everything deployment-related—launching new deployments, checking on existing ones, and accessing your deployment dashboard.

​

Step 2: Choose Your URL (WEBSITE ONLY)

The first time you deploy, you’ll pick a URL for your project. This is the web address people will use to access your app. Mobile apps will also have their server hosted, but since it is not accessible directly as a URL, this step is skipped. Choose something memorable and relevant to your project. Your URL will look like yourProject.vibecode.app or similar. Custom domain integrations are coming soon!

​

Step 3: Configure Environment Variables

Next, you’ll review and confirm your environment variables. These are the secret (API) keys your app needs to connect to external services. Important: Many API providers give you two sets of keys—test keys and production keys. Test keys work during development, but you need production keys for your deployed app. For example:

• RevenueCat has sandbox keys and production keys
• Stripe has test mode and live mode API keys

Double-check that you’re using your production keys here. Using test keys in a deployed app can cause features to break or behave unexpectedly.

​

Step 4: Launch Your Deployment

Once your URL and environment variables are set, hit Deploy. Vibecode will build and publish your app. This usually takes a minute or two. When it’s done, your app is live. You can share the URL with anyone (for websites), and they’ll be able to use your app immediately. If you have a Testflight build, you may need to publish a new build pointing to your deployed backend.

​

Step 5: Access the Deployment Dashboard

After deploying, you can manage everything from the deployment dashboard. Access it through the deployment dropdown -> ‘deployment details’ button. There is also a all ‘deployments’ page which is accessible on the Vibecode workspace home page under ‘App library’ on the left. The dashboard gives you full visibility into your deployed app—what’s happening, what’s broken, and what needs attention.

​

The Deployment Dashboard

Your deployment dashboard has seven tabs, each serving a specific purpose:

​

Deployment History

View a complete history of every deployment you’ve made. See when each version went live, roll back to previous versions if something goes wrong, and track changes over time.

​

Database

If your app uses Vibecode Cloud for data storage, this tab lets you view and edit your data, which can be big assistance in debugging.

​

Logs

This is where you’ll spend time when something isn’t working. Production logs show you what’s happening inside your deployed app—errors, warnings, and any logging your agent added to the code.

​

Environment

View and edit your environment variables after deployment. If you need to rotate an API key, add a new integration, or fix a misconfigured secret, this is where you do it.

​

Analytics (coming soon!)

Track how people are using your app. See visitor counts, popular pages, and usage patterns. (Coming soon)

​

Domain

Configure your app’s domain settings. By default, you get a .vibecode.app subdomain, but custom domain support is on the way. (Custom domains coming soon)

​

Settings

General settings for your deployment. Manage access, or take down your deployment if needed.

​

Pricing

Deployment pricing is straightforward and included with your Vibecode subscription: Need more? Additional deployments are $20/month each.

​

Payment and Billing

The included deployments with your plan (1 for Plus, 3 for Pro, 5 for Max) are part of your Vibecode subscription. As long as your subscription is active, these deployments stay online at no extra cost.

​

Adding More Deployments

If you need more deployments than your plan includes, you have two options:

1. Upgrade your plan — Moving from Plus to Pro (or Pro to Max) gives you more included deployments
2. Pay for additional deployments — Each extra deployment costs $20/month, billed separately

​

Updating Payment Information

You can update your payment method in two places:

• From the Deploy dropdown menu
• From the deployment dashboard for a specific project

​

What Happens if a Payment Fails?

If a payment fails, you have a 7-day grace period to update your payment information. During this time, your deployments will continue to work normally.

​

Troubleshooting

Deployment failed?

• Check your environment variables for typos or missing values
• Review the build logs for specific error messages
• Make sure your app runs correctly inside Vibecode before deploying

App not working after deployment?

• Check the Logs tab in your dashboard for errors
• Verify you’re using production API keys, not test keys
• Try redeploying after making fixes

Can’t access the dashboard?

• Make sure you’re signed into the same account that created the deployment
• Try refreshing the page or signing out and back in