@iniguezmarc/design-system 0.0.3 → 0.0.7
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 +75 -75
- package/dist/index.d.ts +0 -1
- package/dist/index.es.js +662 -492
- package/dist/index.umd.js +102 -82
- package/dist/llms.txt +42 -0
- package/package.json +64 -64
- package/dist/src/components/atoms/ThemeToggle/ThemeToggle.d.ts +0 -15
- package/dist/src/components/molecules/ProjectCard/ProjectCard.d.ts +0 -29
- package/dist/src/components/organisms/Navbar/Navbar.d.ts +0 -25
- package/dist/src/index.d.ts +0 -11
package/README.md
CHANGED
|
@@ -1,76 +1,76 @@
|
|
|
1
|
-
# 🎨 Design System
|
|
2
|
-
|
|
3
|
-
A modern, scalable, and accessible UI component library built to streamline frontend development.
|
|
4
|
-
|
|
5
|
-
🚀 **[View Documentation (Storybook)](https://IniguezMarc.github.io/design-system/)**
|
|
6
|
-
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## 🛠 Tech Stack & Tools
|
|
10
|
-
|
|
11
|
-
This project leverages a modern ecosystem to ensure performance, type safety, and developer experience:
|
|
12
|
-
|
|
13
|
-
* **⚛️ React 18:** Library for building the component-based UI architecture.
|
|
14
|
-
* **📘 TypeScript:** Provides static typing to catch errors early and improve code maintainability.
|
|
15
|
-
* **⚡ Vite:** Next-generation frontend tooling for ultra-fast development and optimized builds.
|
|
16
|
-
* **💨 Tailwind CSS (v3):** A utility-first CSS framework for rapid, responsive, and consistent styling without leaving the HTML.
|
|
17
|
-
* **📕 Storybook:** An isolated environment to build, test, and document UI components independently from the main app.
|
|
18
|
-
* **🚀 GitHub Pages:** Automated hosting for the static documentation via CI/CD pipelines.
|
|
19
|
-
|
|
20
|
-
## 🏗 Architecture: Atomic Design
|
|
21
|
-
|
|
22
|
-
The library is organized following the **Atomic Design** methodology to ensure modularity:
|
|
23
|
-
|
|
24
|
-
* **Atoms:** Basic building blocks (Buttons, Inputs, Typography).
|
|
25
|
-
* **Molecules:** Groups of atoms functioning together (Project Cards, Form Groups).
|
|
26
|
-
* **Organisms:** Complex UI sections (Responsive Grids, Navbars).
|
|
27
|
-
|
|
28
|
-
## 📦 Local Installation
|
|
29
|
-
|
|
30
|
-
To clone and run this project on your local machine:
|
|
31
|
-
|
|
32
|
-
1. **Clone the repository:**
|
|
33
|
-
```bash
|
|
34
|
-
git clone [https://github.com/IniguezMarc/design-system.git](https://github.com/IniguezMarc/design-system.git)
|
|
35
|
-
cd design-system
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
2. **Install dependencies:**
|
|
39
|
-
```bash
|
|
40
|
-
npm install
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
3. **Start Storybook:**
|
|
44
|
-
```bash
|
|
45
|
-
npm run storybook
|
|
46
|
-
```
|
|
47
|
-
npm run storybook
|
|
48
|
-
```
|
|
49
|
-
Visit `http://localhost:6006` to view the library.
|
|
50
|
-
|
|
51
|
-
## 📦 Usage as a Package
|
|
52
|
-
|
|
53
|
-
1. **Install the package:**
|
|
54
|
-
```bash
|
|
55
|
-
npm install @iniguezmarc/design-system
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
2. **Import styles:**
|
|
59
|
-
Import the CSS in your main entry file (e.g., `main.tsx` or `App.tsx`):
|
|
60
|
-
```tsx
|
|
61
|
-
import '@iniguezmarc/design-system/dist/style.css'; // Adjust path if needed based on build output
|
|
62
|
-
```
|
|
63
|
-
*Note: If `style.css` is not generated, ensure Tailwind is configured to scan node_modules or exported correctly.*
|
|
64
|
-
|
|
65
|
-
3. **Use components:**
|
|
66
|
-
```tsx
|
|
67
|
-
import { Button } from '@iniguezmarc/design-system';
|
|
68
|
-
|
|
69
|
-
function App() {
|
|
70
|
-
return <Button label="Click Me" />;
|
|
71
|
-
}
|
|
72
|
-
```
|
|
73
|
-
|
|
74
|
-
---
|
|
75
|
-
|
|
1
|
+
# 🎨 Design System
|
|
2
|
+
|
|
3
|
+
A modern, scalable, and accessible UI component library built to streamline frontend development.
|
|
4
|
+
|
|
5
|
+
🚀 **[View Documentation (Storybook)](https://IniguezMarc.github.io/design-system/)**
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 🛠 Tech Stack & Tools
|
|
10
|
+
|
|
11
|
+
This project leverages a modern ecosystem to ensure performance, type safety, and developer experience:
|
|
12
|
+
|
|
13
|
+
* **⚛️ React 18:** Library for building the component-based UI architecture.
|
|
14
|
+
* **📘 TypeScript:** Provides static typing to catch errors early and improve code maintainability.
|
|
15
|
+
* **⚡ Vite:** Next-generation frontend tooling for ultra-fast development and optimized builds.
|
|
16
|
+
* **💨 Tailwind CSS (v3):** A utility-first CSS framework for rapid, responsive, and consistent styling without leaving the HTML.
|
|
17
|
+
* **📕 Storybook:** An isolated environment to build, test, and document UI components independently from the main app.
|
|
18
|
+
* **🚀 GitHub Pages:** Automated hosting for the static documentation via CI/CD pipelines.
|
|
19
|
+
|
|
20
|
+
## 🏗 Architecture: Atomic Design
|
|
21
|
+
|
|
22
|
+
The library is organized following the **Atomic Design** methodology to ensure modularity:
|
|
23
|
+
|
|
24
|
+
* **Atoms:** Basic building blocks (Buttons, Inputs, Typography).
|
|
25
|
+
* **Molecules:** Groups of atoms functioning together (Project Cards, Form Groups).
|
|
26
|
+
* **Organisms:** Complex UI sections (Responsive Grids, Navbars).
|
|
27
|
+
|
|
28
|
+
## 📦 Local Installation
|
|
29
|
+
|
|
30
|
+
To clone and run this project on your local machine:
|
|
31
|
+
|
|
32
|
+
1. **Clone the repository:**
|
|
33
|
+
```bash
|
|
34
|
+
git clone [https://github.com/IniguezMarc/design-system.git](https://github.com/IniguezMarc/design-system.git)
|
|
35
|
+
cd design-system
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
2. **Install dependencies:**
|
|
39
|
+
```bash
|
|
40
|
+
npm install
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
3. **Start Storybook:**
|
|
44
|
+
```bash
|
|
45
|
+
npm run storybook
|
|
46
|
+
```
|
|
47
|
+
npm run storybook
|
|
48
|
+
```
|
|
49
|
+
Visit `http://localhost:6006` to view the library.
|
|
50
|
+
|
|
51
|
+
## 📦 Usage as a Package
|
|
52
|
+
|
|
53
|
+
1. **Install the package:**
|
|
54
|
+
```bash
|
|
55
|
+
npm install @iniguezmarc/design-system
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
2. **Import styles:**
|
|
59
|
+
Import the CSS in your main entry file (e.g., `main.tsx` or `App.tsx`):
|
|
60
|
+
```tsx
|
|
61
|
+
import '@iniguezmarc/design-system/dist/style.css'; // Adjust path if needed based on build output
|
|
62
|
+
```
|
|
63
|
+
*Note: If `style.css` is not generated, ensure Tailwind is configured to scan node_modules or exported correctly.*
|
|
64
|
+
|
|
65
|
+
3. **Use components:**
|
|
66
|
+
```tsx
|
|
67
|
+
import { Button } from '@iniguezmarc/design-system';
|
|
68
|
+
|
|
69
|
+
function App() {
|
|
70
|
+
return <Button label="Click Me" />;
|
|
71
|
+
}
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
76
|
Created by **Marc Iñiguez**.
|
package/dist/index.d.ts
CHANGED