# @embedpdf/plugin-shell Panels and menus for EmbedPDF: keeps track of which panels, dialogs and menus are open. This plugin comes with each EmbedPDF framework package. Import it from the one you use: | Framework | Import from | Docs | | :-------- | :---------- | :--- | | React | `@embedpdf/react/shell` | [Panels & dialogs](https://www.embedpdf.com/docs/headless/react/ui/panels) | | Vue | `@embedpdf/vue/shell` | [Panels & dialogs](https://www.embedpdf.com/docs/headless/vue/ui/panels) | | Svelte | `@embedpdf/svelte/shell` | [Panels & dialogs](https://www.embedpdf.com/docs/headless/svelte/ui/panels) | | Angular | `@embedpdf/angular/shell` | [Panels & dialogs](https://www.embedpdf.com/docs/headless/angular/ui/panels) | ## In React A viewer has sidebars (thumbnails, comments, search), dialogs and menus. The shell plugin keeps track of which are open, so a toolbar button, a keyboard shortcut and your own code can all open the same panel, and you can remember the layout for next time. You draw the panels; the plugin only holds their state. Register `shellPlugin()`: **`shell-plugin.tsx`** ```tsx import { shellPlugin } from '@embedpdf/react/shell'; export const plugins = [/* … */ shellPlugin()]; ``` Then ask for a panel by name: **`comments-panel.tsx`** ```tsx import { useSurface } from '@embedpdf/react/shell'; import { CommentList } from './comment-list'; export function CommentsPanel() { const panel = useSurface('comments'); if (!panel.isOpen) return null; return ( ); } export function CommentsButton() { const panel = useSurface('comments'); return ; } ``` The names are yours: `'comments'`, `'thumbnails'`, `'settings'`. Each document keeps its own, so every tab remembers which panels were open. ## License Apache-2.0