Copy to clipboard
Project quick actions
Review key details and trigger common actions in one place.
<Sidepanel>
<SidepanelTrigger>
<Button variant="outline">Open sidepanel</Button>
</SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent>
<SidepanelHeader>
<SidepanelTitle>Project quick actions</SidepanelTitle>
<SidepanelDescription>
Review key details and trigger common actions in one place.
</SidepanelDescription>
</SidepanelHeader>
<div class="space-y-4 py-4">
<div class="space-y-2">
<Label for="project-name">Project name</Label>
<Input id="project-name" value="Website redesign" />
</div>
<div class="space-y-2">
<Label for="project-owner">Owner</Label>
<Input id="project-owner" value="Product Team" />
</div>
</div>
<SidepanelFooter>
<SidepanelClose variant="secondary">Cancel</SidepanelClose>
<Button>Save changes</Button>
</SidepanelFooter>
</SidepanelContent>
</Sidepanel>
<Sidepanel>
<SidepanelTrigger>
<Button variant="outline">Open sidepanel</Button>
</SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent>
<SidepanelHeader>
<SidepanelTitle>Project quick actions</SidepanelTitle>
<SidepanelDescription>
Review key details and trigger common actions in one place.
</SidepanelDescription>
</SidepanelHeader>
<div class="space-y-4 py-4">
<div class="space-y-2">
<Label for="project-name">Project name</Label>
<Input id="project-name" value="Website redesign" />
</div>
<div class="space-y-2">
<Label for="project-owner">Owner</Label>
<Input id="project-owner" value="Product Team" />
</div>
</div>
<SidepanelFooter>
<SidepanelClose variant="secondary">Cancel</SidepanelClose>
<Button>Save changes</Button>
</SidepanelFooter>
</SidepanelContent>
</Sidepanel><Sidepanel>
<SidepanelTrigger>
<Button variant="outline">Open sidepanel</Button>
</SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent>
<SidepanelHeader>
<SidepanelTitle>Project quick actions</SidepanelTitle>
<SidepanelDescription>
Review key details and trigger common actions in one place.
</SidepanelDescription>
</SidepanelHeader>
<div class="space-y-4 py-4">
<div class="space-y-2">
<Label for="project-name">Project name</Label>
<Input id="project-name" value="Website redesign" />
</div>
<div class="space-y-2">
<Label for="project-owner">Owner</Label>
<Input id="project-owner" value="Product Team" />
</div>
</div>
<SidepanelFooter>
<SidepanelClose variant="secondary">Cancel</SidepanelClose>
<Button>Save changes</Button>
</SidepanelFooter>
</SidepanelContent>
</Sidepanel>
Installation
Copy to clipboard
npx @vds-testing/cli add sidepanel
npx @vds-testing/cli add sidepanelnpx @vds-testing/cli add sidepanel
bunx @vds-testing/cli add sidepanel
bunx @vds-testing/cli add sidepanelbunx @vds-testing/cli add sidepanel
pnpm dlx @vds-testing/cli add sidepanel
pnpm dlx @vds-testing/cli add sidepanelpnpm dlx @vds-testing/cli add sidepanel
yarn dlx @vds-testing/cli add sidepanel
yarn dlx @vds-testing/cli add sidepanelyarn dlx @vds-testing/cli add sidepanel
Usage
import {
Sidepanel,
SidepanelTrigger,
SidepanelOverlay,
SidepanelContent,
SidepanelHeader,
SidepanelTitle,
SidepanelDescription,
SidepanelFooter,
SidepanelClose
} from "@/components/vds/sidepanel"<Sidepanel>
<SidepanelTrigger>Open</SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent>
<SidepanelHeader>
<SidepanelTitle>Sidepanel Title</SidepanelTitle>
<SidepanelDescription>Sidepanel description goes here.</SidepanelDescription>
</SidepanelHeader>
<SidepanelFooter>
<Button variant="secondary">Cancel</Button>
<Button>Save</Button>
</SidepanelFooter>
</SidepanelContent>
</Sidepanel>Examples
Side positions
Copy to clipboard
Right Sidepanel
This sidepanel slides in from the right.
Left Sidepanel
This sidepanel slides in from the left.
<div class="flex flex-wrap gap-2">
<Sidepanel>
<SidepanelTrigger><Button variant="outline">Right</Button></SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent side="right">
<SidepanelHeader>
<SidepanelTitle>Right Sidepanel</SidepanelTitle>
<SidepanelDescription>This sidepanel slides in from the right.</SidepanelDescription>
</SidepanelHeader>
</SidepanelContent>
</Sidepanel>
<Sidepanel>
<SidepanelTrigger><Button variant="outline">Left</Button></SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent side="left">
<SidepanelHeader>
<SidepanelTitle>Left Sidepanel</SidepanelTitle>
<SidepanelDescription>This sidepanel slides in from the left.</SidepanelDescription>
</SidepanelHeader>
</SidepanelContent>
</Sidepanel>
</div>
<div class="flex flex-wrap gap-2">
<Sidepanel>
<SidepanelTrigger><Button variant="outline">Right</Button></SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent side="right">
<SidepanelHeader>
<SidepanelTitle>Right Sidepanel</SidepanelTitle>
<SidepanelDescription>This sidepanel slides in from the right.</SidepanelDescription>
</SidepanelHeader>
</SidepanelContent>
</Sidepanel>
<Sidepanel>
<SidepanelTrigger><Button variant="outline">Left</Button></SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent side="left">
<SidepanelHeader>
<SidepanelTitle>Left Sidepanel</SidepanelTitle>
<SidepanelDescription>This sidepanel slides in from the left.</SidepanelDescription>
</SidepanelHeader>
</SidepanelContent>
</Sidepanel>
</div><div class="flex flex-wrap gap-2">
<Sidepanel>
<SidepanelTrigger><Button variant="outline">Right</Button></SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent side="right">
<SidepanelHeader>
<SidepanelTitle>Right Sidepanel</SidepanelTitle>
<SidepanelDescription>This sidepanel slides in from the right.</SidepanelDescription>
</SidepanelHeader>
</SidepanelContent>
</Sidepanel>
<Sidepanel>
<SidepanelTrigger><Button variant="outline">Left</Button></SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent side="left">
<SidepanelHeader>
<SidepanelTitle>Left Sidepanel</SidepanelTitle>
<SidepanelDescription>This sidepanel slides in from the left.</SidepanelDescription>
</SidepanelHeader>
</SidepanelContent>
</Sidepanel>
</div>
Without close button
Copy to clipboard
No close button
Click outside or press Escape to close this sidepanel.
<Sidepanel>
<SidepanelTrigger>
<Button variant="outline">Open Sidepanel</Button>
</SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent showCloseButton={false}>
<SidepanelHeader>
<SidepanelTitle>No close button</SidepanelTitle>
<SidepanelDescription>
Click outside or press Escape to close this sidepanel.
</SidepanelDescription>
</SidepanelHeader>
</SidepanelContent>
</Sidepanel>
<Sidepanel>
<SidepanelTrigger>
<Button variant="outline">Open Sidepanel</Button>
</SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent showCloseButton={false}>
<SidepanelHeader>
<SidepanelTitle>No close button</SidepanelTitle>
<SidepanelDescription>
Click outside or press Escape to close this sidepanel.
</SidepanelDescription>
</SidepanelHeader>
</SidepanelContent>
</Sidepanel><Sidepanel>
<SidepanelTrigger>
<Button variant="outline">Open Sidepanel</Button>
</SidepanelTrigger>
<SidepanelOverlay />
<SidepanelContent showCloseButton={false}>
<SidepanelHeader>
<SidepanelTitle>No close button</SidepanelTitle>
<SidepanelDescription>
Click outside or press Escape to close this sidepanel.
</SidepanelDescription>
</SidepanelHeader>
</SidepanelContent>
</Sidepanel>
Anatomy
Sidepanel- Root container that manages stateSidepanelTrigger- Button that opens the sidepanelSidepanelOverlay- Background overlaySidepanelContent- The sliding panel (renders the close button at the top)SidepanelHeader- Header container for title and descriptionSidepanelTitle- Title text (usesvds-heading-2)SidepanelDescription- Description textSidepanelFooter- Footer pinned to the bottom, holds the action buttonsSidepanelClose- Button that closes the sidepanel
Actions
A sidepanel always uses a single primary CTA plus an optional secondary button — at most two buttons. Place them in SidepanelFooter, which is pinned to the bottom of the panel.
Props
SidepanelContent
| Prop | Type | Default | Description |
|---|---|---|---|
| side | “right” | “left” | “right” | Edge of screen to slide from |
| showCloseButton | boolean | true | Show the X close button at the top |
| class | string | - | Additional CSS classes |