Skip to content

Commit 4b3b771

Browse files
committed
📝 Added installation documentation
1 parent 2d64bd5 commit 4b3b771

File tree

2 files changed

+179
-1
lines changed

2 files changed

+179
-1
lines changed

README.md

Lines changed: 179 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,179 @@
1+
# Brixi UI
2+
3+
A sleek & slender design system built on web components.
4+
5+
## Installation
6+
7+
Install the NPM packages.
8+
9+
```
10+
npm i -D brixi-ui
11+
```
12+
13+
Install peer dependencies.
14+
15+
```
16+
npm i -D flatpickr@4 fuse.js@6 tooltipper@1 @codewithkyle/modal-make@1 @codewithkyle/notifyjs@3 @codewithkyle/pubsub@1 @codewithkyle/router@1 @codewithkyle/supercomponent@1 @codewithkyle/uuid@1 brixi@latest dayjs@1 lit-html@1
17+
```
18+
19+
Create the install scripts.
20+
21+
```
22+
"install:ui": "install-ui --audio=./public/audio --framework=./src/framework",
23+
"install:brixi": "brixi"
24+
```
25+
26+
Install UI components.
27+
28+
```
29+
npm run install:ui
30+
```
31+
32+
Configure Brixi CSS.
33+
34+
```javascript
35+
// brixi.config.js
36+
module.exports = {
37+
outDir: "./brixi",
38+
important: true,
39+
output: "production",
40+
colors: {
41+
white: "#ffffff",
42+
black: "#000000",
43+
grey: {
44+
50: "#FAFAFA",
45+
100: "#F4F4F5",
46+
200: "#E4E4E7",
47+
300: "#D4D4D8",
48+
400: "#A1A1AA",
49+
500: "#71717A",
50+
600: "#52525B",
51+
700: "#3F3F46",
52+
800: "#27272A",
53+
900: "#18181B",
54+
},
55+
neutral: {
56+
50: "#FAFAFA",
57+
100: "#F5F5F5",
58+
200: "#E5E5E5",
59+
300: "#D4D4D4",
60+
400: "#A3A3A3",
61+
500: "#737373",
62+
600: "#525252",
63+
700: "#404040",
64+
800: "#262626",
65+
900: "#171717",
66+
},
67+
primary: {
68+
50: "#EFF6FF",
69+
100: "#DBEAFE",
70+
200: "#BFDBFE",
71+
300: "#93C5FD",
72+
400: "#60A5FA",
73+
500: "#3B82F6",
74+
600: "#2563EB",
75+
700: "#1D4ED8",
76+
800: "#1E40AF",
77+
900: "#1E3A8A",
78+
},
79+
info: {
80+
50: "#EFF6FF",
81+
100: "#DBEAFE",
82+
200: "#BFDBFE",
83+
300: "#93C5FD",
84+
400: "#60A5FA",
85+
500: "#3B82F6",
86+
600: "#2563EB",
87+
700: "#1D4ED8",
88+
800: "#1E40AF",
89+
900: "#1E3A8A",
90+
},
91+
success: {
92+
50: "#ECFDF5",
93+
100: "#D1FAE5",
94+
200: "#A7F3D0",
95+
300: "#6EE7B7",
96+
400: "#34D399",
97+
500: "#10B981",
98+
600: "#059669",
99+
700: "#047857",
100+
800: "#065F46",
101+
900: "#064E3B",
102+
},
103+
danger: {
104+
50: "#FFF1F2",
105+
100: "#FFE4E6",
106+
200: "#FECDD3",
107+
300: "#FDA4AF",
108+
400: "#FB7185",
109+
500: "#F43F5E",
110+
600: "#E11D48",
111+
700: "#BE123C",
112+
800: "#9F1239",
113+
900: "#881337",
114+
},
115+
warning: {
116+
50: "#FFFBEB",
117+
100: "#FEF3C7",
118+
200: "#FDE68A",
119+
300: "#FCD34D",
120+
400: "#FBBF24",
121+
500: "#F59E0B",
122+
600: "#D97706",
123+
700: "#B45309",
124+
800: "#92400E",
125+
900: "#78350F",
126+
},
127+
},
128+
borders: {
129+
units: "px",
130+
styles: ["solid"],
131+
widths: [1],
132+
radius: [0.125, 0.25, 0.5],
133+
},
134+
variables: {
135+
"focus-ring": "inset 0 0 0 2px var(--white), 0 0 0 1px var(--black)",
136+
bevel: "inset 0 -1px 1px hsl(0deg 0% 50% / 0.5), 0 0px 1px hsl(0deg 0% 50% / 0.25), 0 1px 1px hsl(0deg 0% 50% / 0.25)",
137+
"light-bevel": "0 1px 0 hsl(0deg 0% 50% / 0.1), inset 0 -1px 1px hsl(0deg 0% 50% / 0.15)",
138+
"primary-opaque-hover": "rgba(14,165,233,0.05)",
139+
"primary-opaque-active": "rgba(14,165,233,0.1)",
140+
},
141+
shadows: {
142+
colors: {
143+
grey: "0deg 0% 50%",
144+
},
145+
sizes: {
146+
sm: `
147+
0px 1px 2px hsl(var(--shadow-color) / 0.7)
148+
`,
149+
md: `
150+
0px 2px 2px hsl(var(--shadow-color) / 0.333),
151+
0px 4px 4px hsl(var(--shadow-color) / 0.333),
152+
0px 6px 6px hsl(var(--shadow-color) / 0.333)
153+
`,
154+
lg: `
155+
0px 2px 2px hsl(var(--shadow-color) / 0.2),
156+
0px 4px 4px hsl(var(--shadow-color) / 0.2),
157+
0px 8px 8px hsl(var(--shadow-color) / 0.2),
158+
0px 16px 16px hsl(var(--shadow-color) / 0.2),
159+
0px 32px 32px hsl(var(--shadow-color) / 0.2)
160+
`,
161+
xl: `
162+
0px 2px 2px hsl(var(--shadow-color) / 0.2),
163+
0px 4px 4px hsl(var(--shadow-color) / 0.2),
164+
0px 8px 8px hsl(var(--shadow-color) / 0.2),
165+
0px 16px 16px hsl(var(--shadow-color) / 0.2),
166+
0px 32px 32px hsl(var(--shadow-color) / 0.2),
167+
0px 48px 48px hsl(var(--shadow-color) / 0.2),
168+
0px 64px 64px hsl(var(--shadow-color) / 0.2)
169+
`,
170+
},
171+
},
172+
};
173+
```
174+
175+
Compile Brixi CSS.
176+
177+
```
178+
npm run install:brixi
179+
```

package.json

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,6 @@
9292
"flatpickr": "4.x",
9393
"fuse.js": "6.x",
9494
"tooltipper": "1.x",
95-
"@codewithkyle/asset-manager": "1.x",
9695
"@codewithkyle/messaging": "1.x",
9796
"@codewithkyle/modal-maker": "1.x",
9897
"@codewithkyle/notifyjs": "3.x",

0 commit comments

Comments
 (0)