Skip to content
DocsChartsSession lanesLast updated Nov 2, 2026

Session lanes

Every signed-in device, over time. Sample data: five devices from Sep 16 to Oct 14, an unknown device blocked after a failed passkey.

Device sessions over 30 daysActive days per device over 30 days: laptop 21, phone 20, work laptop 4, tablet 4, unknown 0; 2 devices idle and set to close, one unknown device blocked on oct 14.LAPTOPTHIS DEVICEPHONEACTIVEWORK LAPTOPWILL CLOSETABLETWILL CLOSEUNKNOWNBLOCKEDPASSKEY FAILEDSEP 16SEP 23SEP 30OCT 7OCT 14ACTIVEIDLEBLOCKED
Device sessions over 30 days
DeviceActive daysIdle sinceState
LAPTOP21THIS DEVICE
PHONE20ACTIVE
WORK LAPTOP4day 8WILL CLOSE
TABLET4day 17WILL CLOSE
UNKNOWN0BLOCKED · PASSKEY FAILED
Device sessions over 30 daysActive days per device over 30 days: laptop 21, phone 20, work laptop 4, tablet 4, unknown 0; 2 devices idle and set to close, one unknown device blocked on oct 14.LAPTOPTHIS DEVICEPHONEACTIVEWORK LAPTOPWILL CLOSETABLETWILL CLOSEUNKNOWNBLOCKEDFAILEDSEP 16SEP 30OCT 14ACTIVEIDLEBLOCKED
Device sessions over 30 days
DeviceActive daysIdle sinceState
LAPTOP21THIS DEVICE
PHONE20ACTIVE
WORK LAPTOP4day 8WILL CLOSE
TABLET4day 17WILL CLOSE
UNKNOWN0BLOCKED · PASSKEY FAILED

Installation

  1. 1

    Set up the registry once

    Your token in .env and @chartory in components.json. Skip this when another chart is already installed.

    Installation guide
  2. 2

    Add the chart

    One command adds the Session lanes component to your project.

    npx shadcn add @chartory/session-lanes
  3. 3

    Use it

    Pass your rows. The props are the Figma properties.

    usage.tsx
    import { SessionLanes }  from "@/components/chartory/session-lanes"<SessionLanes  data={devices}  size="m"  legend/>

Props

<SessionLanes>

Every prop but data is a Figma property with the same name and values.

PropTypeDefault
data: The chart's data. The tables below list every field.SessionLanesDataRequired
size: The size class. Each one is laid out again from the data."xs" | "s" | "m" | "l""m"
legend: Shows the legend row under the plot.booleantrue

SessionLanesData

The data prop: one object for the whole chart.

PropTypeDefault
days: The number of days.numberRequired
rows: One entry per row.SessionLanesRow[]Required
xl: The x axis labels: [position, label] pairs.[number, string][]Required

SessionLanesRow

One object per entry in rows.

PropTypeDefault
label: The name shown on the chart.stringRequired
act: The active hours.number[]Required
idleFrom?: Idle from this hour.number—
blocked?: Where it is blocked and its label.SessionLanesBlocked—
state: The state.stringRequired
tone: The tone of the mark (a colour token)."ok" | "warn" | "bad"Required

SessionLanesBlocked

The rows.blocked object.

PropTypeDefault
d: The day it is blocked from.numberRequired
text: The label as shown.stringRequired
short: The short form of the label, for the small sizes.stringRequired

The data as a JSON Schema: schemas/session-lanes.json

Session lanes: a React and Figma chart in four sizes

What does a session lanes show?

Session lanes give each device a lane showing when it was active, idle or blocked, and what will happen to it next. Unknown devices and failed sign-ins stand out. Use it for account security pages and admin reviews.

Chartory ships it as a Figma component and a React component with the same name. The code installs from the shadcn registry with one command and lands in your project as a file you own.

What is the Session lanes component?

It is one <SessionLanes> component. Its props are the Figma properties with the same names and values, and the props table above lists them. The data is sessions per device with a state.

Sizes XS, S, M and L re-lay the chart out from the data instead of scaling it, so labels stay readable at every size.

When should I use it?

  • Is it devices over time? Yes means the session lanes fit.
  • Does state matter? Yes means the session lanes fit.
  • Is it sessions, not events? Yes means the session lanes fit.

When does another type fit better?

  • Keys and their use. Use Key timeline instead.
  • Plain counts. Use Horizontal bars instead.
  • Every request. Use Event barcode instead.

Session lanes questions

Installing, data, Figma and plans.

  • Yes. It installs through the shadcn registry with the shadcn CLI, and the file lands in your project.

Stay in the loop

New charts, by email.

Get an email when new chart types and releases ship.

Unsubscribe any time.