Deploy Your App

Learn how to publish your INSTROC app to the web.

Quick Deploy

The fastest way to deploy:

1. Click the Publish button in the editor header
2. Choose your subdomain (e.g., myapp.instroc.app)
3. Click Deploy
4. Your app is live in seconds!

Deployment Options

INSTROC Hosting (Default)

Your app is hosted on our global CDN with:

• Instant deployment - Live in seconds
• Free SSL - HTTPS enabled automatically
• Global CDN - Fast loading worldwide
• Automatic scaling - Handles traffic spikes

Default URL format: yourproject.instroc.app

Custom Domain

Connect your own domain for a professional presence:

1. Click Settings in the publish dialog
2. Enter your domain (e.g., www.yoursite.com)
3. Add the DNS records shown
4. Wait for verification (usually < 5 minutes)
5. Deploy

See Custom Domains for detailed instructions.

What Gets Deployed

When you deploy, INSTROC packages:

• Frontend - Your React application
• Backend - API routes and serverless functions
• Database - Your data and schema
• Assets - Images, fonts, and files

Everything needed for your app to run.

Deployment Status

After clicking Deploy, you'll see:

Status	Meaning
Building	Code is being compiled
Deploying	Files are being distributed to CDN
Verifying	SSL and DNS being configured
Live	Your app is accessible

Most deployments complete in under 60 seconds.

Environment Variables

For apps with sensitive data or external integrations:

1. Go to Project Settings > Environment Variables
2. Add your variables (API keys, secrets)
3. Redeploy for changes to take effect

STRIPE_SECRET_KEY=sk_live_xxxxx
RESEND_API_KEY=re_xxxxx

See Environment Variables for details.

Preview Deployments

Test changes before going live:

1. Click the dropdown next to Publish
2. Select Preview Deploy
3. Get a unique preview URL
4. Share with team for review
5. Promote to production when ready

Preview URLs are temporary and expire after 24 hours.

Rollback

If something goes wrong:

1. Go to Deployments in project settings
2. Find a previous working deployment
3. Click Rollback
4. Previous version is restored

INSTROC keeps your last 10 deployments.

Deployment Hooks

Automate actions on deployment:

• Pre-deploy - Run tests, lint code
• Post-deploy - Notify team, clear cache

Configure in Project Settings > Deployment Hooks.

Monitoring

After deployment, monitor your app:

Analytics

• Page views and unique visitors
• Popular pages
• Geographic distribution

Errors

• Frontend errors captured automatically
• Error details and stack traces
• User impact metrics

Access in Project Settings > Analytics.

Best Practices

Before Deploying

• Test all functionality in preview
• Check mobile responsiveness
• Verify all links work
• Test forms and interactions

Performance

• Optimize images before uploading
• Use lazy loading for below-fold content
• Enable caching for static assets

Security

• Never expose API keys in frontend code
• Use environment variables for secrets
• Enable HTTPS (automatic with INSTROC)