@passionbuilt.dev/nimbus-ui
v1.0.2
Published
A minimalist, neumorphism-inspired Vue 3 UI kit with accessible, token-based components.
Maintainers
Readme
Nimbus UI
Nimbus is a minimalist, neumorphism-inspired Vue 3 UI kit for developers and designers who want clean, soft, tactile interfaces. It ships design foundations — typography, color tokens, spacing, soft shadows — plus a set of accessible, ready-to-use components. Perfect for portfolios, prototypes, and projects.
Status: Nimbus is published to npm as
@passionbuilt.dev/nimbus-ui.npm install @passionbuilt.dev/nimbus-ui
Features
- Foundations — typography scale, color tokens, spacing, border-radius, and soft elevation shadows, all driven by CSS custom properties with light/dark themes.
- Components — buttons, inputs, textareas, selects, checkboxes, radios, dialogs, forms, menus, tabs, accordions, data tables, tags, avatars, images, links, and layout primitives (Box, Text).
- Accessibility — focus states, semantic HTML, ARIA patterns (tabs, menus, combobox), focus traps, and full keyboard navigation.
- Lightweight & themeable — Vue is a peer dependency, styles are token-based, and components are easy to customize and extend.
Components
| Component | Description |
| --- | --- |
| PxBox | Layout primitive / container with elevation |
| PxText | Typographic text & headings (via as) |
| PxButton | Button, supports variant, fullWidth, as, link rendering |
| PxLink | Accessible link with aria-current support |
| PxInput / PxTextarea | Form fields with helperMessage, validation states |
| PxSelect | Floating UI combobox with full keyboard nav |
| PxCheckbox / PxRadio | Form controls with v-model, validation states |
| PxDialog | Modal with focus trap and overlay-to-close |
| PxForm | Form layout wrapper, stacks fields with consistent spacing |
| PxFormSection | Titled fieldset for grouping related form fields |
| PxMenu / PxMenuItem | Floating UI menu with arrow-key navigation |
| PxTabs / PxTab | ARIA tabs with roving tabindex |
| PxAccordion / PxAccordionItem | Expandable panels with grid animation |
| PxDataTable | Neumorphic table with columns / rows |
| PxTag | Status/label tag with shape variants |
| PxAvatar / PxImage / PxIconContainer | Media & icon primitives |
See the Storybook for the full prop reference and live examples.
Documentation
Component documentation, props, and interactive examples live in Storybook. Run it locally:
npm run storybookDevelopment
git clone https://github.com/Passion-Built/Nimbus-Vue.git
cd Nimbus-Vue
npm install
npm run dev # Vite dev server (src/App.vue playground)
npm run storybook # Storybook on :6006
npm run build # Build the library to dist/
npm run build-storybook # Static Storybook buildContributions are welcome — please read CONTRIBUTING.md first. By participating you agree to the Code of Conduct.
License
MIT © Passion Built
