Web Applications

Deploy web applications from a Git repository. ZevCloud supports any language or framework that can run in a container.

Supported Frameworks

ZevCloud uses Nixpacks to auto-detect and build your application:

Framework	Auto-Detected	Default Port
Next.js	✅	3000
React (Vite/CRA)	✅	3000
Express / Node.js	✅	3000
NestJS	✅	3000
Python (Django/Flask)	✅	8000
Go	✅	8080
Ruby on Rails	✅	3000
PHP / Laravel	✅	8000
Rust	✅	8080
Static HTML	✅	80

Deploying from GitHub

Public Repositories

1. Add Service → Web Application → Public Repository
2. Paste the repository URL (e.g., https://github.com/user/repo)
3. Select the branch
4. Configure and deploy

Private Repositories

1. Add Service → Web Application → Import from GitHub
2. If not connected, click "Connect GitHub" to install the ZevCloud GitHub App
3. Select your repository from the list
4. Select the branch
5. Configure and deploy

GitHub Organizations

You can connect multiple GitHub accounts and organizations. Each installation gives ZevCloud access to the repos you choose.

Build Configuration

ZevCloud auto-detects most settings, but you can customize:

Setting	Description	Example
Build Command	Command to build your app	npm run build
Install Command	Command to install dependencies	npm ci
Start Command	Command to start your app	npm start
Output Directory	For static builds	dist, .next, build
Root Directory	If your app is in a subdirectory	packages/web
Port	Port your app listens on	3000

These can be set during creation or updated in Service Settings.

Environment Variables

Set environment variables in the Variables tab of your service:

DATABASE_URL=postgres://user:pass@host:5432/db
NODE_ENV=production
API_KEY=sk_live_...

Variables marked as secret are encrypted at rest and hidden in the UI.

Auto-Deploy on Push

When you push to the configured branch, ZevCloud automatically:

1. Receives a GitHub webhook
2. Clones the latest code
3. Builds using Nixpacks
4. Deploys with zero-downtime rollout
5. Sends an email notification (success or failure)

Disable auto-deploy in Service Settings → Build & Deploy.

Build Logs

View real-time build logs in the Deployments tab. Each deployment shows:

• Git commit message and SHA
• Build duration
• Success or failure status
• Detailed build output

Resource Limits

Each plan provides different resource limits:

Plan	Memory	CPU	Build Timeout
Free	512 MB	1 core	10 min
Starter	2 GB	1 core	20 min
Pro	4 GB	2 cores	30 min
Business	8 GB	4 cores	60 min

Rollback

If a deployment fails or causes issues, you can redeploy a previous version from the Deployments tab.