Skip to main content

​
Common Issues

​
”Premium Required” Error

When trying to deploy, you see a message: “Deployment is a premium feature. Upgrade to deploy your applications.”
  1. Verify you have an active premium subscription
  2. Go to Account Settings → Billing
  3. If expired, upgrade your account
  4. Refresh the page and try again

​
Subdomain Already Taken

You see: “This subdomain is already taken. Please try another one.”
The subdomain is in use by another user or project. Try:
  • Add numbers or hyphens: myapp-2024, my-awesome-app
  • Use a more specific name: portfolio-john, store-demo-v2
  • Check for typos in your desired subdomain
  • Use the Check button to test availability before deploying

​
Invalid Subdomain Format

Error: “Subdomain must be 3-63 characters, contain only lowercase letters, numbers, and hyphens…”
Ensure your subdomain:
✓ Is 3-63 characters long
✓ Contains only: a-z, 0-9, and hyphens (-)
✓ Starts with a letter or number
✓ Ends with a letter or number
✗ No spaces, underscores, or special characters
✗ No uppercase letters
Examples:
  • ✓ my-app
  • ✓ app123
  • ✓ my-app-2024
  • ✗ My-App (uppercase)
  • ✗ my_app (underscore)
  • ✗ -myapp (starts with hyphen)

​
Reserved Subdomain

Error: “This subdomain is reserved and cannot be used”
You’re trying to use a protected keyword. Choose a different name. Reserved words include:
  • System: api, www, app, admin
  • Development: preview, webcontainer, staging, dev, test
  • Infrastructure: cdn, static, assets
Add a suffix or prefix to your desired name: my-app, app-name, name-store

​
Unauthorized Error

“Only the owner can deploy this application” or “Unauthorized”
Deployment management is restricted to project owners only. If you need to deploy:
  1. Ask the project owner to deploy
  2. Fork the project to create your own copy
  3. Deploy your forked version with your own subdomain

​
Application Issues

​
Application Not Loading

The deployment succeeded but visiting the URL shows a loading screen or error
  1. Wait 30 seconds and refresh - initial deployment may take a moment
  2. Check if the application works in preview mode
  3. Try a different browser or incognito mode
  4. Clear your browser cache
  5. If the issue persists, try redeploying the same version

​
Features Not Working in Production

Application loads but certain features don’t work (API calls, integrations, etc.)
This usually happens with integrations:
  1. Go to the Integrations tab
  2. Verify integrations are enabled for this project
  3. Check that integration credentials are correct
  4. Generate a new version with "fix integration issues"
  5. Deploy the new version

​
Wrong Version Deployed

The deployed application doesn’t match your latest changes
Check which version is deployed:
  1. Go to Deployment tab
  2. Look at Version to Deploy dropdown
  3. The “(Currently Deployed)” label shows the active version
  4. Select your desired version and click Update Deployment

​
Deployment Process Issues

​
Deployment Stuck

The “Deploying…” message appears indefinitely
  1. Wait 2 minutes - sometimes it takes longer
  2. Refresh the page
  3. Check your internet connection
  4. Try deploying again
  5. If it continues, contact support with your project ID

​
Cannot Update Deployment

Update Deployment button is disabled or doesn’t appear
The button only appears when you make changes. Ensure:
  • You’ve selected a different version than currently deployed, OR
  • You’ve entered a different subdomain than current
  • Your premium subscription is active
  • You are the project owner

​
Undeploy Failed

Error when trying to undeploy application
  1. Refresh the page and try again
  2. Check your internet connection
  3. Verify you’re the project owner
  4. If error persists, the deployment may already be inactive

​
Browser-Specific Issues

​
SSL Certificate Error

Browser shows “Your connection is not private” or SSL certificate warning
This is rare but can happen:
  1. Wait a few minutes for SSL certificate provisioning
  2. Clear your browser’s SSL cache
  3. Try accessing via incognito/private mode
  4. If persists after 10 minutes, contact support

​
Mixed Content Warnings

Browser console shows “Mixed Content” errors
Your application is trying to load HTTP resources on an HTTPS page:
  1. Check for hardcoded http:// URLs in your code
  2. Use relative URLs or https:// for all external resources
  3. Generate a new version fixing these issues
  4. Redeploy the corrected version

​
Getting Additional Help

If you’ve tried these solutions and still have issues:

Discord Community

Ask the community for help with deployment issues

Contact Support

Submit a support ticket from your account settings
When reporting issues, include:
  • Your project ID or URL
  • The subdomain you’re trying to use
  • Screenshots of error messages
  • Steps to reproduce the issue

​
Prevention Tips

Avoid common issues by following these practices:
Test your application in preview mode before deploying
Use the Check button to verify subdomain availability
Keep your subscription active
Choose descriptive, unique subdomains
Test integrations before deploying
Deploy stable versions, not experimental changes