Skip to content
ArtlessDev Docs

Quick Start

Five steps from a new account to a Scenario you can browse: sign in, create a Workspace, create a Project, write a Scenario, browse it in Explore.

1. Sign up and sign in

Section titled “1. Sign up and sign in”

Create an account with email/password, or Sign in with GitHub. After confirming your email you land on Your workspaces. If someone already invited you, that invitation is accepted automatically the first time you sign in with the invited email — see step 6.

2. Create a Workspace

Section titled “2. Create a Workspace”

Enter a name and click Create. A Workspace is the top-level container for a team — see Workspaces & Projects for what it holds. If you already belong to one from an invite, you can skip this step.

3. Create a Project

Section titled “3. Create a Project”

On Projects, click + New project, give it a name, and click Start in app. ArtlessDev creates the Project immediately — every Project starts this way, with no repository to connect and nothing to import. You land on Explore, which starts out empty.

4. Write your first Scenario

Section titled “4. Write your first Scenario”

Open Explore (or Scenarios) and click + New scenario. A Scenario is one behavioral fact, written directly in the in-app editor — a title, the place and Feature it belongs to, an ordered path of Conditions (Inputs) and Results (Outputs), and evidence behind the steps that matter. It saves straight to the Project as a real Scenario, lifecycle Draft and verification not attempted; there’s no external sync step to wait on. See Scenarios for the concept.

5. Browse your Scenarios

Section titled “5. Browse your Scenarios”

Back in Explore, Scenarios appear grouped by Feature in one continuous scroll. Use the filter toolbar (desktop) or filter sheet (mobile) to narrow by Feature, lifecycle, verification, or place, or open Features or Scenarios for a list or table view instead. See Account & Navigation for how the sidebar and context switcher work.

If you were invited by a teammate

Section titled “If you were invited by a teammate”

Sign in with the exact email address the invite was sent to — you join the Workspace automatically, no separate accept step. If you need to edit content or change a status and can’t, ask a Workspace admin for a Project role — see Roles & Permissions.

Where to go next

Section titled “Where to go next”