voltbase
Dashboard

Hosting

Import a GitHub repo and ship to the edge from the Voltbase dashboard — DB + deploy in one product.

Git import → live URL

Hosting builds your frontend and publishes it to the edge. Your Voltbase project URL and anon key are injected automatically.

Overview

Open a project → Hosting → connect GitHub → import a repository → Deploy. Status streams through Queued → Installing → Building → Deploying → Ready.

Platform setup

On Voltbase Cloud, Hosting is managed for you. On a self-hosted API, set Hosting credentials and root domain (see apps/api/.env.example):

.env
# Hosting edge credentials (see .env.example)
HOSTING_ROOT_DOMAIN=apps.voltbase.dev
# Optional dedicated GitHub OAuth (falls back to GITHUB_CLIENT_*)
HOSTING_GITHUB_CLIENT_ID=
HOSTING_GITHUB_CLIENT_SECRET=
HOSTING_GITHUB_CALLBACK_URL=https://api.example.com/api/hosting/github/callback

GitHub OAuth app callback must match HOSTING_GITHUB_CALLBACK_URL (or the default /api/hosting/github/callback).

Deploy a site

  1. Connect GitHub from the Hosting empty state.
  2. Import a repository (search + org filters).
  3. Confirm auto-detected framework (edit build/output if needed).
  4. Optionally paste environment variables before Deploy.
  5. Click Deploy and watch the build theater.
  6. Visit the preview URL when Ready.

Environment variables

System env (always injected for the detected framework):

injected.env
VOLTBASE_URL=https://api…/projects/your-slug
VOLTBASE_ANON_KEY=…
VITE_VOLTBASE_URL=…          # Vite
VITE_VOLTBASE_ANON_KEY=…
NEXT_PUBLIC_VOLTBASE_URL=…   # Next static export
NEXT_PUBLIC_VOLTBASE_ANON_KEY=…
PUBLIC_VOLTBASE_URL=…        # Astro / SvelteKit
NUXT_PUBLIC_VOLTBASE_URL=…   # Nuxt

Frameworks

Supported on Hosting: Vite React/Vue, Astro, Nuxt generate, SvelteKit, and Next.js with output: 'export'. Full Next SSR needs Hosting Pro — see the Edge Functions plan.

Framework guides: Frameworks overview.

Custom domain / DNS

Production alias target: https://{projectSlug}.apps.voltbase.dev. Point your Hosting root domain DNS as documented for your workspace. Until custom DNS is ready, use the preview URL shown in the dashboard.

Limits

Hosting includes a soft project cap (shown in the dashboard near the limit). Upgrade to Hosting Pro for higher caps and shared Edge Functions capacity.