Quick Start
This guide walks you through deploying your first app with Jetpacked. You'll go from a GitHub repository to a live HTTPS URL in under five minutes.
Prerequisites
- A GitHub account
- A repository with a JavaScript or TypeScript application
- The app must run locally (Jetpacked can't fix broken apps, only deploy working ones)
Step 1: Sign in with GitHub
Go to jetpacked.ai and click Get started. Jetpacked uses GitHub OAuth — there's no separate account to create. You'll be asked to authorize the Jetpacked GitHub App, which gives it read access to the repositories you select.
Step 2: Select a repository
After signing in, click Deploy a new app. You'll see a list of repositories your GitHub account has access to. Select the one you want to deploy.
Choose the branch you want to deploy from — typically main or master.
Step 3: Review the detection results
Jetpacked immediately reads your repository and shows you what it found:
- Framework — e.g. Next.js 14, AdonisJS 6, SvelteKit
- Runtime — Node.js version, or Bun
- Services — PostgreSQL, Redis, etc. if detected
- Build command — what will run to compile your app
- Start command — how your app will be launched in production
If anything looks wrong, you can override individual fields before deploying.
Step 4: Add environment variables
Switch to the Environment tab and add any secrets your app needs — API keys, auth secrets, third-party service credentials. Database URLs for auto-provisioned services are injected automatically and don't need to be added here.
Step 5: Deploy
Click Deploy. Jetpacked will:
- Clone your repository
- Install dependencies
- Provision any required databases
- Build your application
- Run migrations if detected
- Start your container
- Issue a TLS certificate and assign a
*.jetpacked.aiURL
The whole process typically takes between 1 and 4 minutes depending on your build.
Your app is live
Once the deploy completes, you'll see a green Live status and a URL you can share immediately. Every push to your selected branch triggers an automatic redeploy.
Next steps
- Custom domains — bring your own domain
- Environment variables — manage secrets and config
- Services — understand how databases and Redis are provisioned