{"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"manage-projects","__idx":0},"children":["Manage projects"]},{"$$mdtype":"Tag","name":"ConfigOptionRequirements","attributes":{"products":["Redoc","Revel","Reef","Realm"],"plans":["Pro","Enterprise","Enterprise+"]},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In Reunite, projects are the place where you create, test, and deploy documentation websites."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-project","__idx":1},"children":["Create a project"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Reunite's top-left corner, click your organization's icon, then on the bottom of the list of projects, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create new project"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create project"]}," modal, enter the name for your project."," ","Reunite automatically fills the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project domain"]}," field and checks if the domain name is already in use."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(Optional) Edit the project domain to your preferences."," ","The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project domain"]}," must be unique within your organization."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Git repository"]},", select where your project content lives:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redocly-hosted repository"]},": Reunite sets up and hosts the repository for you."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect existing repository"]},": Reunite builds the project from a repository you already have on GitHub, GitLab, Bitbucket, or Azure DevOps."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]}," and complete the steps for the option you selected."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can change the connected Git repository later in the project's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings > Git hosting"]}," page."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-project-from-a-template","__idx":2},"children":["Create a project from a template"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you selected ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redocly-hosted repository"]},", Reunite offers a set of templates as the starting content:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select a template."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create project"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reunite creates your project and takes you to the project's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Editor"]}," page and you can start working on your documentation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-project-from-an-existing-repository","__idx":3},"children":["Create a project from an existing repository"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you selected ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect existing repository"]},", Reunite builds the project from the content that is already in your repository."," ","Nothing is pushed to the repository, and no template is used."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select your Git provider and authorize Reunite to access it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the organization, the repository, and the branch."," ","For a monorepo, you can also select a folder."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create project"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reunite creates your project, builds it from your repository, and takes you to the project's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Editor"]}," page."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"switch-between-projects","__idx":4},"children":["Switch between projects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reunite enables you to work on multiple projects."," ","Access to specific projects depends on the ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/access/roles"},"children":["role"]}," you have in your organization and your ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/organization/teams"},"children":["team membership"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can switch between projects in a few different contexts:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organizations and projects menu:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the top-left corner of Reunite, click your organizations's icon."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["From the menu, click one of the project names."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organization Overview page:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your organization's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Overview"]}," page find the tile with your project's name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the arrow button."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Navigation bar:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In a project's navigation bar, click the project name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["From the menu, select one of the project names."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"project-workspace-pages","__idx":5},"children":["Project workspace pages"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Projects have their features grouped into pages you can access in the left panel:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/project/use-editor"},"children":["Editor"]},": create, manage, and commit content."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/project/pull-request/manage-pull-requests"},"children":["Pull requests"]},": manage pull requests and view pull request history in the project."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/project/deployments"},"children":["Deployments"]}," view the history of project deployments and re-deploy the project manually."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/project/remote-content"},"children":["Remote content"]}," manage files and folders that are pulled into your project from external sources."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reports:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/project/feedback"},"children":["Feedback"]},": view customer feedback and code reports."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/project/analytics"},"children":["Analytics"]},": view data on the page views and search queries for your deployed project."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"project-settings-menu","__idx":6},"children":["Project Settings menu"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the Settings menu in your project workspace to edit your project's domain and environment variables."," ","You can also set up Git hosting, manage deployment options, or delete the project."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"view-and-edit-project-details","__idx":7},"children":["View and edit project details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["General settings"]}," page you can:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["View and copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project ID"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Edit the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project name"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Edit the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project domain"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"delete-a-project","__idx":8},"children":["Delete a project"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a project becomes obsolete, or you have a test project you no longer need, you may want to delete that project."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"danger","name":"Irreversible action"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you have an external repository connected to Reunite, data on that repository is not affected."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Reunite, switch to the project you want to delete."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["General"]}," in the menu on the left side of the page."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["General Settings"]}," page, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete"]}," to confirm the action."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the project domain; this step ensures that you delete the correct project."," ","Then click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delete"]}," button to confirm deletion."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reunite deletes the project and returns you to your organization's dashboard."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"set-up-a-custom-domain","__idx":9},"children":["Set up a custom domain"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/project/custom-domain"},"children":["Custom domain"]}," to learn how to set up your custom domain and optional proxy or project prefix."," ","It also covers how to serve your project from a subdomain."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"manage-environment-variables","__idx":10},"children":["Manage environment variables"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To learn how to add and utilize environment variables in your project, see ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/project/env-variables"},"children":["Use environment variables"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"download-your-project-files","__idx":11},"children":["Download your project files"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you use Redocly-hosted Git, you can download your project files at any time."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To download your project files:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your project's workspace, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Git hosting"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(Optional) Select a branch in the branch selector next to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Download ZIP"]}," button."," ","The default branch is selected initially; type a branch name to filter the list."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Download ZIP"]}," button."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".zip"]}," file with all files from the selected branch downloads to your machine."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-your-project-repository","__idx":12},"children":["Connect your project repository"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Redocly-hosted Git is available by default for your project."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["However, if you already have an existing Git repository, ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/project/connect-git/connect-git-provider"},"children":["connect your Git provider"]},"."," ","This way you can maintain your files in your own infrastructure and publish your project using Reunite."," ","You can connect a repository when you ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"#create-a-project-from-an-existing-repository"},"children":["create a project"]},", or at any time later in the project's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings > Git hosting"]}," page."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"set-up-deployment-strategy","__idx":13},"children":["Set up deployment strategy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To learn how to change which branches Reunite deploys and how it handles preview deployments, see ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/project/branches-and-deployments"},"children":["Branches and deployments"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resources","__idx":14},"children":["Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/config/access/rbac"},"children":["Configure RBAC"]}]}," - Set up role-based access control for granular project and content access permissions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/project/connect-git/connect-git-provider"},"children":["Connect a Git provider"]}]}," - Integrate your projects with Git repositories from various providers for version control and collaboration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/reunite/project/remote-content"},"children":["Add remote files with one-way sync"]}]}," - Integrate and synchronize content from external repositories and sources into your Reunite projects"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/access/roles"},"children":["Roles and permissions"]}]}," - Understand user roles and permission levels available for project access control and team collaboration"]}]}]},"frontmatter":{"products":["Redoc","Revel","Reef","Realm"],"plans":["Pro","Enterprise","Enterprise+"]},"tagList":["admonition","configOptionRequirements"],"title":"Manage projects","lastModified":"2026-10-01T23:00:57.000Z"}