@github-ui/storybook-addon-performance-panel

A Storybook addon that provides real-time performance monitoring for stories. It displays comprehensive metrics including frame timing, input responsiveness, memory usage, React profiling, and more.

Quick Start

React projects

Add the addon to your Storybook configuration:

// .storybook/main.ts
const config = {
  addons: [
    '@github-ui/storybook-addon-performance-panel',
  ],
}

// .storybook/preview.ts
import addonPerformancePanel from '@github-ui/storybook-addon-performance-panel'
import {definePreview} from '@storybook/react-vite'

export default definePreview({
  addons: [addonPerformancePanel()],
})

The performance panel appears as a "⚡ Performance" tab at the bottom of Storybook.

Project Structure

This is an npm workspaces monorepo:

Package	Description
packages/storybook-addon-performance-panel	The addon — collectors, panel UI, and types
packages/examples-react	React docs storybook (@storybook/react-vite)
packages/storybook-config	Shared storybook config (theming, features, Vite helpers)
packages/website	Documentation site (TanStack Start + MDX)

Documentation

See the addon README for full documentation including:

• Architecture and how the addon works
• All metrics collected (frame timing, input, main thread, LoAF, CLS, React, memory)
• Metric thresholds and color coding
• Browser compatibility
• Interpreting metrics and troubleshooting guide

Development

npm install          # Install dependencies
npm run build        # Build the addon
npm test             # Run tests
npm run lint         # Lint
npm run tsc          # Type check
npm run dev          # Build + start storybook and site with portless
                     # → http://examples-react.localhost:1355 (React)
                     # → http://site.localhost:1355 (Docs site)
npm run docs         # Start just the React docs storybook

Contributing

See CONTRIBUTING.md for development setup and pull request guidelines.

License

MIT