Skip to main content

Publishing Your App

Deploy your INSTROC application to the web with one click.

Quick Deploy​

  1. Click the Publish button in the editor header
  2. Choose your subdomain (e.g., myapp.instroc.app)
  3. Click Deploy

Your app is live in seconds!

Deployment Process​

When you deploy, INSTROC:

  1. Builds your application for production
  2. Optimizes assets (images, CSS, JavaScript)
  3. Deploys to our global edge network
  4. Provisions SSL certificate (HTTPS)
  5. Connects your database and backend

Deployment Options​

INSTROC Hosting​

The default and easiest option:

  • URL format: yourapp.instroc.app
  • Global CDN for fast loading worldwide
  • Automatic SSL with HTTPS
  • Zero configuration required
  • Free on all plans

Custom Domain​

Use your own domain:

  • URL format: www.yourdomain.com
  • DNS configuration required
  • SSL included
  • Available on Pro and Team plans

See Custom Domains for setup instructions.

Deployment Status​

Monitor your deployment in the publish dialog:

StatusDescription
QueuedDeployment is waiting to start
BuildingCode is being compiled
DeployingFiles distributing to CDN
VerifyingSSL and DNS verification
LiveDeployment complete
FailedError occurred (see logs)

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:

  • Unique per deployment
  • Expire after 24 hours
  • Don't affect production

Deployment Settings​

Build Settings​

Configure in Project Settings → Deployment:

  • Build Command: Default is next build
  • Output Directory: Default is .next
  • Node Version: 18 or 20

Environment Variables​

Set in Project Settings → Environment Variables:

DATABASE_URL=postgres://...
STRIPE_SECRET_KEY=sk_live_...

See Environment Variables for details.

Deployment History​

View past deployments:

  1. Go to Project Settings → Deployments
  2. See list of all deployments
  3. View status, time, and commit info
  4. Click to view build logs

Rollback​

Revert to a previous deployment:

  1. Find the working deployment in history
  2. Click Rollback
  3. Previous version goes live instantly

INSTROC keeps your last 10 deployments.

Continuous Deployment​

Auto-Deploy on Save (Coming Soon)​

Enable automatic deployments when you save changes.

Git Integration (Coming Soon)​

Connect to GitHub/GitLab for:

  • Deploy on push to main
  • Preview deploys on pull requests
  • Deployment status checks

Build Output​

Optimizations​

Production builds include:

  • Code minification - Smaller file sizes
  • Tree shaking - Remove unused code
  • Image optimization - WebP conversion, responsive sizes
  • CSS purging - Remove unused styles
  • Compression - Gzip/Brotli compression

Performance​

Built apps are optimized for speed:

  • Server-side rendering (SSR)
  • Static generation where possible
  • Automatic code splitting
  • Edge caching

Troubleshooting​

Build Failed​

Check build logs for specific errors:

Common issues:

  • TypeScript type errors
  • Missing dependencies
  • Invalid imports
  • Environment variables not set

Fix locally:

npm run build

Deployment Failed​

Verify settings:

  • Environment variables are set
  • Domain DNS is configured
  • No conflicting deployments

Site Not Updating​

Clear cache:

  • Hard refresh: Cmd/Ctrl + Shift + R
  • Clear browser cache
  • Wait for CDN propagation (5-10 minutes)

Best Practices​

Before Deploying​

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

Environment Management​

  • Use different env vars for dev/prod
  • Never commit secrets to code
  • Rotate keys periodically

Performance​

  • Optimize images before uploading
  • Use lazy loading for heavy content
  • Monitor Core Web Vitals

Security​

  • Keep dependencies updated
  • Use HTTPS everywhere
  • Implement rate limiting
  • Validate user input