Connect a repo and deploy for the first time

Works with GitHub, GitLab and Bitbucket, for both public and private repos.

  1. Go to the Static Web menu and click Deploy from Git.
  2. Choose your Git provider, enter the repository URL and a token (for a private repo), then click Check repository.
  3. The framework is detected and build settings are suggested. Check the Node.js version, install/build commands and output folder.
  4. Turn on Auto Deploy if you want a build on every push, then click deploy.
ProviderToken to use
GitHubFine-grained token with Contents: Read-only
GitLabToken with the read_api scope, Reporter role or higher
BitbucketRepository token (Repositories: Read) or an app password with your username

Supports Next.js (you must set output: 'export'), Nuxt, Gatsby, Astro, SvelteKit (adapter-static), Docusaurus, VitePress, Eleventy, Angular, Vue, Vite, Create React App and plain HTML.

Build-time variables are built into your website files, which anyone can see. Never put passwords or secrets in them.

Static Web shares the number-of-websites quota with drag-and-drop websites. Builds per month: Free 30 · Starter 40 · Business 120. You can connect your own domain in the Settings > Domains tab, with the same steps as for websites (paid plans).

Still stuck? Let our team help

Open a ticket from the Console. Tell us the site or service, what you did and the message on screen. Our reply comes back in the same ticket, so everything stays in one place.