sander-ui 0.1.0 โ 0.1.1
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 +36 -55
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,14 +1,40 @@
|
|
|
1
1
|
# ๐งฉ sander-ui
|
|
2
2
|
|
|
3
|
-
A modern React component library built with TypeScript and CSS Modules.
|
|
3
|
+
A modern React component library built with TypeScript and CSS Modules.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
**[๐ Live Storybook Docs](https://n8n-sander-ui.igjw7r.easypanel.host)**
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
7
|
+
## ๐ฆ Installation
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install sander-ui
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
**Peer dependencies:** React 18 or 19
|
|
14
|
+
|
|
15
|
+
## ๐ Usage
|
|
16
|
+
|
|
17
|
+
Import components and the stylesheet:
|
|
18
|
+
|
|
19
|
+
```tsx
|
|
20
|
+
import { Button, Input, Modal } from "sander-ui";
|
|
21
|
+
import "sander-ui/styles.css";
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Use them in your app:
|
|
25
|
+
|
|
26
|
+
```tsx
|
|
27
|
+
function App() {
|
|
28
|
+
return (
|
|
29
|
+
<div>
|
|
30
|
+
<Button variant="primary" size="md" onClick={() => alert("Clicked!")}>
|
|
31
|
+
Click me
|
|
32
|
+
</Button>
|
|
33
|
+
<Input label="Email" placeholder="you@example.com" />
|
|
34
|
+
</div>
|
|
35
|
+
);
|
|
36
|
+
}
|
|
37
|
+
```
|
|
12
38
|
|
|
13
39
|
## ๐๏ธ Components
|
|
14
40
|
|
|
@@ -27,56 +53,11 @@ A modern React component library built with TypeScript and CSS Modules. Designed
|
|
|
27
53
|
### ๐ Layout
|
|
28
54
|
`Card` ยท `Modal` ยท `Drawer`
|
|
29
55
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
npm install
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
### ๐ ๏ธ Development
|
|
37
|
-
|
|
38
|
-
```bash
|
|
39
|
-
npm run storybook
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
Opens Storybook at [http://localhost:6006](http://localhost:6006) with live-reloading, interactive examples, and full prop documentation for every component.
|
|
43
|
-
|
|
44
|
-
### ๐ฆ Build
|
|
45
|
-
|
|
46
|
-
```bash
|
|
47
|
-
npm run build-storybook
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
Outputs a static documentation site to `storybook-static/`.
|
|
51
|
-
|
|
52
|
-
## ๐ณ Deployment
|
|
53
|
-
|
|
54
|
-
A multi-stage `Dockerfile` is included for deploying the Storybook docs site:
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
docker build -t sander-ui .
|
|
58
|
-
docker run -p 80:80 sander-ui
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
Compatible with EasyPanel, Railway, Fly.io, or any Docker-based hosting.
|
|
62
|
-
|
|
63
|
-
## ๐๏ธ Design Tokens
|
|
64
|
-
|
|
65
|
-
All visual decisions are centralized in CSS custom properties (`src/styles/_tokens.css`):
|
|
66
|
-
|
|
67
|
-
- **Colors** โ primary, semantic (success, error, warning, info), and a full gray scale
|
|
68
|
-
- **Typography** โ [Outfit](https://fonts.google.com/specimen/Outfit) font family with consistent size and weight scales
|
|
69
|
-
- **Spacing** โ a harmonious spacing scale from `0.125rem` to `3rem`
|
|
70
|
-
- **Radii, shadows, transitions** โ shared across all components
|
|
56
|
+
Browse all components with interactive examples and full prop documentation at the **[๐ Storybook](https://n8n-sander-ui.igjw7r.easypanel.host)**.
|
|
71
57
|
|
|
72
|
-
##
|
|
58
|
+
## ๐จ Design Tokens
|
|
73
59
|
|
|
74
|
-
|
|
75
|
-
- [Vite](https://vite.dev)
|
|
76
|
-
- [CSS Modules](https://github.com/css-modules/css-modules)
|
|
77
|
-
- [Storybook](https://storybook.js.org)
|
|
78
|
-
- [Lucide](https://lucide.dev) icons
|
|
79
|
-
- [classnames](https://github.com/JedWatson/classnames)
|
|
60
|
+
All visual decisions are centralized in CSS custom properties (`src/styles/_tokens.css`) covering colors, typography ([Outfit](https://fonts.google.com/specimen/Outfit)), spacing, radii, shadows, and transitions.
|
|
80
61
|
|
|
81
62
|
## ๐ License
|
|
82
63
|
|