# Manage projects

In Reunite, 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.

### Go live with a draft project

New projects start in draft mode.
While a project stays in draft mode, deployment URLs require login and the production deployment runs in a lower-scale configuration.

To make the project behave like a standard live project, click **Go live** in the editor.
For more information, see [draft projects](/docs/realm/reunite/project/draft-projects).

## 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 workspace pages

Projects have their features grouped into pages you can access in the left panel:

- [Editor](/docs/realm/reunite/project/use-editor): create, manage, and commit content.
- [Pull requests](/docs/realm/reunite/project/pull-request/manage-pull-requests): manage pull requests and view pull request history in the project.
- [Deployments](/docs/realm/reunite/project/deployments) view the history of project deployments and re-deploy the project manually.
- [Remote content](/docs/realm/reunite/project/remote-content) manage files and folders that are pulled into your project from external sources.
- Reports:
  - [Feedback](/docs/realm/reunite/project/feedback): view customer feedback and code reports.
  - [Analytics](/docs/realm/reunite/project/analytics): view data on the page views and search queries for your deployed project.


## 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 Reunite.

### 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

- **[Draft projects](/docs/realm/reunite/project/draft-projects)** - Understand draft mode, protected draft deployments, and what changes when you go live
- **[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
- **[Remote content](/docs/realm/reunite/project/remote-content)** - Integrate and synchronize content from external repositories and sources into your Reunite projects
- **[Roles and permissions](/docs/realm/access/roles)** - Understand user roles and permission levels available for project access control and team collaboration