Skip to content

Commit 16ac4e8

Browse files
authored
Merge pull request #56 from rtCamp/chore/readme-fix
Fix: Readme and update instructions
2 parents 70512ef + d1ac2bb commit 16ac4e8

File tree

5 files changed

+80
-14
lines changed

5 files changed

+80
-14
lines changed

GETTING-STARTED.md

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# Frappe UI React
2+
3+
Frappe UI React is a component library designed for rapid UI development using React 19 and Tailwind 4. It is inspired by the original [frappe-ui](https://github.com/frappe/frappe-ui), offering a similar aesthetic for a consistent user experience. However, we are not limited to a one-to-one port and also provide a growing collection of custom-built components to give developers more power and flexibility.
4+
5+
## Prerequisites
6+
7+
- Node.js v20
8+
- TailwindCSS v4
9+
10+
## Usage
11+
12+
```bash
13+
npm install @rtcamp/frappe-ui-react
14+
# or
15+
yarn add @rtcamp/frappe-ui-react
16+
```
17+
18+
### Now, you can use the package in the following page
19+
20+
#### index.css
21+
22+
```css
23+
@import @rtcamp/frappe-ui-react/theme.css
24+
```
25+
26+
#### app.tsx
27+
28+
```js
29+
import './index.css';
30+
import { Button } from "@rtcamp/frappe-ui-react";
31+
32+
33+
function App() {
34+
return (
35+
<div className="app-container">
36+
<Button
37+
label="Default Button"
38+
theme= "gray"
39+
size= "md"
40+
variant= "subtle" />
41+
</div>
42+
);
43+
}
44+
45+
export default App;
46+
```
47+
48+
## Under the Hood
49+
50+
- [TailwindCSS](https://github.com/tailwindlabs/tailwindcss): Utility first CSS Framework to build design system based UI.
51+
- [Headless UI](https://github.com/tailwindlabs/headlessui): Unstyled and accessible UI components.
52+
- [Radix UI](https://github.com/radix-ui/themes): Unstyled and accessible UI components.
53+
- [TipTap](https://github.com/ueberdosis/tiptap): ProseMirror based rich-text editor with a Vue API.
54+
- [dayjs](https://github.com/iamkun/dayjs): Minimal javascript library for working with dates.
55+
56+
## Does this interest you?
57+
58+
<a href="https://rtcamp.com/"><img src="https://rtcamp.com/wp-content/uploads/sites/2/2019/04/github-banner@2x.png" alt="Join us at rtCamp, we specialize in providing high performance enterprise WordPress solutions"></a>

README.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,3 @@
1-
[![Tests](https://img.shields.io/badge/tests-passing-brightgreen)](#)
2-
[![Build](https://img.shields.io/badge/build-passing-brightgreen?logo=githubactions)](#)
3-
[![ESLint](https://img.shields.io/badge/code%20style-eslint-4B32C3?logo=eslint)](#)
4-
[![Prettier](https://img.shields.io/badge/code%20style-prettier-ff69b4?logo=prettier)](#)
5-
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
6-
71
# Frappe UI React
82

93
Frappe UI React is a component library designed for rapid UI development using React 19 and Tailwind 4. It is inspired by the original [frappe-ui](https://github.com/frappe/frappe-ui), offering a similar aesthetic for a consistent user experience. However, we are not limited to a one-to-one port and also provide a growing collection of custom-built components to give developers more power and flexibility.
@@ -16,15 +10,25 @@ Frappe UI React is a component library designed for rapid UI development using R
1610
## Usage
1711

1812
```bash
19-
npm install @frappe-ui-react/frappe-ui-react
13+
npm install @rtcamp/frappe-ui-react
2014
# or
21-
yarn add @frappe-ui-react/frappe-ui-react
15+
yarn add @rtcamp/frappe-ui-react
2216
```
2317

24-
Now, import the required components in your React app:
18+
### Now, you can use the package in the following page
19+
20+
#### index.css
21+
22+
```css
23+
@import @rtcamp/frappe-ui-react/theme.css
24+
```
25+
26+
#### app.tsx
2527

2628
```js
27-
import { Button } from "@frappe-ui-react/frappe-ui-react";
29+
import './index.css';
30+
import { Button } from "@rtcamp/frappe-ui-react";
31+
2832

2933
function App() {
3034
return (
@@ -49,7 +53,6 @@ export default App;
4953
- [TipTap](https://github.com/ueberdosis/tiptap): ProseMirror based rich-text editor with a Vue API.
5054
- [dayjs](https://github.com/iamkun/dayjs): Minimal javascript library for working with dates.
5155

52-
5356
## Does this interest you?
5457

5558
<a href="https://rtcamp.com/"><img src="https://rtcamp.com/wp-content/uploads/sites/2/2019/04/github-banner@2x.png" alt="Join us at rtCamp, we specialize in providing high performance enterprise WordPress solutions"></a>

README.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
import { Meta, Markdown } from '@storybook/addon-docs/blocks';
2-
import README from './README.md?raw';
2+
import GETTINGSTARTED from './GETTING-STARTED.md?raw';
33

44
<Meta title="Getting Started" />
55

66
# Getting Started
77

8-
<Markdown>{README}</Markdown>
8+
<Markdown>{GETTINGSTARTED}</Markdown>

packages/frappe-ui-react/package.json

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,9 @@
1818
"import": "./dist/index.js",
1919
"require": "./dist/index.js",
2020
"types": "./dist-types/index.d.ts"
21-
}
21+
},
22+
"./theme.css": "./src/theme.css",
23+
"./tailwind/preset": "./src/utils/tailwind.config.js"
2224
},
2325
"scripts": {
2426
"build": "tsc -b",
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
import preset from '../../../../tailwind.config.cjs'
2+
3+
export default preset;

0 commit comments

Comments
 (0)