# Manage projects

In Reunite, [projects](/docs/realm/reunite/project/projects) are the place where you create, test, and deploy documentation websites.

## Create a project

1. In Reunite's top-left corner, click your organization's icon, then on the bottom of the list of projects, click **Create new project**.
2. In the **Create project** modal, select **Choose template** for a template option.
You can preview a template by clicking the eye icon on a template card.
3. Enter the name for your project.
Reunite automatically fills the **Project domain** field and checks if the domain name is already in use.
4. (Optional) Edit the project domain to your preferences.
The **Project domain** must be unique within your organization.
5. Click **Create project**.


Reunite creates your project and takes you to the project's **Editor** page and you can start working on your documentation.
If you have a third-party-hosted Git, [connect your repository](#connect-your-project-repository) first.

## Switch between projects

Reunite enables you to work on multiple projects.
Access to specific projects depends on the [role](/docs/realm/access/roles) you have in your organization and your [team membership](/docs/realm/reunite/organization/teams).

You can switch between projects in a few different contexts:

- **Organizations and projects menu:**
  1. In the top-left corner of Reunite, click your organizations's icon.
  2. From the menu, click one of the project names.
- **Organization Overview page:**
  1. In your organization's **Overview** page find the tile with your project's name.
  2. Click the arrow button.
- **Navigation bar:**
  1. In a project's navigation bar, click the project name.
  2. From the menu, select one of the project names.


## Project Settings menu

Use the Settings menu in your project workspace to edit your projects domain, environment variables, set up Git hosting, manage deployment options, or delete the project.

### View and edit project details

On the **General settings** page you can:

- View and copy the **Project ID**.
- Edit the **Project name**.
- Edit the **Project domain**.


### Delete a project

When a project becomes obsolete, or you have a test project you no longer need, you may want to delete that project.

Deleting a project is permanent - all data on Reunite, including customer feedback, is lost.
Perform this action only if you're certain your organization no longer has use for it.

If you have an external repository connected to Reunite, data on that repository is not affected.

1. In Reunite, switch to the project you want to delete.
2. Select **Settings** > **General** in the menu on the left side of the page.
3. On the **General Settings** page, click **Delete**.
4. Click **Delete** to confirm the action.
5. Enter the project domain; this step ensures that you delete the correct project.
Then click the **Delete** button to confirm deletion.


Reunite deletes the project and returns you to your organization's dashboard.

### Set up a custom domain

To learn how to set up your custom domain and optional proxy, project prefix, or how to serve your project from a subdomain, see [Custom domain](/docs/realm/reunite/project/custom-domain).

### Manage environment variables

To learn how to add and utilize environment variables in your project, see [Environment variables](/docs/realm/reunite/project/env-variables).

### Download your project files

If you use Redocly-hosted Git, you can download your project files at any time.

To download your project files:

1. In your project's workspace, select **Settings** > **Git hosting**.
2. Click the **Download ZIP** button.


The `.zip` file with all files from your project downloads to your machine.

### Connect your project repository

Redocly-hosted Git is available by default for your project.

However, if you already have an existing Git repository, [connect your Git provider](/docs/realm/reunite/project/connect-git/connect-git-provider).
This way you can maintain your files in your own infrastructure and publish your project using Realm.

### Set up deployment strategy

To learn how to change which branches Reunite deploys and how it handles preview deployments, see [Branches and deployments](/docs/realm/reunite/project/branches-and-deployments).

## Resources

- **[Configure RBAC](/docs/realm/config/access/rbac)** - Set up role-based access control for granular project and content access permissions
- **[Connect a Git provider](/docs/realm/reunite/project/connect-git/connect-git-provider)** - Integrate your projects with Git repositories from various providers for version control and collaboration
- **[Roles and permissions](/docs/realm/access/roles)** - Understand user roles and permission levels available for project access control and team collaboration