BLUEBETA

FAQ

Common questions and troubleshooting tips for the Blue platform.

Getting Started

What is Blue?

Blue is a platform for publishing apps made with AI. Just upload a ZIP file and your app is live on the web instantly.

What runtimes are supported?

Blue currently supports four runtimes:

  • python — Python applications
  • node — Node.js applications
  • php — PHP applications
  • static — Static HTML/CSS/JS sites
Can I publish just HTML?

Yes. Upload a ZIP containing an index.html file and it will be published as a static app. You can also include CSS and JavaScript files.

Can I sign up without an invite code?

If your email domain is on the whitelist, you can sign up without an invite code. Otherwise, you will need an invite code from an existing user.

Deploy & App Management

How do I deploy?

There are three ways to deploy:

  • Console — Upload a ZIP file from the console
  • AI Build — Enter a prompt inside Blue and publish directly
  • API — Use a deploy key (API key) for automated deployment
How do I update my app?

Click "Redeploy" on your app card in the console and upload a new ZIP file. Your app URL stays the same.

Can I password-protect my app?

Yes. You can change the visibility level of your app in the console:

  • Casual — Protected with a simple password
  • Safe — Stronger access restriction
  • Private — Only you can access it
How do I create a ZIP?

Make sure the entry file (index.html, main.py, etc.) is at the root level of the ZIP, not nested inside a folder.

Tip: Select the files themselves and compress, rather than compressing the parent folder. An extra folder layer can cause runtime detection to fail.

Troubleshooting

Runtime not detected (DETECTION_FAILED)

Your files are likely nested one level too deep inside the ZIP. Make sure the entry file (index.html, main.py, etc.) is at the root of the ZIP, not inside a subfolder.

If you compressed a folder instead of individual files, re-compress by selecting the files directly.

App won't start (START_FAILED)

Common causes:

  • Dependency installation failed
  • The app is listening on the wrong port
  • There is an error in the code

Check the logs in the console for error messages.

Security scan blocked my app

The deployment security scan blocks apps that contain dangerous patterns such as reverse shells or system file access.

Code inside dependency directories like node_modules is excluded from the scan. Review your own code and remove any flagged patterns.

App stopped unexpectedly

Common reasons for automatic shutdown:

  • Idle timeout — Apps are stopped after a period of inactivity
  • Health check failure — The app stopped responding correctly
  • Admin action — Stopped due to a terms-of-service violation

Check your app card in the console to see the stop reason.

Plan limits reached

Each plan has limits on the number of apps and resources. If you have reached your limit:

  • Stop or delete unused apps to free up capacity
  • Upgrade your plan to increase the limits
How to read logs

Open your app card in the console and click "Logs" to see recent output. Click "Live Logs" to stream logs in real time.

If an error occurs, you will find error messages and stack traces in the log output.

Back to Support Glossary Demo Apps