To deploy on ZEIT Now, you need to create a Project. A Project is a logical structure that groups deployments and custom domains. Each project can be associated to a GitHub, GitLab, or Bitbucket repository.

Creating a Project

You can create a new project from the ZEIT Dashboard by clicking on the New Project button.

Creating a new project from the ZEIT Dashboard.

You can either import from an existing Git repository or use one of our templates.

Project Settings

To edit project settings, choose a project from the dashboard:

Selecting the project from the ZEIT Dashboard.

Then, select the Settings tab:

Selecting the Settings tab from the Project Overview page.

Build & Development Settings and Root Directory

You can edit build and development settings as well as the root directory settings. Check out our Build Step documentation to learm more.

Logs and Source Access

If you turn on Logs and Source Access, the following paths for your project will be publicly accessible. Even if this setting is disabled, you can still access these paths by logging in.

  • /_src: Displays the source code and build output.
  • /_logs: Displays the build logs.
Warning: Do not edit this setting if you don’t want your source code or logs to be publicly accessible.

Ony applied starting from your next deployment

As with other project settings, the changes you make to this setting will only be applied starting from your next deployment.

Note: When you toggle this setting, none of your existing deployments will be affected. If you’d like to make the source code or logs private on your existing deployments, the only option is to delete them.

Custom Domains

You can add custom domains for each project. Check out our Custom Domains documentation to learn more.

Git Integration

To edit your project’s Git Integration settings, select the Git Integration menu item from your project settings page.

Selecting the Git Integration menu item from the project settings page.

If you haven’t set up your Git Integration for GitHub, GitLab, or Bitbucket yet, you can do so from here.

Setting up the Git Integration.

If you have already set up your Git Integration, you can specify which Git repository to connect your project to by entering the repository name.

Specify the Git repository for your project.

If you’d like to disconnect your project from a Git repository, empty the field and save it.

Disconnect Your Personal Account or Team

If you’d like to disconnect your personal account or team from GitHub, GitLab, or Bitbucket, follow the directions here:

Deploy Hooks

ZEIT Now supports deploy hooks, which are unique URLs that accept HTTP POST requests and trigger deployments. Check out our Deploy Hooks documentation to learn more.

Deleting a Project

Warning: Deleting your project will also delete the deployments and domains within it. If you have any deployments that are assigned to a custom domain and do not want them to be removed, make sure to deploy and assign them to the custom domain under a different project first.

To delete a project, choose a project from the dashboard:

Selecting the project from the ZEIT Dashboard.

Then, select the Settings tab:

Selecting the Settings tab from the Project Overview page.

Next, select Advanced from the menu.

Selecting the Advanced menu item from the Project Settings page.

You’ll see the Delete Project section. Confirm that you'd like to delete the project and click the Delete button.

The Delete Project section.