Kanshō/New session button

New session button

The new-session action aligned to the right of the launcher header. A thin wrapper over Button with a leading plus glyph.

Included in the single kansho full pack. Components are not offered as separate installs.

Demo action: No action yet

Variants

Usage

Guidance
Do
  • Anchor it to the right of the launcher header.
  • Shorten to label="New" in tight headers.
Don't
  • Use it for anything other than starting a session.
  • Drop the leading plus glyph — it carries the affordance.
When to use
The primary create action on a session launcher or list header.
When not to
Inline row actions or menus — use a plain Button there.

Props

Extends Button
PropTypeDefaultDescription
labelstring'New session'Button text beside the plus glyph.
...ButtonPropsButtonProps—All Button props except children — variant, size, disabled, onClick, etc.

Component documentation

New Session Button

components/workspace/new-session-button.tsx

Purpose

Provides the standard labelled action for starting a new session.

Appropriate use

Use wherever session creation is available and the host supplies the action handler.

Example

components/workspace/new-session-button.tsx has a representative live example in the "Variants" section on /components/new-session-button.

States

It inherits Button state and visual variants while replacing children with an optional label and plus icon.

API and props

NewSessionButton extends ButtonProps except children with label and ref.

Dependencies

Direct imports are React, Lucide icons, and Button.

Accessibility

It retains native Button semantics, keyboard activation, focus, disabled, and busy behavior with visible text.

Limitations

It does not create a session or provide success/error feedback; callers must supply onClick and host state.

Source

Source: components/workspace/new-session-button.tsx.

Full pack

components/workspace/new-session-button.tsx is documented at /components/new-session-button and installs only through the single Kansho full pack; no individual component install is offered.