Get Started / Quickstart
Quickstart
Deploy your first app on Riven in under five minutes. Connect a GitHub repo, and Riven builds it, runs it, and gives you a live URL — hosted in Mumbai, billed in ₹.
You don't need a paid plan to start. The free tier lets you deploy right away, up to the limits of your plan. No card required.
0Before you start
You'll need two things:
- A Riven account — sign up with GitHub, Google, or Apple, or with your email and a password.
- A GitHub repository with your app's code pushed to it.
That's it. No CLI to install, no config files to write.
1Connect GitHub
From your dashboard, click New Service. Riven will ask you to connect your GitHub account the first time. This lets Rivenread your repos and listen for new pushes, so it can deploy automatically later.
Once connected, pick the repository you want to deploy.
Riven only asks for access to the repos you choose. You can change this anytime from your GitHub settings.
2Pick a service type
Riven has two tracks, because static sites and server apps cost very differently to run:
- Static Site — frontend apps that build into plain HTML, CSS, and JS (like a Vite + React app). Served fast, always available.
- Web Service — apps that run a server process (like an Express API or a Django app). These can scale to zero when idle to save you money.
Riven auto-detects your framework, so it usually picks the right track for you. If it looks wrong, it'll tell you which track to use instead.
3Configure your build
Riven reads your repo and fills in the build settings automatically. For most apps, you won't need to change anything. The fields you'll see:
- Branch — which Git branch to build from (e.g.
main). - Build Command — how to build your app (e.g.
npm run build). - Start Command — how to run it (e.g.
npm run preview). - Environment Variables — secrets and config your app needs at runtime, like API keys. You can paste a whole
.envfile here.
Adding env vars now? Paste your .env file directly using Add from .env — Riven splits it into keys and values for you.
4Deploy
Click Deploy. Riven now does the work:
Cloning your repo... Detecting framework... Vite + React Building Docker image... Pushing to registry... Deploying to Mumbai... ✓ Live at https://your-app.rivendeploy.com
You'll watch the logs stream live as it builds. When it's done, you get a live URL with HTTPS already set up. Open it — your app is online.
What happens on your next push?
Once your app is deployed, Riven keeps watching that branch. Every time you git push, Riven rebuilds and redeploys automatically — no clicks needed. This is on by default. You can turn it off per service inSettings → Auto Deploy.
Supported frameworks
Right now, Riven detects and deploys these four frameworks out of the box:
More frameworks are on the way. If your stack isn't listed yet, you can still deploy it by setting your own build and start commands manually.