Can I delete the Welcome workspace?

Yes. Right-click the workspace in your sidebar → Archive (or use `DELETE /api/workspaces/welcome`). Archived workspaces don't count toward your plan cap and can be restored from Settings → Archived. There's no special protection on the Welcome workspace; it's a regular workspace owned by you.

What if I sign up but never come back?

The workspace stays. The next time you sign in (any time, any device), magic-link verify lands you back inside the same Welcome workspace at the same URL. No re-seeding, no duplicate, no data loss.

Why does my Welcome show 'Your workspace is ready.' instead of my name?

Your email's local-part didn't read as a clean first name. We treat anything with digits ('user42'), single-character locals ('a'), and locals over 32 chars as throwaway-style handles and fall back to the unnamed greeting. If you signed up with a different email that contains a clean first segment (john@... → John), the personalized H1 will fire.

Can I share the Welcome workspace with my teammates?

Yes. Click Share at the top-right, enter their email, pick a role. They get a magic-link invite and land here as a member. The 20 sample rows + briefing + showcase are visible to everyone you share with, just like any other workspace.

I have an existing Dock account. Do I still get a Welcome workspace?

Only on first signup. If your account has any non-Dock-managed workspaces (the system-kind check looks for `systemKind IS NULL`), `ensureFirstWorkspace` short-circuits and doesn't seed a duplicate. Returning users land on `/workspaces` instead.

Is the Showcase HTML iframe sandboxed?

Yes. The default Showcase ships HTML + CSS only (no JS). When you add a script tag, the surface ships it via the same sandboxed iframe pattern as every other HTML surface in Dock: scripts run in a no-allow-same-origin frame, no cookies, no localStorage from the parent. See the HTML surface guide for the full security model.

Guide

Welcome workspace

Every new Dock signup lands directly in a Welcome workspace. Three surfaces, all editable, all yours. Personalized with your first name. The product’s opening sentence to you, written in cells and paragraphs you can immediately change.

What you land in

After you click the magic link in your sign-in email, Dock seeds a workspace owned by your new org and routes your browser straight to it. The URL is /{your-org-slug}/welcome and the tab strip carries three surfaces:

Tab

Kind

What’s inside

Briefing

Doc

An H1 greeting ("Welcome, {firstName}."), the Dock hero video, a 3-surface comparison table, a strip of 8 agent-ecosystem brand logos, and 3 next-action CTAs. This is the default tab and the first thing you see.

Launch tracker

Table

20 sample launch-plan rows across 11 typed columns. Owner / Status / Stage / Priority chips are brand-colored. Score is a precomputed column you can replace with a real formula once the formula engine ships in your workspace.

Showcase

HTML

A dark, full-bleed branded landing page demonstrating what HTML surfaces can do. Aurora gradient background, Fraunces hero title, stat banner, pattern cards. Edit the HTML and CSS in-place to make it yours.

Why three surfaces

Dock workspaces hold any combination of three surface kinds in any mix: doc, table, and HTML. The Welcome workspace ships one of each so you see all three immediately, not as descriptions in a manual but as content you can change. Edit a row, type into a paragraph, tweak a gradient. Every change persists to every reader (human or agent) on the workspace.

Personalization

The Briefing tab’s H1 reads Welcome, {firstName}. where firstNameis derived from the email you signed up with (and your User.name when it’s set). Examples:

john@colormango.com → Welcome, John.
firstname.lastname@x.com → Welcome, Firstname.
alice_smith@x.com → Welcome, Alice.
xyz123@gmail.com → Your workspace is ready. (numeric local-parts read as handles, not names; we fall back to the unnamed greeting)

The fallback is deliberate. A workspace named “Welcome, xyz123.” reads worse than a clean “Welcome.”

What you can change

Everything. The Welcome workspace is owned by you, not by Dock. Rename it, archive it, restyle the Showcase HTML, delete the sample rows, drop in new surfaces. You can also:

Edit the Briefing doc. The doc body is regular TipTap; the full doc-formats surface (videos, callouts, mermaid, math, cross-refs, embeds) is available.
Edit the Launch tracker columns.Add columns your team needs, change the status options, hide what you don’t want. The 11 columns are a starting point, not a template lock.
Replace the Showcase HTML. The default content is one example of what an HTML surface can be. The same surface ships full HTML + CSS + JS support, sandboxed. See HTML surface guide.
Share it with humans + agents. The workspace is private by default. Invite teammates by email, mint agent keys, change visibility, all from the share modal.

Seeding internals

The workspace is created by ensureFirstWorkspace in src/lib/auth.ts the moment your magic-link verify lands. The seed function runs in a single Prisma transaction so you never see a half-built workspace. Three details worth knowing:

Idempotent slug. If another workspace named Welcome already exists in your default org (rare; would mean you had a half-onboarding earlier), the slug falls through to welcome-1, welcome-2, and so on up to 20, with a random hex suffix after.
Dock-managed seeds don’t count toward your cap. You’re also automatically enrolled as a viewer of Dock guide, the shared library workspace. The plan-cap check ignores any workspace with system_kindset, so your owned Welcome doesn’t consume the Dock-guide slot or vice versa.
Source content lives at src/lib/welcome-seed-content.ts. That file holds the briefing markdown template, the 11-column tracker schema, the 20-row launch-plan template, and the Showcase HTML + CSS. Mirror of what ships at /dock/welcome-preview on prod, which is the design source of truth.

Next steps

Three things to do in your first 60 seconds, in order of compounding return:

Click into a Launch tracker cell. Type something. Press Tab. The change is persisted instantly and visible to every member of the workspace.
Open the Showcase tab.Scroll through the rendered HTML. Click the “HTML” or “CSS” toggle to see the source. Change a color, save, watch the preview update.
Mint an agent key.Settings → API keys → New key. Drop the dk_ secret into any agent runtime and that agent appears in this workspace’s Members list with its own identity. Every row or paragraph it edits is stamped with its name.

Frequently asked questions

Can I delete the Welcome workspace?: Yes. Right-click the workspace in your sidebar → Archive (or use `DELETE /api/workspaces/welcome`). Archived workspaces don't count toward your plan cap and can be restored from Settings → Archived. There's no special protection on the Welcome workspace; it's a regular workspace owned by you. Learn more →
What if I sign up but never come back?: The workspace stays. The next time you sign in (any time, any device), magic-link verify lands you back inside the same Welcome workspace at the same URL. No re-seeding, no duplicate, no data loss.
Why does my Welcome show 'Your workspace is ready.' instead of my name?: Your email's local-part didn't read as a clean first name. We treat anything with digits ('user42'), single-character locals ('a'), and locals over 32 chars as throwaway-style handles and fall back to the unnamed greeting. If you signed up with a different email that contains a clean first segment (john@... → John), the personalized H1 will fire.
Can I share the Welcome workspace with my teammates?: Yes. Click Share at the top-right, enter their email, pick a role. They get a magic-link invite and land here as a member. The 20 sample rows + briefing + showcase are visible to everyone you share with, just like any other workspace. Learn more →
I have an existing Dock account. Do I still get a Welcome workspace?: Only on first signup. If your account has any non-Dock-managed workspaces (the system-kind check looks for `systemKind IS NULL`), `ensureFirstWorkspace` short-circuits and doesn't seed a duplicate. Returning users land on `/workspaces` instead.
Is the Showcase HTML iframe sandboxed?: Yes. The default Showcase ships HTML + CSS only (no JS). When you add a script tag, the surface ships it via the same sandboxed iframe pattern as every other HTML surface in Dock: scripts run in a no-allow-same-origin frame, no cookies, no localStorage from the parent. See the HTML surface guide for the full security model. Learn more →