@alixpartners/ui-components

AlixPartners UI Component Library

A modern, reusable component library built with ReactJS.

Version 2.0 has been rebuilt from the ground up to align with the latest AlixPartners Design System and deliver improved developer experience, accessibility, and performance.

‼️ BETA Notice: This release is not yet production-ready. While stable for development and testing, expect ongoing refinements, new components, and breaking changes before the full release.

✨ What’s New in 2.0

• Completely redesigned architecture with modern build tooling (Vite)
• Updated design tokens and styles aligned with AlixPartners Design System
• Improved accessibility (a11y) and semantic HTML usage
• Streamlined props API for cleaner integration
• Enhanced Storybook documentation
• Faster build & development workflows

Version Support

• v2.x — Active development (BETA)
• v1.x — Maintained for legacy projects (no new features, critical fixes only)

🚀 Installation

npm install @alixpartners/ui-library

🔧 Usage

import { YourComponent } from '@alixpartners/ui-library'

function App() {
  return <YourComponent />
}

🧱 Components

Explore all available components and documentation in Storybook.

To run it locally:

npm run storybook

📦 Build

To bundle the library for publishing:

npm run build

The output will be in the dist/ directory.

Usage in projects while developing

When working on the library and testing it in another project:

# In the component library root:
npm link

# In the consuming project's root:
npm link alix-partners-react-components-test

Then import components using the alix-partners-react-components-test import.

🧪 Testing

npm run test

🧪 Test Coverage

npm run coverage

📚 Publish

To publish to npm:

• Bump the version in package.json
• Create a pull request in Azure DevOps to the main branch
• This will automatically publish the library to npm once approved

🤝 Contributing

The AlixPartners UI Component Library is a collaborative, community-driven project where contributions from all team members are encouraged and valued. If you’d like to add new components or improve existing ones, please see the CONTRIBUTING.md file.