A project is a logical structure that groups deployments and custom domains inside of an account or team, based on the name of the project. This structure allows easier tracking and managing of deployments.

The projects structure enables faster locating of deployments logs, source code, and custom domains.

Creating a Project

A project can be created either from the ZEIT account or team dashboard, by using Now CLI, or automatically when deploying.

1. From the Dashboard

Simply visit the ZEIT dashboard(optionally selecting a team from the team picker), then click on the "Projects" link in the dashboard navigation.

Then, you can create a project by just giving it a name.

2. With Now CLI

You can create project by just typing the following command:

now projects add <your-project-name>

Creating a project with Now CLI.

Note: You need to download the latest version of Now CLI in order to run the above command.

3. Automatic Project Creation

This is simplest way to create a project as it does not require any action from the user. A project will automatically be created when making a deployment using the defined name.

(To select a project for a deployment, check the following section)

Selecting an Existing Project for a Deployment

When deploying an app, you can select an existing project for it. To do this, either:

1. Select the Project from Now CLI

Use the --name option to mention the project name as follows:

now --name <your-project-name>

Deploying the current directory with Now CLI and --name option.

2. Automatic Project Selection

If you didn't specify a project name explicitly via one of the above methods, we try to select a project automatically based on following rules:

  • If this is GitHub deployment, we use the GitHub repo name as the project
  • If this is a Now CLI based deployment, we use the directory name of your app as the project
  • If this is a file or a set of files, we use the files project

Deleting a Project

You can remove a project and all of the deployments contained within it with the following Now CLI command:

now projects rm <your-project-name>
Note: This will also delete the deployments from the project. 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.