@colorffy/ui 1.0.2 → 1.0.3
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/LICENSE +21 -0
- package/README.md +52 -42
- package/package.json +2 -2
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Giancarlos Garza
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,20 +1,24 @@
|
|
|
1
1
|
# @colorffy/ui
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://www.npmjs.com/package/@colorffy/ui)
|
|
4
|
+
[](https://packagephobia.com/result?p=@colorffy/ui)
|
|
5
|
+
[](https://github.com/giancarlosgza/colorffy-ui/blob/main/packages/ColorffyCSS/LICENSE)
|
|
4
6
|
|
|
5
|
-
|
|
7
|
+
A modern Nuxt / Vue 3 component library built with TypeScript. Features a comprehensive collection of **unstyled, headless UI components** with full TypeScript support. Designed to work seamlessly with **Colorffy CSS** (optional) or your own custom styles.
|
|
6
8
|
|
|
7
|
-
✨
|
|
8
|
-
🎨 **Style-Agnostic** - Use with ColorffyCSS or bring your own styles
|
|
9
|
-
📘 **Full TypeScript Support** - Complete type definitions for all components
|
|
10
|
-
🔌 **Flexible Installation** - Use globally or import individually
|
|
11
|
-
🚀 **Tree-shakeable** - Import only what you need
|
|
12
|
-
⚡ **Nuxt 3 Compatible** - Works seamlessly with Nuxt applications
|
|
13
|
-
🎯 **Headless Architecture** - Full control over styling and behavior
|
|
9
|
+
## ✨ Features
|
|
14
10
|
|
|
15
|
-
|
|
11
|
+
- ✨ **70+ Vue 3 Components** - Accordion, Alerts, Buttons, Cards, Dialogs, Forms, Navigation, and more
|
|
12
|
+
- 🎨 **Style-Agnostic** - Use with Colorffy CSS or bring your own styles
|
|
13
|
+
- 📘 **Full TypeScript Support** - Complete type definitions for all components
|
|
14
|
+
- 🔌 **Flexible Installation** - Use globally or import individually
|
|
15
|
+
- 🚀 **Tree-shakeable** - Import only what you need
|
|
16
|
+
- ⚡ **Nuxt 3 Compatible** - Works seamlessly with Nuxt applications
|
|
17
|
+
- 🎯 **Headless Architecture** - Full control over styling and behavior
|
|
16
18
|
|
|
17
|
-
|
|
19
|
+
## 📦 Installation
|
|
20
|
+
|
|
21
|
+
### Install Colorffy UI
|
|
18
22
|
|
|
19
23
|
```bash
|
|
20
24
|
# npm
|
|
@@ -29,13 +33,13 @@ pnpm add @colorffy/ui
|
|
|
29
33
|
|
|
30
34
|
### Install Peer Dependencies
|
|
31
35
|
|
|
32
|
-
|
|
36
|
+
Colorffy UI requires the following peer dependencies:
|
|
33
37
|
|
|
34
38
|
```bash
|
|
35
39
|
npm install @vueuse/components floating-vue vue
|
|
36
40
|
```
|
|
37
41
|
|
|
38
|
-
### Install
|
|
42
|
+
### Install Colorffy CSS (Optional, Recommended)
|
|
39
43
|
|
|
40
44
|
For pre-built, beautiful styling that works out of the box:
|
|
41
45
|
|
|
@@ -43,11 +47,11 @@ For pre-built, beautiful styling that works out of the box:
|
|
|
43
47
|
npm install @colorffy/css
|
|
44
48
|
```
|
|
45
49
|
|
|
46
|
-
> **Note:**
|
|
50
|
+
> **Note:** Colorffy UI components are **unstyled by default**. You can use Colorffy CSS for instant styling, or provide your own custom styles.
|
|
47
51
|
|
|
48
|
-
## Styling Options
|
|
52
|
+
## 🎨 Styling Options
|
|
49
53
|
|
|
50
|
-
### Option 1: Use
|
|
54
|
+
### Option 1: Use Colorffy CSS (Recommended)
|
|
51
55
|
|
|
52
56
|
Import the compiled CSS in your `main.ts`:
|
|
53
57
|
|
|
@@ -62,13 +66,13 @@ app.use(ColorffyUI)
|
|
|
62
66
|
app.mount('#app')
|
|
63
67
|
```
|
|
64
68
|
|
|
65
|
-
### Option 2: Customize
|
|
69
|
+
### Option 2: Customize Colorffy CSS with SCSS
|
|
66
70
|
|
|
67
71
|
For full customization, use SCSS to override variables:
|
|
68
72
|
|
|
69
73
|
```scss
|
|
70
74
|
// src/assets/variables.scss
|
|
71
|
-
// Override
|
|
75
|
+
// Override Colorffy CSS variables
|
|
72
76
|
@forward '@colorffy/css/scss/abstracts/variables' with (
|
|
73
77
|
$primary: #4f46e5,
|
|
74
78
|
$secondary: #ec4899,
|
|
@@ -103,7 +107,7 @@ app.mount('#app')
|
|
|
103
107
|
|
|
104
108
|
### Option 3: Custom Styles
|
|
105
109
|
|
|
106
|
-
Use
|
|
110
|
+
Use Colorffy UI components without any styling framework. Components use semantic class names like `.btn`, `.card`, `.alert`, etc. that you can style however you want:
|
|
107
111
|
|
|
108
112
|
```css
|
|
109
113
|
/* your-custom-styles.css */
|
|
@@ -120,9 +124,9 @@ Use ColorffyUI components without any styling framework. Components use semantic
|
|
|
120
124
|
}
|
|
121
125
|
```
|
|
122
126
|
|
|
123
|
-
For more details on
|
|
127
|
+
For more details on Colorffy CSS customization, see the [Colorffy CSS README](https://www.npmjs.com/package/@colorffy/css).
|
|
124
128
|
|
|
125
|
-
## Usage
|
|
129
|
+
## 🚀 Usage
|
|
126
130
|
|
|
127
131
|
### Option 1: Global Registration (Recommended for most cases)
|
|
128
132
|
|
|
@@ -198,7 +202,7 @@ app.component('UiAlert', UiAlert)
|
|
|
198
202
|
app.mount('#app')
|
|
199
203
|
```
|
|
200
204
|
|
|
201
|
-
## Nuxt 3 Usage
|
|
205
|
+
## 🚀 Nuxt 3 Usage
|
|
202
206
|
|
|
203
207
|
### Install Dependencies
|
|
204
208
|
|
|
@@ -206,9 +210,9 @@ app.mount('#app')
|
|
|
206
210
|
npm install @colorffy/ui @colorffy/css
|
|
207
211
|
```
|
|
208
212
|
|
|
209
|
-
### Setup with
|
|
213
|
+
### Setup with Colorffy CSS
|
|
210
214
|
|
|
211
|
-
Add
|
|
215
|
+
Add Colorffy CSS to your `nuxt.config.ts`:
|
|
212
216
|
|
|
213
217
|
```typescript
|
|
214
218
|
export default defineNuxtConfig({
|
|
@@ -311,7 +315,7 @@ export default defineNuxtConfig({
|
|
|
311
315
|
})
|
|
312
316
|
```
|
|
313
317
|
|
|
314
|
-
## Component Categories
|
|
318
|
+
## 💻 Component Categories
|
|
315
319
|
|
|
316
320
|
### Layout Components
|
|
317
321
|
- `UiHeaderContent` - Page header with title and subtitle
|
|
@@ -394,7 +398,7 @@ export default defineNuxtConfig({
|
|
|
394
398
|
- `UiShapeLoading` - Shape loading animation
|
|
395
399
|
- `UiTableSkeleton` - Table skeleton loader
|
|
396
400
|
|
|
397
|
-
## Composables
|
|
401
|
+
## 💻 Composables
|
|
398
402
|
|
|
399
403
|
The library also exports useful composables:
|
|
400
404
|
|
|
@@ -412,7 +416,7 @@ const dateUtils = useDateUtils()
|
|
|
412
416
|
const textUtils = useTextUtils()
|
|
413
417
|
```
|
|
414
418
|
|
|
415
|
-
## Component Examples
|
|
419
|
+
## 💻 Component Examples
|
|
416
420
|
|
|
417
421
|
### Button
|
|
418
422
|
|
|
@@ -529,7 +533,7 @@ const textUtils = useTextUtils()
|
|
|
529
533
|
</template>
|
|
530
534
|
```
|
|
531
535
|
|
|
532
|
-
## TypeScript Support
|
|
536
|
+
## 🏗️ TypeScript Support
|
|
533
537
|
|
|
534
538
|
All components come with full TypeScript support. Import types as needed:
|
|
535
539
|
|
|
@@ -546,18 +550,18 @@ const variant: ButtonVariant = 'filled'
|
|
|
546
550
|
const color: ButtonColor = 'primary'
|
|
547
551
|
```
|
|
548
552
|
|
|
549
|
-
## Styling
|
|
553
|
+
## 🎨 Styling
|
|
550
554
|
|
|
551
|
-
### With
|
|
555
|
+
### With Colorffy CSS (Recommended)
|
|
552
556
|
|
|
553
|
-
|
|
557
|
+
Colorffy UI is designed to work seamlessly with Colorffy CSS, which provides:
|
|
554
558
|
- Modern, responsive design system
|
|
555
559
|
- Consistent color palette with tonal variants
|
|
556
560
|
- Pre-built component styles
|
|
557
561
|
- Utility classes for rapid development
|
|
558
562
|
- Customizable themes with SCSS variables
|
|
559
563
|
|
|
560
|
-
Install
|
|
564
|
+
Install Colorffy CSS and import it in your app:
|
|
561
565
|
|
|
562
566
|
```bash
|
|
563
567
|
npm install @colorffy/css
|
|
@@ -603,32 +607,38 @@ Override CSS custom properties for runtime theming:
|
|
|
603
607
|
}
|
|
604
608
|
```
|
|
605
609
|
|
|
606
|
-
For complete styling documentation, see the [
|
|
610
|
+
For complete styling documentation, see the [Colorffy CSS README](https://www.npmjs.com/package/@colorffy/css).
|
|
607
611
|
|
|
608
|
-
## Browser Support
|
|
612
|
+
## 🔍 Browser Support
|
|
609
613
|
|
|
610
614
|
- Chrome (latest)
|
|
611
615
|
- Firefox (latest)
|
|
612
616
|
- Safari (latest)
|
|
613
617
|
- Edge (latest)
|
|
614
618
|
|
|
615
|
-
## Contributing
|
|
619
|
+
## 🤝 Contributing
|
|
620
|
+
|
|
621
|
+
Contributions, issues, and feature requests are welcome!
|
|
616
622
|
|
|
617
|
-
|
|
623
|
+
Feel free to check the [issues page](https://github.com/giancarlosgza/colorffy-workspace/issues).
|
|
618
624
|
|
|
619
|
-
## License
|
|
625
|
+
## 📄 License
|
|
620
626
|
|
|
621
|
-
|
|
627
|
+
MIT © [Giancarlos Garza](https://github.com/giancarlosgza)
|
|
622
628
|
|
|
623
629
|
## Author
|
|
624
630
|
|
|
625
631
|
Giancarlos Garza
|
|
626
632
|
|
|
627
|
-
##
|
|
633
|
+
## ⭐ Show your support
|
|
628
634
|
|
|
629
|
-
- [
|
|
630
|
-
- [
|
|
635
|
+
- [Colorffy UI](https://www.npmjs.com/package/@colorffy/ui)
|
|
636
|
+
- [Colorffy CSS](https://www.npmjs.com/package/@colorffy/css)
|
|
637
|
+
|
|
638
|
+
Give a ⭐️ if this project helped you!
|
|
631
639
|
|
|
632
640
|
---
|
|
633
641
|
|
|
634
|
-
Made with ❤️ using Vue 3 and TypeScript
|
|
642
|
+
Made with ❤️ by [Giancarlos Garza](https://github.com/giancarlosgza) using Vue 3 and TypeScript.
|
|
643
|
+
|
|
644
|
+
Powered by [Colorffy](https://colorffy.com) 🎨
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@colorffy/ui",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.3",
|
|
4
4
|
"description": "A modern Vue 3 component library built with TypeScript and Colorffy CSS",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.cjs",
|
|
@@ -66,5 +66,5 @@
|
|
|
66
66
|
"typescript"
|
|
67
67
|
],
|
|
68
68
|
"author": "Giancarlos Garza",
|
|
69
|
-
"license": "
|
|
69
|
+
"license": "MIT"
|
|
70
70
|
}
|