This update ensures that the published @promethey/bsui package correctly reflects the latest release version.

Maintenance​

This patch includes a correction to the package version metadata, ensuring consistency between the project configuration and the published npm package.

No component APIs or runtime behavior have changed in this release.

Links​

• GitHub Release
• npm Package
• Documentation
• Storybook

This release addresses an issue introduced in v1.2.2 where the compiled package files and generated type declarations were not included in the npm tarball.

Overview​

BSUI v1.2.3 includes:

• Restored the compiled dist directory in the npm package.
• Restored the generated types directory in the npm package.
• Ensured the published package contains all files required for normal BSUI usage.
• Preserved TypeScript declaration files for editor and IDE support.

Fixed​

npm Package Contents​

Fixed the package publishing configuration and build process so that the npm package contains the expected compiled files:

dist/
types/
LICENSE
README.md

Links​

• GitHub Release
• npm Package
• Documentation
• Storybook

This release contains a targeted fix to the Sandbox dependency configuration, ensuring that the documentation environment uses a stable BSUI version instead of resolving the latest dist-tag.

Overview​

BSUI v1.2.2 includes:

• Fixed Sandbox dependency resolution.
• Updated the Sandbox to use a stable BSUI version.
• Improved the reliability of interactive documentation examples.

Fixed​

Sandbox​

Updated the Sandbox dependency configuration to use a specific compatible BSUI version instead of latest.

This prevents dependency resolution issues that could cause the Sandbox to hang while initializing.

Links​

• GitHub Release
• npm Package
• Documentation
• Storybook

This release reduces the number of dependencies installed by BSUI consumers and improves how the documentation Sandbox resolves BSUI versions.

Overview​

BSUI v1.2.1 includes:

• Moved documentation-only dependencies from dependencies to devDependencies.
• Reduced the runtime dependency footprint of the published package.
• Updated the documentation Sandbox to use @promethey/bsui with a compatible version range.
• Improved dependency configuration for the documentation environment.

Dependency Improvements​

This release separates development and runtime dependencies more accurately.

Documentation and development tools such as Docusaurus, Sandpack, Prettier, and related packages are no longer included in the package's runtime dependencies.

This prevents BSUI users from unnecessarily installing packages that are only required to develop, build, or document the library.

The runtime dependency set now contains only packages required by BSUI itself.

Documentation Sandbox​

The documentation Sandbox dependency has been updated to use:

"@promethey/bsui": "latest"

This allows the Sandbox to use the latest compatible BSUI release within the 1.x version range while maintaining compatibility with the minimum supported version.

As new compatible versions of BSUI are published, the documentation environment can resolve them without requiring a hardcoded package version.

Package Improvements​

The published package now has a cleaner dependency structure:

• Runtime dependencies remain in dependencies.
• Documentation and development tooling are kept in devDependencies.
• Consumers no longer need to install Docusaurus, Sandpack, Prettier, or other documentation tooling as part of BSUI.

This makes the package installation smaller and more focused on the actual component library.

Maintenance​

Additional improvements include:

• Cleaned up package dependency configuration.
• Improved dependency boundaries between the library and documentation project.
• Improved the development and documentation workflow.
• Updated Sandbox package resolution.

BSUI v1.2.1 is a maintenance release that keeps the package leaner for consumers while making the documentation environment easier to maintain.

Links​

• GitHub Release
• npm Package
• Documentation
• Storybook

This release introduces a new compound Form API, a substantially reorganized documentation site, an interactive Sandbox on the landing page, improved Storybook integration, and several developer experience improvements.

Important: v1.2.0 introduces a breaking change to the Form API. Form child components are no longer exported directly from the package root. Existing applications using direct imports should migrate to the new compound Form API.

Overview​

BSUI v1.2.0 includes:

• Introduced the compound Form component API.
• Moved Form child components under the Form namespace.
• Added and improved documentation for Form components, including InputGroup and Label.
• Reorganized and cleaned up the entire Docusaurus documentation.
• Added an interactive Sandbox to the documentation landing page.
• Added architecture and API design documentation.
• Improved Storybook documentation and component tests.
• Removed automatic npm publishing from CI/CD.

Breaking Changes​

Form Compound API​

Form child components are no longer exported directly from the package root.

The following import pattern is no longer supported:

import { Form, Label, Control, Check, Select } from "@promethey/bsui";

Use the compound Form API instead:

import { Form } from "@promethey/bsui";

<Form.Label htmlFor="email">Email</Form.Label>
<Form.Control id="email" />
<Form.Check label="Remember me" />
<Form.Select />

The following components are now accessed through Form:

• Form.Label
• Form.Control
• Form.Check
• Form.Range
• Form.Select
• Form.FloatingLabel
• Form.InputGroup
• Form.Text

This change keeps the root package API smaller and makes the relationship between the Form container and its child components explicit.

Migration​

If your application currently imports Form child components directly, update your imports when upgrading to v1.2.0.

Before:

import { Label, Control, Check } from "@promethey/bsui";

After:

import { Form } from "@promethey/bsui";

Then replace direct component usage:

<Label />
<Control />
<Check />

with:

<Form.Label />
<Form.Control />
<Form.Check />

Form Improvements​

The new compound component API provides a more structured approach to building forms with BSUI.

Form controls can now be discovered directly through the Form component, resulting in a more cohesive API:

<Form>
  <Form.Label htmlFor="email">Email address</Form.Label>
  <Form.Control id="email" type="email" placeholder="example@email.com" />
  <Form.Check label="Remember me" />
</Form>

This API is also reflected throughout the documentation and Storybook examples.

Documentation​

v1.2.0 includes a major restructuring of the Docusaurus documentation.

The documentation has been reviewed and reorganized to improve consistency, navigation, and discoverability.

Improvements include:

• Restructured documentation sections.
• Cleaner component documentation.
• Improved installation and usage guides.
• Updated Form documentation.
• Consistent examples across the documentation.
• Added architecture and API design documentation.
• Improved overview and navigation pages.
• Updated README and project documentation.

The documentation now follows the same component organization and API conventions as the library itself.

Interactive Sandbox​

The documentation landing page now includes an interactive Sandbox demonstrating BSUI components in a live React environment.

The Sandbox provides an immediate way to explore the library, inspect examples, and understand how BSUI components can be composed together.

Storybook​

Storybook has also been updated to reflect the new API and documentation structure.

Changes include:

• Updated Form stories to use compound components.
• Improved component documentation.
• Fixed component tests.
• Removed the unnecessary Bootstrap Icons dependency.
• Improved consistency between Storybook and Docusaurus examples.

Developer Experience​

This release includes several improvements to the development and release workflow.

Documentation​

The README, introduction, installation documentation, architecture documentation, and API documentation have all been improved and made more consistent.

Testing​

Component tests have been updated and fixed to reflect the current component API.

Release Workflow​

Automatic npm publishing has been removed from CI/CD.

npm releases are now published manually, providing greater control over package versions and release timing.

Maintenance​

Additional fixes and cleanup include:

• Fixed Form component imports after restructuring the Form API.
• Updated Storybook documentation after the Form API changes.
• Fixed the Docusaurus overview page.
• Cleaned up documentation structure and navigation.
• Updated examples to use the current public API.
• Removed unnecessary Storybook dependencies.

BSUI v1.2.0 represents an important step toward a more consistent and maintainable component architecture. The new compound Form API, improved documentation, and enhanced development workflow provide a stronger foundation for future BSUI releases.

Links​

• GitHub Release
• npm Package
• Documentation
• Storybook

This release introduces a reorganized documentation workflow, improved Storybook categorization, new component examples, and several fixes related to navigation and dropdown components.

Overview​

BSUI v1.1.2 includes:

• Added documentation for new and existing components including Accordion, Check, CloseButton, Navbar, Nav, and FloatingLabel.
• Reorganized Storybook component categories into clearer groups: Foundation, Form, Core, and Components.
• Improved Navbar and Dropdown integration examples.
• Added floating style support for Dropdown.Menu.
• Updated project documentation, homepage layout, README, and metadata.

Documentation Updates​

This release significantly improves the documentation experience by introducing:

• New component documentation pages with live examples.
• Better separation between foundational elements, form controls, core components, and complex components.
• Updated navigation examples demonstrating the latest Navbar and Dropdown APIs.
• Improved consistency between Storybook and Docusaurus documentation.

The new documentation structure makes it easier to discover components and understand their intended usage.

Storybook Improvements​

Storybook has been reorganized to provide a cleaner component hierarchy.

The previous category structure has been replaced with:

• Foundation — design tokens, utilities, and base styles.
• Form — input controls and form-related components.
• Core — fundamental UI building blocks.
• Components — advanced composed components.

This structure provides a more scalable foundation for future BSUI component growth.

Component Updates​

Dropdown​

Improved Dropdown.Menu with new floating style support, allowing more flexible positioning and styling behavior.

Navbar and Navigation​

Updated Navbar and Nav documentation, stories, and examples to reflect the latest component API and dropdown integration.

FloatingLabel​

Added complete documentation for the FloatingLabel component, including:

• Basic usage examples.
• Input and password field examples.
• Automatic ID generation behavior.
• Utility props support.
• API reference.

Maintenance​

Additional improvements include:

• Updated README badges and layout.
• Updated project compatibility documentation.
• Added Node.js version requirements.
• Improved homepage styling and presentation.

BSUI v1.1.2 continues improving the foundation of the library by making components easier to discover, document, and integrate into applications.

Links​

• GitHub Release
• npm Package
• Documentation
• Storybook

This patch release fixes documentation references and updates package metadata to better reflect the current documentation deployment workflow.

Overview​

BSUI v1.1.1 includes:

• Fixed incorrect GitHub Actions badge reference in the npm README.
• Updated package documentation metadata.
• Improved consistency between project documentation and deployment configuration.

Documentation Updates​

This release improves the reliability of project documentation by ensuring:

• README badges point to the correct GitHub Actions workflow.
• Package metadata reflects the current documentation deployment setup.
• Documentation references remain synchronized with project infrastructure.

Maintenance​

BSUI v1.1.1 is a small maintenance release focused on quality improvements and keeping the project configuration accurate.

No component API changes were introduced in this release.

This release introduces a complete documentation platform powered by Docusaurus, while keeping Storybook as the place for interactive component exploration.

Overview​

BSUI v1.1.0 introduces:

• A new Docusaurus-powered documentation website.
• Structured component documentation with API references.
• Live component examples directly inside documentation pages.
• Improved navigation and documentation organization.
• Integrated Storybook experience available from the documentation website.
• Clear separation between API documentation and interactive examples.

Documentation Platform​

The documentation experience has been redesigned:

Docusaurus​

Docusaurus is now used for:

• Component guides.
• Installation and usage documentation.
• API references.
• Development guides.
• Project information.

Storybook​

Storybook remains focused on:

• Interactive component previews.
• Visual testing.
• Component exploration.
• Real-time UI examples.

The two tools now work together:

• Documentation → Docusaurus
• Interactive examples → Storybook

Component Documentation​

Added documentation pages for components including:

• Alert
• Control
• ListGroup
• And other BSUI components.

Each component documentation page includes:

• Installation example.
• Basic usage.
• Component variants.
• Composition examples.
• Utility prop examples.
• API reference tables.

Developer Experience​

This release improves the development workflow with:

• Better component discoverability.
• Consistent documentation structure.
• Improved navigation between guides and examples.
• Live React examples inside documentation.
• Automatic documentation deployment through GitHub Pages.

Deployment​

The documentation infrastructure now uses GitHub Actions to automatically deploy:

This release continues improving the developer experience with documentation refinements, better examples, and additional project improvements.

Changes​

Improved​

• Improved documentation structure.
• Added clearer component examples.
• Refined interactive playground experience.
• Improved development tooling.
• Updated dependencies.

Fixed​

• Minor documentation issues.
• Small component consistency improvements.

Links​

• GitHub Release
• npm Package
• Documentation
• Storybook

This patch release focuses on improving stability, documentation quality, and developer experience after the initial v1.0.0 release.

Changes​

Fixed​

• Improved component consistency.
• Fixed minor API documentation issues.
• Updated examples across documentation.
• Improved package reliability.

Improved​

• Refined internal component behavior.
• Improved development workflow.
• Updated project dependencies.

Links​

• GitHub Release
• npm Package
• Documentation

This release establishes the initial public API, component architecture, documentation, and development infrastructure.

Overview​

BSUI v1.0.0 introduces:

• 30+ reusable React components.
• Bootstrap 5 powered styling.
• The Prime component foundation.
• Utility props for common Bootstrap utilities.
• JSDoc-powered IntelliSense without TypeScript.
• Storybook documentation.
• Interactive React playgrounds.
• Vitest testing infrastructure.
• Automated CI workflows.

Component Library​

The first stable release includes:

Layout​

• Container
• Grid
• Row
• Col

Forms​

• Form
• Control
• Label
• Check
• Range
• Select
• FloatingLabel
• InputGroup

Navigation​

• Nav
• Navbar
• Breadcrumb
• Dropdown

Feedback​

• Alert
• Badge
• Progress
• Spinner
• Placeholder

Content​

• Accordion
• Card
• ListGroup

Overlay​

• Modal
• Collapse
• Carousel
• Offcanvas

Buttons​

• Button
• ButtonGroup
• CloseButton

Architecture​

BSUI follows a consistent component architecture:

• React composition over inheritance.
• Bootstrap CSS without Bootstrap JavaScript.
• Shared component APIs.
• Runtime validation using PropTypes.
• JSDoc documentation for editor support.

API Changes​

The stable release introduced:

• Unified component API.
• tone prop replacing previous theme-related naming.
• Shared utility prop system.

Links​

• GitHub Release
• npm Package
• Documentation
• Storybook