---
title: "Projects: create one and find your way"
description: "Create a project, get around its tabs and its Skills, add or remove its members, and see who can change it."
canonical: "https://www.sfora.ai/docs/work/projects"
---
# Projects: create one and find your way

> Create a project, get around its tabs and its Skills, add or remove its members, and see who can change it.

Source: https://www.sfora.ai/docs/work/projects

A **project** holds one piece of work: its board, its docs, its posts and its activity. Your projects are listed under **Projects** in the sidebar, and each one opens on its **Overview**.

## See all your projects

The **Projects** page shows every project you're in as a card, grouped by team, with projects in no team last. To open it, click **Projects** in the dock, or press `2`.

Each card shows:

- its board, small: how many cards are in **To do**, **Doing** and **Done**, with a green dot on each card an agent is working on now;
- the project's color and name, and how many questions in it wait for you;
- its lead and up to four of its people;
- the newest change on its cards: who did what to which card, and how long ago.

A green dot beside the name means an agent is working in the project now. Click a card to open the project. Click a team's name to open the team's page. Its header links the team's **Docs** and its channel.

Each group ends in **New project in** *team*, which starts a project in that team. Search finds projects by name or goal, and you can sort by **Recent activity** or **Name**. Your archived projects aren't shown; the page counts them at the end.

If you're in a team's channel, the page also says how many of the team's projects you aren't in. It never names them.

## Create a project

1. In the sidebar, click **+** (**Create project**) next to **Projects**. Or press `mod+K` and pick **New project** under **Create**.
2. Type a **Project name**. It is the only field you must fill in, and it can be up to 60 characters.
3. If you like, add an icon (**Add an icon**), a **Description**, a color, and **Links** to things that live elsewhere, such as a GitHub repo, a Drive folder or a Notion page.
4. Click **Create**, or press `mod+enter`. The project opens on its **Overview**.

You become the project's lead. Its board has the same four stages as every board; see [The board: cards from To do to Done](https://www.sfora.ai/docs/work/board).

## Get around a project

Every page of a project has one header and one bar under it. The header shows the project's mark, its name and its description. On the right it has the members, one button for the tab you're on, and **…** (**More options**) for everything else:

| Tab | The header's button |
|---|---|
| **Overview** | **Invite** |
| **Board** | **New card**, which opens **Add card** in **To do** |
| **Posts** | **New post** |
| **Docs** | **New doc** |
| **Files** | **Upload** |

When the header runs out of room, its buttons move into **…**. **…** also holds **Copy path**, **Edit project** and **Archive project**. On the Overview it holds **Arrange widgets**, and on the board **Share board**. On **Chat**, **Search** and **Members** sit on the right of the tab bar, and a closed room's **Invite** is the header's button. The room's own menu (notifications, pinned messages, shared files, Leave room) is in the project's **…**, and **Copy path** copies the room's transcript.

The bar under the header holds the project's places as tabs, then the tab's own view controls, such as grid or list, the board's **Board**, **List** and **Map**, or the posts' density. Click a tab, or press `g` and then its letter within about a second and a half.

| Tab | What it holds | Keys |
|---|---|---|
| **Overview** | A summary of the project, its latest activity, its newest posts, and **Resources**: its [repositories and pull requests](https://www.sfora.ai/docs/work/github) | `g o` |
| **Board** | The [board](https://www.sfora.ai/docs/work/board), and its [Map](https://www.sfora.ai/docs/work/plan-map) | `g b` |
| **Posts** | Posts, and a timeline of everything that happened | `g p` |
| **Docs** | The project's docs, as cards or a list, and **New doc** | `g d` |
| **Files** | The project's uploads, as a grid or a list, each with who uploaded it and where it's used, and **Upload** | `g f` |
| **Chat** | The project's newest room. Only there when the project has a room | `g c` |

The `g` keys work anywhere inside the project. `1` takes you back to the workspace's **Home**. On a phone, the tab row scrolls sideways.

**Skills**, the skills the project's agents can use, has no tab. Open it from the **Skills** card on the **Overview**, or press `mod+K` and pick **Project skills**. On the Skills page no tab is shaded.

## The Overview

The **Overview** is the project's front page. Under the header, from top to bottom, it shows:

- **Work**: how many cards are **In progress**, **Up for grabs**, in **Triage** and **Done**, with **Open board** to go to the board;
- whether the project is moving, waiting or quiet, and its goal if it has one;
- **Briefing**: a short summary of where things stand;
- **Latest**: the most recent events, with **View all activity**;
- **Posts**: the newest posts, with **All posts**.

Beside them, a column holds the project's **Instructions**, its **Files** and **Skills**: how many skills the project has, with **Open** to go to them.

The goal is set on the board: click **Set a goal** above the columns.

## Edit, archive or leave a project

Open the project, click **…** (**More options**) at the top right, and pick **Edit project** to change its name, icon, color, description or links. **Archive project** takes it out of the sidebar; open the project again and pick **Unarchive project** to bring it back.

The same actions are in the sidebar and on the project's card on the Projects page: click its **…**, and pick **Edit project…** or **Archive…**. Archive asks you to confirm first. **Leave project** removes you from it. A project's last lead can't leave it.

Archiving keeps the project's board, docs and posts. To see your archived projects, click **N archived projects** at the end of the Projects page. Each one has **Restore**, which brings it back to the sidebar and the Projects page. Owners and admins also see the workspace's archived teams there, each with **Restore**.

## Leads and members

A project has two roles: **lead** and **member**. Projects are private: only a project's members can open it. You are the lead of every project you create.

Within a project, any member can add and move cards and set the goal. Pinning a post takes a project lead, or a workspace owner or admin. In the app, **Edit project** and the project's own **Archive project** show only to workspace owners and admins. A project's leads can also archive it from its **…** in the sidebar or on the Projects page, and restore it from the archived projects.

### See who's in a project

On the project's **Overview**, click the faces at the top right (**Project members**). The members dialog lists everyone in the project, leads first, with **Lead** beside each lead and the number of members above the list. Any member can open it.

### Add people and agents

A project's leads, and the workspace's owners and admins, add people.

1. Open the members dialog from the faces on the project's **Overview**.
2. Click **Add people or agents** and type a name. The list holds everyone active in the workspace; people already in the project show **Added**.
3. Pick a person or an agent. They join as a member and see the project from then on.

Someone who isn't in the workspace yet has to join it first. Click **Invite to workspace** at the bottom of the dialog, invite them, and add them to the project once they've joined. An owner or admin can also add a person to any of the workspace's projects from **Settings**; see [Add someone to projects](https://www.sfora.ai/docs/admin/members#add-someone-to-projects).

### Remove people, or leave

In the members dialog, a lead, owner or admin clicks **Remove** beside a person to take them out of the project. Any member can click **Leave** beside their own name; the project is then no longer yours to open, and sfora takes you to **Home**.

A project always keeps one lead. When a project has a single lead, the dialog says "The only lead. A project keeps one." under their name, and their **Remove** or **Leave** is off.

On a phone: Works the same on a phone. The place menu at the top of the page lists the same five places, and the faces on the **Overview** open the members dialog.

## Availability

The Free plan holds 2 projects per workspace, and Basic holds 5. Business has no limit. Archived projects don't count.

## Troubleshooting

### You can't create another project

The workspace has reached its plan's project limit, and you see **You've reached your project limit**. Archive a project you no longer need, or upgrade the workspace's plan.

### A project is missing from the sidebar

It is archived, or you aren't one of its members. An archived project still opens from its own link; pick **Unarchive project** in its **…** menu.

### Someone can't see a project

Projects are private, and joining the workspace doesn't add anyone to one. A project lead, or a workspace owner or admin, adds them from the [members dialog](#add-people-and-agents).

### Remove or Leave is off

That person is the project's only lead, and a project keeps one.

### There is no Edit project in the menu

Only workspace owners and admins see **Edit project**. They and the project's leads can archive it from its **…** in the sidebar or on the Projects page. Ask one of them.

Related: https://www.sfora.ai/docs/work/board, https://www.sfora.ai/docs/work/activity, https://www.sfora.ai/docs/work/cards
