Skip to content

Commit ef6348d

Browse files
published
1 parent b7e8b8f commit ef6348d

4 files changed

Lines changed: 92 additions & 4 deletions

File tree

README.md

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,79 @@
11
# CrapUi
2+
3+
A small, lightweight collection of React UI building blocks and a Vite starter template for quickly prototyping interfaces.
4+
5+
## Quick Start
6+
7+
Create a new project with one command:
8+
9+
```bash
10+
npx crap-ui my-app
11+
cd my-app
12+
npm run dev
13+
```
14+
15+
That's it! Your Vite + React + Tailwind project is ready.
16+
17+
## Manual Installation
18+
19+
- **Prerequisites**: Node.js `>=16` and `npm` (or `pnpm` / `yarn`).
20+
- **Clone the repository**:
21+
22+
```bash
23+
git clone https://github.com/mehediScriptDev/CrapUi.git
24+
cd CrapUi
25+
```
26+
27+
- **Install dependencies**:
28+
29+
```bash
30+
npm install
31+
# or: pnpm install
32+
```
33+
34+
**Project Setup**
35+
36+
- **Run the development server**:
37+
38+
```bash
39+
npm run dev
40+
# opens local dev server (Vite)
41+
```
42+
43+
- **Build for production**:
44+
45+
```bash
46+
npm run build
47+
```
48+
49+
- **Preview the production build locally**:
50+
51+
```bash
52+
npm run preview
53+
```
54+
55+
- **Quick-start from the template**: the `templates/basic` folder contains a ready-to-use Vite + React setup. To create a new project from the template:
56+
57+
```bash
58+
cp -R templates/basic my-new-project
59+
cd my-new-project
60+
npm install
61+
npm run dev
62+
```
63+
64+
- **Key paths**:
65+
- `src/` — application source files
66+
- `src/Components/` — example UI components (buttons, layout helpers, etc.)
67+
- `templates/basic/` — standalone starter template you can copy or adapt
68+
69+
**Benefits**
70+
71+
- **Fast development**: Vite-based setup gives near-instant hot reload and minimal setup time.
72+
- **Ready examples**: example components live in `src/Components` so you can reuse or extend them.
73+
- **Template-driven**: `templates/basic` is a drop-in starter for new projects — copy and go.
74+
- **Small and flexible**: minimal opinionated glue so you can add your preferred styling system easily.
75+
76+
If you want, I can add a short example showing how to import and use a component from `src/Components` in `src/App.jsx`.
77+
# CrapUi
278
A small collection of React + Tailwind components I build daily...simple and reusable.
379
<img src="crapui.jpg"/>

bin/create.cjs

100644100755
File mode changed.

package.json

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,20 @@
11
{
22
"name": "crap-ui",
33
"private": false,
4-
"version": "0.1.0",
4+
"version": "1.0.0",
55
"type": "module",
6+
"description": "A lightweight Vite + React + Tailwind starter template",
7+
"keywords": ["react", "vite", "tailwind", "template", "starter", "scaffold", "boilerplate"],
8+
"author": "Mehedi",
9+
"license": "MIT",
10+
"repository": {
11+
"type": "git",
12+
"url": "https://github.com/mehediScriptDev/CrapUi.git"
13+
},
14+
"bugs": {
15+
"url": "https://github.com/mehediScriptDev/CrapUi/issues"
16+
},
17+
"homepage": "https://github.com/mehediScriptDev/CrapUi#readme",
618
"scripts": {
719
"dev": "vite",
820
"build": "vite build",

templates/basic/src/App.jsx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -58,14 +58,14 @@ function App() {
5858

5959
{/* GitHub Call-to-Action */}
6060
<div className="mt-8 flex flex-col items-center justify-center gap-3 text-gray-800 text-lg">
61-
<p className="font-medium">
61+
<p className="font-medium text-xs text-gray-500">
6262
If you like this project, consider starring it on GitHub.
6363
</p>
64-
<p className="-mt-4 font-medium">Found an issue? Please report it.</p>
64+
<p className="-mt-4 font-medium text-xs text-gray-500">Found an issue? Please report it.</p>
6565
<Link
6666
target="_blank"
6767
to={"https://github.com/mehediScriptDev/CrapUi"}
68-
className="inline-flex items-center gap-2 bg-gray-600 justify-center text-white px-4 py-1 rounded-md transition-colors duration-200 "
68+
className="inline-flex items-center gap-2 bg-gray-500 justify-center text-white px-4 py-1 rounded-md transition-colors duration-200 "
6969
>
7070
<FaGithub className="w-5 h-5" />
7171
<span>Star</span>

0 commit comments

Comments
 (0)