1.0.0

Client-side debugging toolbar for Unleash feature flags with override capabilities and first-class framework support.

What's new

Core Features

• Flag Overrides: Force boolean flags ON/OFF or override variant values in real-time
• Context Overrides: Modify userId, sessionId, environment, and custom properties without code changes
• Flexible Persistence: Choose between memory, sessionStorage, or localStorage for override state
• Visual UI: Interactive toolbar with search, filtering, and real-time feedback
• Lightweight: Core bundle ~8 KB gzipped, minimal performance impact

Configuration Options

• Storage modes: memory, sessionStorage, localStorage
• Positioning: bottom-right, bottom-left, top-right, top-left
• Initial visibility: Show/hide toolbar on load
• Alphabetical sorting: Organize flags alphabetically
• Cookie sync: Enable SSR state synchronization (Next.js)
• Custom theming: CSS variables for colors and spacing

Bundle Sizes

Module	Size (gzipped)
Core	~8 KB
React	~0.2 KB
Next.js	~0.6 KB
CSS	~2.4 KB

Framework Integrations

React Integration

• Seamless SDK Integration: Works directly with official @unleash/proxy-client-react
• Drop-in Replacement: Replace FlagProvider with UnleashToolbarProvider
• React StrictMode Compatible: Properly handles development double-rendering
• Automatic Wrapping: No manual client management required
• Bundle: ~0.2 KB gzipped (thin wrapper)

Next.js Support

• App Router Compatible: Full support for Next.js 13+ App Router
• SSR with Cookie Sync: Server-side rendering with cookie-based state synchronization
• Server Components: Use overrides in both client and server components
• Server Utilities: Helper functions for reading overrides on the server
• Bundle: ~0.6 KB gzipped (server utilities)

Developer Experience

• TypeScript Support: Full type definitions included
• Modern Build: ES modules with tree-shaking support
• Customizable: Theming, positioning, and behavior options
• Debug-Friendly: Global window access for console debugging
• Zero Dependencies: Core has no runtime dependencies (peer dependencies for SDKs)

Example Applications

Working example apps are included in the repository:

• Vanilla JavaScript (examples/vanilla/) - Pure JavaScript implementation with no framework
• React (examples/react/) - React 18 with Vite, using @unleash/proxy-client-react
• Next.js (examples/nextjs/) - Next.js 13+ App Router with SSR and cookie sync
• Vue (examples/vue/) - Vue 3 integration example (manual client setup)
• Angular (examples/angular/) - Angular integration example (manual client setup)

New Contributors

• @alexcasalboni made their first contribution in #5

Full Changelog: https://github.com/Unleash/toolbar/commits/1.0.0