Workspace
A dockable workspace: tabbed panels split any way, dragged anywhere, floated into windows, maximized, and remembered — and nothing inside them ever remounts.
Walkthrough
1. Basic
Panels in tabbed groups, split any way. Drag a tab onto another group's edge to split it, onto its strip to join it, or to the workspace's own edge to dock along it. Drag a divider to resize. storageKey brings the arrangement back after a reload.
<script lang="ts"> import { Workspace, WorkspacePanel, row, column, tabs, Text } from 'omaris'; import Icon from '$lib/patterns/shell/icon.svelte'; const FILES = ['+page.svelte', '+layout.svelte', 'api.ts', 'app.css', 'README.md']; const PAGE = '<h1>Hello</h1>\n<p>Drag my tab somewhere.</p>'; const API = 'export const load = () => ({ ok: true });'; const LOG = '$ bun dev\n ready in 212 ms';</script>{#snippet folder()}<Icon name="folder" />{/snippet}{#snippet code()}<Icon name="code" />{/snippet}{#snippet terminal()}<Icon name="terminal" />{/snippet}{#snippet eye()}<Icon name="eye" />{/snippet}<div class="h-[30rem] w-full"> <Workspace storageKey="docs-workspace-basic" defaultLayout={row( 'files', column(tabs('page', 'api'), 'terminal', { sizes: [65, 35] }), 'preview', { sizes: [22, 48, 30] } )} > <WorkspacePanel id="files" title="Files" icon={folder}> <ul class="flex flex-col p-2"> {#each FILES as file (file)} <li class="flex h-9 items-center rounded-shape-sm px-3"> <Text variant="body-md">{file}</Text> </li> {/each} </ul> </WorkspacePanel> <WorkspacePanel id="page" title="+page.svelte" icon={code}> <pre dir="ltr" class="p-4 font-mono text-body-sm leading-6">{PAGE}</pre> </WorkspacePanel> <WorkspacePanel id="api" title="api.ts" icon={code}> <pre dir="ltr" class="p-4 font-mono text-body-sm leading-6">{API}</pre> </WorkspacePanel> <WorkspacePanel id="terminal" title="Terminal" icon={terminal}> <pre dir="ltr" class="p-3 font-mono text-body-sm leading-6 text-muted-foreground">{LOG}</pre> </WorkspacePanel> <WorkspacePanel id="preview" title="Preview" icon={eye}> <div class="grid h-full place-items-center p-6 text-center"> <div class="flex flex-col gap-1"> <Text variant="headline-sm">Hello</Text> <Text variant="body-md" tone="muted">Drag my tab somewhere.</Text> </div> </div> </WorkspacePanel> </Workspace></div> 2. Dashboard
A dashboard people arrange for themselves. bind:open on each panel drives the checkboxes in the menu; a panel switched off remembers where it was and comes back there. bind:this gives the reset.
<script lang="ts"> import { Workspace, WorkspacePanel, StatCard, Button, Menu, MenuItem, Text, row, column } from 'omaris'; let workspace = $state<Workspace>(); const panels = $state([ { id: 'revenue', title: 'Revenue', open: true }, { id: 'orders', title: 'Orders', open: true }, { id: 'visitors', title: 'Visitors', open: true }, { id: 'activity', title: 'Activity', open: true } ]); /** The panel is the card already; the stat inside it needs no second one. */ const bare = 'h-full rounded-none border-0 bg-transparent shadow-none'; const ACTIVITY = [ 'Order #1043 paid', 'New customer: Lina', 'Refund issued for #1031', 'Order #1042 shipped', 'Stock low: Linen shirt' ];</script><div class="flex w-full flex-col gap-3 p-3"> <div class="flex flex-wrap items-center gap-2"> <Menu closeOnSelect={false} label="Panels"> {#snippet trigger(props)} <Button variant="tonal" size="sm" {...props}>Panels</Button> {/snippet} {#each panels as panel (panel.id)} <MenuItem selected={panel.open} onclick={() => (panel.open = !panel.open)}> {panel.title} </MenuItem> {/each} </Menu> <Button variant="text" size="sm" onclick={() => workspace?.reset()}>Reset layout</Button> </div> <div class="h-[28rem]"> <Workspace bind:this={workspace} defaultLayout={column(row('revenue', 'orders', 'visitors'), 'activity', { sizes: [42, 58] })} > <WorkspacePanel id="revenue" title="Revenue" bind:open={panels[0].open}> <StatCard class={bare} label="This week" value={48210} format={{ style: 'currency', currency: 'USD', maximumFractionDigits: 0 }} delta={0.124} /> </WorkspacePanel> <WorkspacePanel id="orders" title="Orders" bind:open={panels[1].open}> <StatCard class={bare} label="This week" value={1284} delta={0.061} /> </WorkspacePanel> <WorkspacePanel id="visitors" title="Visitors" bind:open={panels[2].open}> <StatCard class={bare} label="This week" value={9312} delta={-0.032} /> </WorkspacePanel> <WorkspacePanel id="activity" title="Activity" bind:open={panels[3].open} badge={ACTIVITY.length} > <ul class="flex flex-col divide-y divide-border"> {#each ACTIVITY as line (line)} <li class="px-4 py-3"><Text variant="body-md">{line}</Text></li> {/each} </ul> </WorkspacePanel> </Workspace> </div></div> 3. Floating and maximize
A panel can leave the tree for a floating window: drag it by its strip, size it from its edges, and carry it to the workspace's edge — or double-click its strip — to dock it again. Hold Shift while dropping a tab to float it; double-click a docked strip, or its maximize button, to fill the workspace, and Escape to come back.
<script lang="ts"> import { Workspace, WorkspacePanel, Button, Text, row, tabs } from 'omaris'; let workspace = $state<Workspace>();</script><div class="flex w-full flex-col gap-3 p-3"> <div class="flex flex-wrap gap-2"> <Button variant="tonal" size="sm" onclick={() => workspace?.float('layers')} >Float layers</Button > <Button variant="tonal" size="sm" onclick={() => workspace?.maximize('canvas')}> Maximize canvas </Button> </div> <div class="h-[28rem]"> <Workspace bind:this={workspace} defaultLayout={{ root: row('canvas', tabs('layers', 'history'), { sizes: [70, 30] }), floating: [{ group: tabs('color'), x: 40, y: 72, width: 240, height: 200 }] }} > <WorkspacePanel id="canvas" title="Canvas"> <div class="grid h-full place-items-center bg-surface-container-lowest"> <div class="size-32 rounded-shape-xl bg-primary-container"></div> </div> </WorkspacePanel> <WorkspacePanel id="layers" title="Layers" class="p-3"> <Text variant="body-md">Background</Text> <Text variant="body-md">Shape</Text> </WorkspacePanel> <WorkspacePanel id="history" title="History" class="p-3"> <Text variant="body-md" tone="muted">Nothing to undo.</Text> </WorkspacePanel> <WorkspacePanel id="color" title="Color" class="p-3"> <div class="grid grid-cols-4 gap-2"> {#each ['bg-primary', 'bg-secondary', 'bg-tertiary', 'bg-destructive'] as swatch (swatch)} <div class="aspect-square rounded-shape-sm {swatch}"></div> {/each} </div> </WorkspacePanel> </Workspace> </div></div> 4. Documents
Panels from data: every document is a WorkspacePanel in an {#each}, opened next to the others the moment it exists. An edited one shows the unsaved dot on its tab, and onclose returning false keeps it open until it is saved.
<script lang="ts"> import { Workspace, WorkspacePanel, Button, Textarea, row, tabs } from 'omaris'; type Doc = { id: string; name: string; text: string; saved: string }; let docs = $state<Doc[]>([ { id: 'readme', name: 'README.md', text: '# Hello', saved: '# Hello' }, { id: 'todo', name: 'TODO.md', text: '- Ship it', saved: '- Ship it' } ]); let next = 1; function create() { const n = next++; docs.push({ id: `untitled-${n}`, name: `Untitled ${n}.md`, text: '', saved: '' }); }</script><div class="flex w-full flex-col gap-3 p-3"> <div><Button variant="tonal" size="sm" onclick={create}>New document</Button></div> <div class="h-[26rem]"> <Workspace defaultLayout={row(tabs('readme', 'todo'))}> {#each docs as doc (doc.id)} <WorkspacePanel id={doc.id} title={doc.name} open placement={{ with: 'readme' }} modified={doc.text !== doc.saved} onclose={() => doc.text === doc.saved} class="flex flex-col gap-2 p-3" > <Textarea label={doc.name} bind:value={doc.text} rows={8} /> <div class="mt-auto flex justify-end"> <Button size="sm" disabled={doc.text === doc.saved} onclick={() => (doc.saved = doc.text)} > Save </Button> </div> </WorkspacePanel> {/each} </Workspace> </div></div> 5. Flush
variant="flush": edge to edge with hairlines between, the density of an IDE. Everything else — the dragging, the docking, the keyboard — is the same.
<script lang="ts"> import { Workspace, WorkspacePanel, Text, row, column } from 'omaris';</script><div class="h-96 w-full"> <Workspace variant="flush" defaultLayout={row('outline', column('source', 'problems', { sizes: [70, 30] }), { sizes: [25, 75] })} > <WorkspacePanel id="outline" title="Outline" class="p-3"> <Text variant="body-md">load()</Text> <Text variant="body-md">actions</Text> </WorkspacePanel> <WorkspacePanel id="source" title="+page.server.ts"> <pre dir="ltr" class="p-4 font-mono text-body-sm leading-6">{'export async function load() {\n return { items: await db.items() };\n}'}</pre> </WorkspacePanel> <WorkspacePanel id="problems" title="Problems" badge={0} class="p-3"> <Text variant="body-md" tone="muted">No problems.</Text> </WorkspacePanel> </Workspace></div> 6. Tab styles
tabStyle picks the tabs' look: pill, the default; chrome, a browser's, the front tab joined to its card by curved feet; underline, a line that grows under the front tab; filled, dense rectangles.
<script lang="ts"> import { Workspace, WorkspacePanel, SegmentedButton, Text, row, tabs, type WorkspaceTabStyle } from 'omaris'; const STYLES: WorkspaceTabStyle[] = ['pill', 'chrome', 'underline', 'filled']; let tabStyle = $state<WorkspaceTabStyle>('chrome');</script><div class="flex h-[26rem] w-full flex-col gap-3 p-3"> <SegmentedButton label="Tab style" size="sm" mandatory bind:value={() => tabStyle, (next) => (tabStyle = (next ?? 'pill') as WorkspaceTabStyle)} items={STYLES.map((style) => ({ value: style, label: style }))} /> <div class="min-h-0 flex-1"> <Workspace {tabStyle} defaultLayout={row(tabs('overview', 'orders', 'customers'), 'notes', { sizes: [65, 35] })} > <WorkspacePanel id="overview" title="Overview" class="p-4"> <Text variant="body-md">Sales are up 12% on last week.</Text> </WorkspacePanel> <WorkspacePanel id="orders" title="Orders" badge={4} class="p-4"> <Text variant="body-md">Four orders wait to ship.</Text> </WorkspacePanel> <WorkspacePanel id="customers" title="Customers" class="p-4"> <Text variant="body-md">Two new customers today.</Text> </WorkspacePanel> <WorkspacePanel id="notes" title="Notes" modified class="p-4"> <Text variant="body-md">Call the supplier about linen.</Text> </WorkspacePanel> </Workspace> </div></div> 7. Auto hide tabs
autoHideTabs gives each group's whole card to its content. Point at a group's top edge — or tap the handle there — and its tabs slide back into place, easing the content down to make room; move away and they go. Tab from the page lands on them too. With storageKey, the arrangement you leave is the one you come back to.
<script lang="ts"> import { Workspace, WorkspacePanel, StatCard, Text, row, column, tabs } from 'omaris'; /** The panel is the card already; the stat inside it needs no second one. */ const bare = 'h-full rounded-none border-0 bg-transparent shadow-none'; const ACTIVITY = [ 'Order #1043 paid', 'New customer: Lina', 'Refund issued for #1031', 'Order #1042 shipped', 'Stock low: Linen shirt', 'Order #1041 paid', 'New customer: Omar' ];</script><div class="h-[28rem] w-full p-3"> <Workspace autoHideTabs storageKey="docs-workspace-auto-hide" defaultLayout={column(row(tabs('revenue', 'orders'), 'visitors'), 'activity', { sizes: [40, 60] })} > <WorkspacePanel id="revenue" title="Revenue"> <StatCard class={bare} label="This week" value={48210} format={{ style: 'currency', currency: 'USD', maximumFractionDigits: 0 }} delta={0.124} /> </WorkspacePanel> <WorkspacePanel id="orders" title="Orders"> <StatCard class={bare} label="This week" value={1284} delta={0.061} /> </WorkspacePanel> <WorkspacePanel id="visitors" title="Visitors"> <StatCard class={bare} label="This week" value={9312} delta={-0.032} /> </WorkspacePanel> <WorkspacePanel id="activity" title="Activity" badge={ACTIVITY.length}> <ul class="flex flex-col divide-y divide-border"> {#each ACTIVITY as line (line)} <li class="px-4 py-3"><Text variant="body-md">{line}</Text></li> {/each} </ul> </WorkspacePanel> </Workspace></div> 8. Arrange
arrange() tidies every group in one step, and each flies to its new place: grid, columns, rows, or equal to keep the arrangement and even out the splits. The panel menu offers the same under Arrange, and where two dividers meet, one drag resizes both ways at once.
<script lang="ts"> import { Workspace, WorkspacePanel, Button, Text, row, column, type WorkspaceArrangement } from 'omaris'; let workspace = $state<ReturnType<typeof Workspace>>(); const WAYS: [WorkspaceArrangement, string][] = [ ['grid', 'Grid'], ['columns', 'Side by side'], ['rows', 'Stacked'], ['equal', 'Equal sizes'] ]; const PANELS = ['Revenue', 'Orders', 'Visitors', 'Refunds', 'Stock'];</script><div class="flex h-[28rem] w-full flex-col gap-3 p-3"> <div class="flex flex-wrap gap-2"> {#each WAYS as [how, label] (how)} <Button variant="tonal" size="sm" onclick={() => workspace?.arrange(how)}>{label}</Button> {/each} </div> <div class="min-h-0 flex-1"> <Workspace bind:this={workspace} defaultLayout={row( column('revenue', 'orders', { sizes: [70, 30] }), column('visitors', row('refunds', 'stock'), { sizes: [35, 65] }), { sizes: [62, 38] } )} > {#each PANELS as name (name)} <WorkspacePanel id={name.toLowerCase()} title={name} class="p-4"> <Text variant="body-md" tone="muted">{name} for this week.</Text> </WorkspacePanel> {/each} </Workspace> </div></div> 9. Overridden
Every part is reachable. A wider gap and a sharper radius through the custom properties, the strip and the front tab through classes, a fixed height from class, and padding on a panel's own content box. locked keeps the arrangement as it is: tabs switch, nothing moves.
<script lang="ts"> import { Workspace, WorkspacePanel, Text, row, column } from 'omaris';</script><div class="w-full p-3"> <Workspace locked class="h-80 rounded-shape-xl [--workspace-gap:--spacing(3)] [--workspace-radius:var(--radius-shape-sm)]" classes={{ header: 'bg-primary-container text-primary-container-foreground', tab: 'data-active:bg-primary data-active:text-primary-foreground' }} defaultLayout={column('summary', row('left', 'right'), { sizes: [40, 60] })} > <WorkspacePanel id="summary" title="Summary" class="bg-surface-container-low p-4"> <Text variant="body-md">A locked layout, restyled.</Text> </WorkspacePanel> <WorkspacePanel id="left" title="Left" class="p-4"><Text>Left</Text></WorkspacePanel> <WorkspacePanel id="right" title="Right" class="p-4"><Text>Right</Text></WorkspacePanel> </Workspace></div>