First Run

A four-step setup for a brand-new AI workspace, with a springy stepper, tools that connect right where they sit, invites as chips, a live preview of your first agent and a calm summary you can jump back from.

akaonboarding·setup

Install

Run this in any project set up for the shadcn CLI. It copies the First Run source into your components folder, so the code is yours to change.

npx shadcn@latest add https://devl.dev/r/first-run.json

Use it

Import it and render it. Every prop has a typed default, so it works straight away, and you pass your own data when you’re ready.

import { FirstRun } from "@/components/first-run";

export default function Page() {
  return <FirstRun />;
}

Built with

A free React screen in the Product collection, written in TypeScript with Tailwind CSS on coss ui. MIT licensed.

coss ui: avatar, badge, button, input, popover, select, spinner, textarea
npm: lucide-react, motion

Props

Read from the First Run source. Everything is optional unless it says required.

Prop	Type	Default
productName	string	"Hearth"
domain	string	"hearth.app"
defaultWorkspaceName	string	"Northwind Labs"
useCases	string[]	defaultUseCases
tools	FirstRunTool[]	defaultTools
templates	AgentTemplate[]	defaultTemplates
inviteSuggestions	string[]	defaultSuggestions
takenSlugs	string[]	defaultTakenSlugs
walkthroughSlots	string[]	defaultSlots
connectDelay	number	1000
onFinish	(summary: { workspace: string; tools: string[]; invites: number; agent: string }) => void	—
className	string	—

More in Product

185

Co-writing Doc

A document where AI agents write alongside you: coloured cursors with name tags glide between words, an agent types its suggestion letter by letter for you to accept or reject, and comments sit in the margin next to the lines they're about.

186

Revenue Story

A store's revenue told as a story: one big annotated line you can scrub day by day against last period, a plain-sentence summary whose numbers roll, a range switch that morphs the line and moves its notes, and a ranked strip of where the money came from.

187

Pipeline Today

A salesperson's morning view: drag deals between stages (or move them with the keyboard) while each column's weighted value and the forecast roll live, and a Focus rail tells you who to act on and why, with one-click email, call and snooze that update the deal.

188

Drive

A cloud drive home with a sidebar of places and quick access, start-from-template cards, and folders that glide between a card grid and a tidy table when you switch views, with search, sort and stars.

Prop

Type

Default

productName

string

"Hearth"

domain

string

"hearth.app"

defaultWorkspaceName

string

"Northwind Labs"

useCases

string[]

defaultUseCases

tools

FirstRunTool[]

defaultTools

templates

AgentTemplate[]

defaultTemplates

inviteSuggestions

string[]

defaultSuggestions

takenSlugs

string[]

defaultTakenSlugs

walkthroughSlots

string[]

defaultSlots

connectDelay

number

1000

onFinish

(summary: { workspace: string; tools: string[]; invites: number; agent: string }) => void

—

className

string

—