Build & Start

Docs › App Hosting

Build & Start

Leave a field empty and NOVA works it out from your project. Fill one in when your app needs something different.

Build commandRuns before the live app starts, like npm run build. Setting only a start command keeps NOVA's own build.
Start commandHow the live app starts, like node server.js or gunicorn app:app. Previews keep NOVA's development server, so editing still reloads.
Root folderFor a repository with the app in a folder, like apps/web. Live deploys run from that folder.
Health check pathA deploy goes live once this page answers, like /healthz.
PortOnly for an app that always listens on one port. Better: read the PORT variable.

Dependencies

Before building, NOVA installs what your project declares, from its own files, the way Render does:

NodeYour package manager: packageManager in package.json, or the lockfile (pnpm-lock.yaml, yarn.lock, bun.lock, package-lock.json for exact versions). Dev dependencies are installed too, since builds need them.
Pythonrequirements.txt, Poetry (poetry.lock), uv (uv.lock), Pipenv (Pipfile), or a plain pyproject.toml or setup.py.
VersionsNode from .node-version, .nvmrc or engines; Python from .python-version, runtime.txt or requires-python.
PyTorchApps that use PyTorch (sentence-transformers, transformers and the like) get its CPU build: there is no GPU, and the default build is several gigabytes.

If an install or start fails for a known reason, like a package that needs Postgres files (use psycopg2-binary) or a Python version a package does not support, Make Live and the email say the likely fix in plain words.

Two things every app must do

  1. 1Listen on the port in PORT, or set Port above.
  2. 2Listen on 0.0.0.0, not 127.0.0.1 or localhost, so NOVA can reach it.
Express
app.listen(process.env.PORT || 3000, "0.0.0.0");
Flask with gunicorn (start command)
gunicorn --bind 0.0.0.0:$PORT app:app

Behind NOVA's HTTPS

Visitors reach your app over HTTPS through NOVA. Express apps are set up for this automatically, so secure cookies, sign-in and the real hostname work. A Flask app should use werkzeug's ProxyFix, and a Django app SECURE_PROXY_SSL_HEADER; Make Live warns you if one is missing.

Calls from other websites (CORS)

Your app decides its own CORS. Every request to its address, including a browser's preflight check (OPTIONS) before a POST, PUT or DELETE from another site, goes straight to your app, so allow the origins you want there (for Express, the cors package). NOVA adds no CORS rules of its own to your app.

Join our Discord

Chat with our engineers and become part of the active NOVA developer community.

Join Discord

Need help?

Open an issue on GitHub or email support@bridgeye.com.

Get help
Bridgeye • Autonomous Software Engineering.