@connexion-mobility-ltd/ui-library
v1.0.6
Published
[Storybook Demo](https://master.d32sji45w4dv29.amplifyapp.com) — View the latest published component library.
Downloads
10
Keywords
Readme
UI Shared Library
Storybook Demo — View the latest published component library.
This repository contains a shared UI component library built using React and Vite, designed for reuse across multiple applications. The goal is to provide a consistent, easily maintainable, and scalable design system that accelerates development and ensures visual consistency across products.
✨ Features
- ⚛️ React with fast refresh and HMR (Hot Module Replacement) via Vite
- 🧱 Prebuilt shared components following the Connexion Design System
- 🎨 Figma design integration for accurate visual matching
- 📦 Ready to publish as an npm package (optional)
- 🧹 Code linting with ESLint
- 📚 Component documentation and previews via Storybook
📁 Folder Structure
ui-shared-library/
├── .storybook/ # Storybook configuration
├── src/
│ ├── components/ # Shared UI components
│ ├── hooks/ # Reusable custom React hooks (optional)
│ └── index.ts # Export components for consumption
├── public/ # Static assets
├── vite.config.ts # Vite configuration
├── tsconfig.json # TypeScript configuration
├── .eslintrc.js # ESLint rules
└── package.json🎨 Design Reference
All components follow the design guidelines provided in the Connexion Design System. For reference, please consult the Figma file linked below:
🚀 Getting Started
1. Install dependencies
npm install2. Run Storybook (Component Previews)
Storybook is used to develop and showcase individual components in isolation.
npm run storybookStorybook will be available at http://localhost:6006 by default.
3. Build the library
To generate a bundled version of the library for distribution:
npm run build4. Lint your code
To run ESLint:
npm run lint📦 Publishing (Optional)
To publish your library as a package to npm:
- Ensure your components are exported via
src/index.ts - Build the library:
npm run build - Login and publish:
npm login npm publish
🔐 Consider setting
"private": trueinpackage.jsonif you don’t want it published.
🧑💻 Tech Stack
- React
- TypeScript
- Vite
- Storybook
- ESLint
- Figma (for design specs)
📬 Contributing
- Fork the repo
- Create your feature branch:
git checkout -b feat/my-new-component - Commit your changes:
git commit -m "Add new component" - Push to the branch:
git push origin feat/my-new-component - Open a Pull Request
📝 License
This project is licensed under the MIT License.
