@dmitriikapustin/ui 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,60 @@
1
+ # @dmitriikapustin/ui
2
+
3
+ Universal UI/UX Kit — React 19 component library with Atomic Design, CSS custom properties, and Tailwind CSS 4.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm install @dmitriikapustin/ui
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ ```tsx
14
+ import { Button, Input, Badge } from '@dmitriikapustin/ui';
15
+ import '@dmitriikapustin/ui/styles.css';
16
+
17
+ export function App() {
18
+ return (
19
+ <div>
20
+ <Button variant="primary">Get Started</Button>
21
+ <Input label="Email" placeholder="you@example.com" />
22
+ <Badge color="success">Active</Badge>
23
+ </div>
24
+ );
25
+ }
26
+ ```
27
+
28
+ ## Design Tokens
29
+
30
+ All tokens are CSS custom properties. Import `@dmitriikapustin/ui/styles.css` to get:
31
+
32
+ - **Colors:** `--neutral-*`, `--brand-*`, `--color-*` (semantic)
33
+ - **Surfaces:** `--bg-*`, `--fg-*`, `--border-*` (theme-aware)
34
+ - **Typography, spacing, shadows, radii, transitions**
35
+
36
+ Dark mode activates via `[data-theme="dark"]` on `<html>`.
37
+
38
+ ## Components
39
+
40
+ ### Atoms
41
+ Button, Input, Badge, Tag, Toggle, Avatar, Spinner, Divider, MenuItem, IconButton, Logo, StatBadge, Textarea, Select, Checkbox, Radio, Link, Tooltip, Skeleton, Icons
42
+
43
+ ### Molecules
44
+ Card, FormField, SearchBar, Stat, Alert, Tabs, ChatInput, ChatMessage, TopPromo, ProfileNav, IconWithText, StampCard, PasswordInput, Breadcrumbs, Toast, Pagination, CodeInput, Modal, DropdownMenu
45
+
46
+ ### Organisms
47
+ Header, Footer, PricingCard, TestimonialCard, FeatureGrid, Sidebar, AppCard, AppTopLine, EmptyState, HeroSection, LogoCloud, StatsBar, CTASection, BentoGrid, FAQSection, ComparisonTable, PromoBento, PromoShowcase, PromoSplit, PromoTrustGrid, PromoDevicesCTA, PromoTestimonials, PromoHero, PromoPricing, PromoActionCards
48
+
49
+ ### Templates
50
+ ArticleHero, ArticleBody, ArticleHeading, ArticleFigure, ArticleTable, ArticleList, ArticleNote, ArticleChatBlock, ArticleLinkButton, ArticleFooter, ArticleLayout, LandingLayout, ArticleLineChart, ArticleBarChart, ArticleScatterChart
51
+
52
+ ## Peer Dependencies
53
+
54
+ - `react` >= 18.0.0
55
+ - `react-dom` >= 18.0.0
56
+ - `tailwindcss` >= 4.0.0 (optional, for utility classes)
57
+
58
+ ## License
59
+
60
+ MIT © Kapustin Team