@nevv-ui/primitives

Primitive UI components for Nevv UI - the building blocks of modern interfaces.

Installation

npm install @nevv-ui/primitives @nevv-ui/styles
# or
pnpm add @nevv-ui/primitives @nevv-ui/styles

What are Primitives?

Primitives are fundamental, single-purpose UI components with minimal dependencies. They are:

• Focused - Each component does one thing well
• Composable - Easily combined to create complex UIs
• Lightweight - Minimal bundle size and dependencies
• Accessible - Built with ARIA best practices

Components

Form Controls

• Button / ButtonGroup - Actions and navigation
• Input / InputGroup - Text input with various types
• Checkbox / CheckboxGroup - Multiple selections
• Radio / RadioGroup - Single selection from options
• Select - Dropdown selection
• Switch - Boolean toggle

Visual Elements

• Icon / IconWrapper - Icon display and styling
• Avatar / AvatarGroup - User representation
• Badge - Status indicators and counts
• Tag - Labels and categories
• Divider - Visual separation

Feedback

• Spin - Loading indicator
• Empty - No data state
• Skeleton - Loading placeholder
• Progress - Task completion indicator
• Alert - Important messages

Overlays

• Tooltip - Contextual help
• Popover - Floating content container

Utilities

• Scrollbar - Custom scrollbars
• Code - Code display

Usage

import { Button } from '@nevv-ui/primitives'
import '@nevv-ui/styles/components/button.css'

// In your component
<Button type="primary">Click me</Button>

Import individual components

import Button from '@nevv-ui/primitives/button'
import Input from '@nevv-ui/primitives/input'

Import all primitives

import { Button, Checkbox, Input } from '@nevv-ui/primitives'

CSS Dependency

All primitives require @nevv-ui/styles for styling:

// Import all styles
import ' @nevv-ui/styles'

// Or import individual component styles
import '@nevv-ui/styles/components/button.css'
import '@nevv-ui/styles/components/input.css'

TypeScript

Full TypeScript support with type definitions included.

License

MIT © ESTENX LTD