Pepulux Playbook

Versions

Pepulux UI follows Semantic Versioning 2.0.0. Breaking changes only in major releases.

Release policy

Major (x.0.0)Breaking API changes — prop renames, removed components, token renames.
Minor (1.x.0)New components, new props, new variants — always backwards compatible.
Patch (1.0.x)Bug fixes, visual tweaks, performance improvements.

Changelog

v1.0.0CurrentJune 2025
NewInitial public release — 74 components across 8 categories
NewFull Figma V8.0 spec coverage: Badge (12 colors, 3 shapes), Button (5 hierarchies + destructive), Input (14 types), Tooltip (7 placements + arrow toggle), Modal (stacked/horizontal × 4 colors + destructive), Autocomplete (freeSolo, multiple, groupBy, async, clearable)
NewMulti-brand token system: --brand, --brand-hover, --brand-subtle, --brand-text
NewPepulux (purple) and Omkaarya (orange) brand presets
NewPlaybook documentation site at playbook.pepulux.com
NewTypeScript definitions for all 74 components with Figma-aligned prop types
Newnpm package @pepulux/ui published
v0.x2024 — Internal only

Pre-release development. Components were internal-only, consumed directly from @/components/ui within the Pepulux OS monorepo.

Planned releases

v1.1.0Planned
  • Figma V9.0 spec sync for all 74 components
  • @pepulux/mcp — official MCP server for AI-assisted development
  • Expanded template library (marketing page, auth flow)
  • Storybook integration
v2.0.0Planned
  • CSS Layers support for better cascade control
  • Dark mode token system
  • New components from Figma V9.0: Timeline, Transfer List, Stepper