@cyberbloxai/ui-kit 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 +51 -48
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,73 +1,76 @@
|
|
|
1
|
-
#
|
|
1
|
+
# CyberBlox UI Kit
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Production-ready component library built with Radix UI and Tailwind CSS, developed by **Abhishek John Charan**.
|
|
4
4
|
|
|
5
|
-
**
|
|
5
|
+
**Live Preview**: [https://ui.cyberbloxai.in/](https://ui.cyberbloxai.in/)
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Overview
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
CyberBlox UI Kit is a modular, themeable component library designed for building SaaS applications faster. It includes production-grade components for authentication flows, dashboards, notifications, error pages, and more.
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
## Key Features
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
- **Type-Safe**: Full TypeScript support with proper generics and inference.
|
|
14
|
+
- **Accessible**: WCAG compliant with proper ARIA labels and keyboard navigation.
|
|
15
|
+
- **Themeable**: Easy customization using CSS variables and design tokens.
|
|
16
|
+
- **Responsive**: Mobile-first design that looks great on every screen.
|
|
17
|
+
- **Modular**: Tree-shakeable by default—import only what you need.
|
|
14
18
|
|
|
15
|
-
|
|
19
|
+
## Installation
|
|
16
20
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
The only requirement is having Node.js & npm installed - [install with nvm](https://github.com/nvm-sh/nvm#installing-and-updating)
|
|
22
|
-
|
|
23
|
-
Follow these steps:
|
|
24
|
-
|
|
25
|
-
```sh
|
|
26
|
-
# Step 1: Clone the repository using the project's Git URL.
|
|
27
|
-
git clone <YOUR_GIT_URL>
|
|
21
|
+
```bash
|
|
22
|
+
npm install @cyberbloxai/ui-kit
|
|
23
|
+
```
|
|
28
24
|
|
|
29
|
-
|
|
30
|
-
cd <YOUR_PROJECT_NAME>
|
|
25
|
+
## Quick Start
|
|
31
26
|
|
|
32
|
-
|
|
33
|
-
npm i
|
|
27
|
+
1. **Import Styles**: Add the CSS to your main entry file (e.g., `main.tsx` or `App.tsx`):
|
|
34
28
|
|
|
35
|
-
|
|
36
|
-
|
|
29
|
+
```tsx
|
|
30
|
+
import "@cyberbloxai/ui-kit/styles.css";
|
|
37
31
|
```
|
|
38
32
|
|
|
39
|
-
**
|
|
33
|
+
2. **Use Components**:
|
|
40
34
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
- Make your changes and commit the changes.
|
|
35
|
+
```tsx
|
|
36
|
+
import { Button } from "@cyberbloxai/ui-kit";
|
|
44
37
|
|
|
45
|
-
|
|
38
|
+
function App() {
|
|
39
|
+
return (
|
|
40
|
+
<Button variant="default" onClick={() => console.log("Clicked!")}>
|
|
41
|
+
Click Me
|
|
42
|
+
</Button>
|
|
43
|
+
);
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
46
|
|
|
47
|
-
|
|
48
|
-
- Click on the "Code" button (green button) near the top right.
|
|
49
|
-
- Select the "Codespaces" tab.
|
|
50
|
-
- Click on "New codespace" to launch a new Codespace environment.
|
|
51
|
-
- Edit files directly within the Codespace and commit and push your changes once you're done.
|
|
47
|
+
## Technologies Used
|
|
52
48
|
|
|
53
|
-
|
|
49
|
+
- **Vite**: Next-generation frontend tooling.
|
|
50
|
+
- **TypeScript**: Static typing for better developer experience.
|
|
51
|
+
- **React**: For building user interfaces.
|
|
52
|
+
- **Radix UI**: Unstyled, accessible UI primitives.
|
|
53
|
+
- **Tailwind CSS**: Utility-first CSS framework.
|
|
54
|
+
- **Lucide React**: Beautiful & consistent icons.
|
|
54
55
|
|
|
55
|
-
|
|
56
|
+
## Development
|
|
56
57
|
|
|
57
|
-
|
|
58
|
-
- TypeScript
|
|
59
|
-
- React
|
|
60
|
-
- shadcn-ui
|
|
61
|
-
- Tailwind CSS
|
|
58
|
+
If you want to contribute or run the project locally:
|
|
62
59
|
|
|
63
|
-
|
|
60
|
+
```bash
|
|
61
|
+
# Clone the repository
|
|
62
|
+
git clone https://github.com/abhishekjohn1507/uni-kit-forge.git
|
|
64
63
|
|
|
65
|
-
|
|
64
|
+
# Install dependencies
|
|
65
|
+
npm install
|
|
66
66
|
|
|
67
|
-
|
|
67
|
+
# Start development server
|
|
68
|
+
npm run dev
|
|
68
69
|
|
|
69
|
-
|
|
70
|
+
# Build the library
|
|
71
|
+
npm run build:lib
|
|
72
|
+
```
|
|
70
73
|
|
|
71
|
-
|
|
74
|
+
## License
|
|
72
75
|
|
|
73
|
-
|
|
76
|
+
Created by [Abhishek John Charan](https://github.com/abhishekjohn1507).
|