@dmitriikapustin/ui
v0.4.5
Published
Universal UI/UX Kit — React 19 component library with Atomic Design, CSS custom properties, and SCSS modules
Readme
@dmitriikapustin/ui
Universal UI/UX Kit — React 19 component library with Atomic Design, CSS custom properties, and Tailwind CSS 4.
Install
npm install @dmitriikapustin/uiUsage
Step 1. Import design tokens stylesheet once in your app's root layout (e.g. app/layout.tsx for Next.js, or main.tsx for Vite):
import '@dmitriikapustin/ui/styles.css';This registers all CSS custom properties (--bg, --fg, --brand-primary, --radius-lg, etc.) on :root. Components reference these tokens — without this import, components render without colors / typography / spacing.
Step 2. Use components anywhere:
import { Button, Input, Badge } from '@dmitriikapustin/ui';
export function App() {
return (
<div>
<Button variant="primary" size="hero">Get Started</Button>
<Input label="Email" placeholder="[email protected]" />
<Badge color="success">Active</Badge>
</div>
);
}Design Tokens
All tokens are CSS custom properties. Import @dmitriikapustin/ui/styles.css to get:
- Colors:
--neutral-*,--brand-*,--color-*(semantic) - Surfaces:
--bg-*,--fg-*,--border-*(theme-aware) - Typography, spacing, shadows, radii, transitions
Dark mode activates via [data-theme="dark"] on <html>.
Components
Atoms
Button, Input, Badge, Tag, Toggle, Avatar, Spinner, Divider, MenuItem, IconButton, Logo, StatBadge, Textarea, Select, Checkbox, Radio, Link, Tooltip, Skeleton, Icons
Molecules
Card, IconBadge, Gallery, FormField, SearchBar, Stat, Alert, Tabs, ChatInput, ChatMessage, TopPromo, ProfileNav, IconWithText, StampCard, PasswordInput, Breadcrumbs, Toast, Pagination, CodeInput, Modal, DropdownMenu
Organisms
Header, Footer, PricingCard, TestimonialCard, FeatureGrid, Sidebar, AppCard, AppTopLine, EmptyState, HeroSection, LogoCloud, StatsBar, CTASection, BentoGrid, FAQSection, ComparisonTable, PromoBento, PromoShowcase, PromoSplit, PromoTrustGrid, PromoDevicesCTA, PromoTestimonials, PromoHero, PromoHeroForm, PromoPricing, PromoActionCards
Templates
ArticleHero, ArticleBody, ArticleHeading, ArticleFigure, ArticleTable, ArticleList, ArticleNote, ArticleChatBlock, ArticleLinkButton, ArticleFooter, ArticleLayout, LandingLayout, ArticleLineChart, ArticleBarChart, ArticleScatterChart
Peer Dependencies
react>= 18.0.0react-dom>= 18.0.0tailwindcss>= 4.0.0 (optional, for utility classes)
License
MIT © Kapustin Team
