# Set up a workspace and projects

A **workspace** is your team: its members, roles, notification channels and audit log. A **project** inside it is one product you ship, such as your mobile app, with its apps and repositories. Most teams have one workspace and a project per product.

## 1. Create an account

On the sign-up page, enter your name, email and a password of at least 8 characters, and choose **Create account**. If you already have an account, choose **Have an account? Sign in**.

![The sign-up form: name, email, password and Create account](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/138e3e07-2c34-40f9-ae55-8041f4c9eda5/sign-up.png)

## 2. Create a workspace

A new account has no workspace, so Mocco asks you to create your first one. Give it a name, usually your company or team, and choose **Create workspace**. You become its owner, and Mocco opens its **Home**: the approvals waiting for your team in every product (a deploy paused at a gate, a flag change in a protected environment, a raised minimum app version, a release on a protected OTA channel), the latest entries of the audit log, and your projects. Each waiting approval names its project and what in it the approval is about: the environment of a flag change, the OTA channel, or the app of a minimum version ("QA App · Production"). It links to the screen where you approve it.

![Home: a channel rule change and a flag change waiting for approval, the latest audit entries, and the projects](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/fc4d0dc1-12b1-43d8-ba3c-d3e363166463/home.png)

![Create a workspace: the workspace name and Create workspace](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/39805d7c-5283-476c-8a7a-f3217def0c29/create-workspace.png)

You can belong to several workspaces. To create another one or switch between them, open the workspace menu next to the Mocco logo in the top bar and choose **New workspace** or the workspace you want. The workspace's **Settings** page renames it, and an owner can delete it there.

## 3. Create a project

Open **Projects** in the workspace's side nav. Enter the project's **Name** and choose **Create project**. Mocco suggests a **Handle** from the name (`Acme Mobile` becomes `acme-mobile`); you can change it before you create the project. A handle is lowercase letters, digits and inner hyphens, up to 40 characters, and is unique in the workspace.

![The Projects page: the new-project form and the active projects](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/56371005-966d-4d9a-be11-98210beb0fb1/projects.png)

Mocco opens the new project. The project menu in the top bar switches between projects, and **All projects** goes back to the list.

A project you no longer work on can be archived from the bottom of its **Overview** page with **Archive**. An archived project is read-only and hidden from the list; nothing is deleted. **Show archived** on the Projects page lists it again, and **Unarchive** on its Overview brings it back.

## 4. Register your apps

On the project's **Overview** page, choose **Add app** under **Apps**. Add one app per build target, choose its **Platform** and give it a **Name**:

- **iOS**: the **Bundle ID**, and the numeric **App Store ID** if the app is in the App Store.
- **Android**: the **Application ID**, and the **Play package** if it differs from the application ID.
- **Web**: the **Web origins**, the sites whose pages may use the project's publishable keys, such as `https://app.acme.com`. Separate several with spaces or commas. You can change them later with **Edit origins**.
- **React Native** and **Server**: only a name.

Then choose **Add app**.

![Adding an iOS app on the project Overview page](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/6dcec2f0-21f5-44f8-8d21-8073c3e9f863/add-app.png)

Store apps (iOS and Android) are what force update works on. A web app's origins decide where a publishable key may be used from a browser; see [API keys](https://www.mocco.club/docs/en/articles/avn27u-api-keys).

## 5. Link repositories

Under **Repositories** on the same page, choose a repository and **Link** to say which repos this project ships from. A repository appears here once GitHub is connected and the repository is added on the workspace's **Deploys** page; see [Deploy governance](https://www.mocco.club/docs/en/articles/f48fys-overview#connect-github). A repository can be linked to more than one project, and **Unlink** removes it.

## 6. Turn on products

Open **Products** in the workspace's side nav and choose **Turn on** next to each product you want. Its pages appear in every project's side nav right away: **Force update** and **OTA updates** for OTA and force update and **Feature flags** under **Release**, and **Inbox** for Messenger and **Help center** under **Support**. **Turn off** hides them again.

![The Products page](https://fi-workers-mocco-storage.s3.ap-northeast-2.amazonaws.com/pub/w/93e11fe8-0494-4e3d-b1cb-fe4dffd3ee7e/p/d64785b8-9a23-4fa1-a81d-550af30e203a/helpcenter/d13baefb-e6a4-41ae-9b79-f336748e941d/products.png)

Deploy governance is always on. Products marked **Coming soon** aren't available yet.

## Next

- [Members and access](https://www.mocco.club/docs/en/articles/pns8fb-members-and-access): who is in the workspace and who may approve.
- [API keys](https://www.mocco.club/docs/en/articles/avn27u-api-keys): connect your apps and servers.
- The guide for each product: [OTA and force update](https://www.mocco.club/docs/en/articles/x62axp-overview), [feature flags](https://www.mocco.club/docs/en/articles/f3cruw-quickstart), [messenger](https://www.mocco.club/docs/en/articles/ky2kfv-contact-us), [status page](https://www.mocco.club/docs/en/articles/dn83zy-status-page), [notifications](https://www.mocco.club/docs/en/articles/f56ie6-overview).