Use the deploy button to create a ZEIT Project from any GitHub repository or GitLab project, including branches and subdirectories, and optionally create a copy of the original repository in your Git account.

Example

The example below shows how the deploy button looks when rendered, clicking it allows you to deploy the Gatsby example from the Now Examples repository.

Usage

Consisting of an .svg asset and an associated link to a public GitHub repository or GitLab project, the deploy button can be used wherever its rendering is supported.

When implementing the deploy button, provide a link with it to the /new/project endpoint and pass a GitHub repository or GitLab project as the template query parameter like so:

https://zeit.co/new/project?template=https://github.com/zeit/now-examples/tree/master/gatsby

The URL for deploying GitHub repositories to ZEIT Now.

The template parameter can be either a repository URL, or alternatively, a URL for a folder within that repository, both are supported.

By combining both the button and the /new/project endpoint, you can provide users with a way to deploy projects in seconds. Some common use cases are listed below.

Markdown

To render the deploy button in a Markdown file, for example a Git README.md, use the following code, changing only the template parameter:

[![Deploy with ZEIT Now](https://zeit.co/button)](https://zeit.co/new/project?template=https://github.com/zeit/now-examples/tree/master/gatsby)

The code required to add a deploy button in Markdown.

HTML

To use the Deploy to Now button with HTML, add the button as an image and wrap it with a link to the endpoint, changing only the template parameter:

<a
  href="https://zeit.co/new/project?template=https://github.com/zeit/now-examples/tree/master/gatsby"
>
  <img src="https://zeit.co/button" alt="Deploy to ZEIT Now" />
</a>

The code required to add a deploy button to a website or app.