@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 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
@@ -1,2 +1 @@
1
- export * from './src/index'
2
1
  export {}