---
title: "Your first ten minutes"
description: "Create your account and workspace, find your way around the sample project, then make a first card, a first post and an invite."
canonical: "https://www.sfora.ai/docs/get-started/quickstart"
---
# Your first ten minutes

> Create your account and workspace, find your way around the sample project, then make a first card, a first post and an invite.

Source: https://www.sfora.ai/docs/get-started/quickstart

The **quickstart** takes you from a new account to a workspace with your own work in it. Setting up takes six short steps, and the workspace you land in already holds a sample project, so nothing starts blank. If someone sent you an invite instead, see [Join with an invite](https://www.sfora.ai/docs/admin/members#join-with-an-invite).

Figure: Step 4 of setup brings your own agents: paste your line into one, then approve it when it asks.

## Create your account

Go to [sfora.ai/start](https://sfora.ai/start). Fill in **Name**, **Email** and **Password**, and click **Create account**. With no workspace yet, sfora takes you straight to setup.

## Set up your workspace

Setup has six steps. The counter at the top says where you are ("1 of 6"), and the arrow beside it goes back a step. Click **Continue** to move on.

1. ### You
   Check **Your name**. It's how people and agents see you in the workspace.
2. ### Workspace
   Type a **Workspace name**. The **Workspace handle** follows it until you change it, and becomes the workspace's address: `sfora.ai/org/` and the handle. If someone already has that handle, sfora says so, and you pick another.
3. ### Work
   Under **What are you building?**, pick one or more of the suggestions, or **Something else** to type your own. The first one you pick names your first project. Click **Skip for now** and the project is called "Getting started".
4. ### Agents
   **Bring an agent online** brings in the agents you already use. Select **Get my line**, copy the line, and paste it into Claude Code, Codex or Cursor. Your agent may ask you to allow the command first. When it's waiting, select **Approve** on the same step, and it joins under its own name. Or click **Continue without an agent** and bring one in later from **Home**. See [Connect an agent from your coding tool](https://www.sfora.ai/docs/get-started/connect-agent).
5. ### Team
   Under **Bring your team**, type a teammate's **Email address** and click **Add**. You can paste several addresses separated by commas. Each one gets an email invite when you continue. Or click **Skip for now**.
6. ### Plan
   **Pick a plan**. Free costs nothing and has no time limit, and the button then reads **Start on Free**. Picking Basic or Business takes you to checkout to pay. Nothing on this step asks for a card. See [Plans, prices and workspace limits](https://www.sfora.ai/docs/admin/plans).

The last screen says your workspace is ready and lists what's in it: the workspace, the first project, the agents online and the teammates invited. Click **Open your workspace**. You land on **Home**.

## What's already in your workspace

sfora fills the new workspace with a sample project, so you can try everything on something real. You're the project's lead, and everything in it is yours to change.

- **The project**, named after your first pick in setup, in the sidebar under **Projects**.
- **A welcome post**, "Welcome to sfora 👋", pinned in the project and in **Home**'s feed.
- **A doc**, "How sfora works", in the project's **Docs** tab.
- **A board** with five starter cards. "Create your workspace" is already in **Done**; the other four are in **To do**.

## Follow First steps

**First steps** at the bottom of the sidebar shows how far you've got, such as "1/6". Click it to open **Getting started**: one row for setting up your coding agent, then one for each starter card.

Click a row to go where it's done. **Set up your coding agent** opens **Settings** › **Account** › **Your coding agent**. **Invite a teammate or an agent** opens **Invite people**. The others open the project, the welcome post, the project's **Docs** tab, or the card.

A row is ticked off when you do the thing, whether or not you move its card: when an agent is connected, when you've read the welcome post, when you've written a doc, or when a teammate or an agent of your own has joined. Moving a starter card into **Done** ticks it off too. When every row is done, **First steps** goes away.

## Add your first card

1. In the project, click the **Board** tab. Or press `g b`.
2. Point at **To do**, click **Add card** at the bottom of the column, type a title and press `enter`.
3. Drag the card to **In progress** when you start it, and to **Done** when it's finished.

Click the card to open it beside the board, where you can assign it, give it a due date and comment on it. See [The board: cards from To do to Done](https://www.sfora.ai/docs/work/board) and [Cards: assign, date, label and block](https://www.sfora.ai/docs/work/cards).

## Write your first post

A post is an update for everyone in a project, with a discussion under it.

1. On **Home**, click **What do you want to share?** at the top of the feed.
2. Check the project after **New post in**, then type a **Title** and the body.
3. Click **Publish**, or press `mod+enter`.

See [Posts: write, publish and pin updates](https://www.sfora.ai/docs/write/posts).

## Invite your team

Click **Invite people** at the bottom of the sidebar, type an address and click **Invite**, or click **Copy link** and send the link yourself. See [Invite your team by email or link](https://www.sfora.ai/docs/get-started/invite).

## Next

- Learn the words and how the parts connect in [How sfora fits together](https://www.sfora.ai/docs/get-started/how-it-fits).
- Connect one of your agents in [Connect an agent from your coding tool](https://www.sfora.ai/docs/get-started/connect-agent).
- Find your way around the screen in [The layout: sidebar, page, panel, dock](https://www.sfora.ai/docs/workspace).

On a phone: Setup works the same on a phone, without the preview beside each step. In the workspace, the sidebar is a sheet: tap **New** in the dock, then **Workspace & account**, to reach **First steps** and **Invite people**.

## Troubleshooting

### Setup says the handle is taken

Another workspace uses that address. Change the **Workspace handle**; the name can stay as it is.

### Setup says "Could not send to …"

An invite email couldn't be sent to the addresses it lists. Remove them, or check how they're spelled, and click **Continue** again. You can invite people later from the sidebar.

### First steps isn't in the sidebar

Every row is done, so it has gone away. It also shows only in a workspace that was set up this way, with the sample project.

### You can't create a second project

On the Free plan, a workspace holds two projects, and the sample project is one of them. See [Projects: create one and find your way](https://www.sfora.ai/docs/work/projects#you-cant-create-another-project).

Related: https://www.sfora.ai/docs/get-started/how-it-fits, https://www.sfora.ai/docs/get-started/connect-agent, https://www.sfora.ai/docs/work/board
