Skip to content

Commit c1c3976

Browse files
committed
npm readme
1 parent faa2b0a commit c1c3976

File tree

1 file changed

+20
-136
lines changed

1 file changed

+20
-136
lines changed

frui/README.md

Lines changed: 20 additions & 136 deletions
Original file line numberDiff line numberDiff line change
@@ -1,145 +1,29 @@
1-
<p align="center">
2-
<img src="https://github.com/cblanquera/frui/assets/120378/cef637e2-ef31-429d-b8a5-35c32ce00752" />
3-
</p>
4-
5-
# Free React UI (FRUI)
6-
7-
A collection of vanilla react and tailwind components, fields and
8-
output formats written in typescript.
9-
10-
Checkout the [Examples](https://ossphilippines.github.io/frui)
1+
<div align="center">
2+
<img src="https://ossphilippines.github.io/frui/frui-icon.png" width="100" />
3+
<h1>Free React UI (FRUI)</h1>
4+
<a href="https://www.npmjs.com/package/frui"><img src="https://img.shields.io/npm/v/frui.svg?style=flat" /></a>
5+
<a href="https://github.com/OSSPhilippines/frui/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" /></a>
6+
<a href="https://github.com/OSSPhilippines/frui/commits/main/"><img src="https://img.shields.io/github/last-commit/OSSPhilippines/frui" /></a>
7+
<a href="https://github.com/OSSPhilippines/frui/blob/main/README.md#contributing"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" /></a>
8+
<br />
9+
<br />
10+
<a href="https://ossphilippines.github.io/frui/">Documentation</a>
11+
<br />
12+
<hr />
13+
</div>
14+
15+
## JUST REACT COMPONENTS
16+
17+
No layouts, no grids, no themes, no style engine, no design system.
18+
FRUI offers a comprehensive suite of free react components to use
19+
without the commitments. Checkout the [Examples](https://ossphilippines.github.io/frui)
1120

1221
## Install
1322

1423
```bash
1524
$ npm install frui
1625
```
1726

18-
## React Usage
19-
20-
`frui` was written first in vanilla react with no other dependencies.
21-
You can start importing components like the following.
22-
23-
```js
24-
import { Loader, fields, formats } from 'frui';
25-
const { Datetime } = fields;
26-
const { Overflow } = formats;
27-
//or
28-
import { Alert, Badge } from 'frui-react';
29-
import { Input, Password } from 'frui-react/fields';
30-
import { HTML, Markdown } from 'frui-react/formats';
31-
//or
32-
import Table, { Thead, Trow, Tcol } from 'frui-react/Table';
33-
import Select from 'frui-react/fields/Select';
34-
import Email from 'frui-react/formats/Email';
35-
```
36-
37-
## Tailwind Setup
38-
39-
After you install `frui`, open `tailwind.config.js` and add the `frui`
40-
location in the `content` section.
41-
42-
```js
43-
/** @type {import('tailwindcss').Config} */
44-
module.exports = {
45-
content: [
46-
//...
47-
'./node_modules/frui-tailwind/**/*.{jsx,tsx}'
48-
//...
49-
],
50-
//...
51-
}
52-
```
53-
54-
## Tailwind Usage
55-
56-
Tailwind components in `frui` has also been written from the ground up
57-
and you can importing components like the following.
58-
59-
```js
60-
import { Alert, Badge } from 'frui-tailwind';
61-
import { Input, Password } from 'frui-tailwind/fields';
62-
import { HTML, Markdown } from 'frui-tailwind/formats';
63-
//or
64-
import Table, { Thead, Trow, Tcol } from 'frui-react/Table';
65-
import Select from 'frui-tailwind/fields/Select';
66-
import Email from 'frui-tailwind/formats/Email';
67-
```
68-
69-
## Components (13)
70-
71-
- Accordian *(TODO)*
72-
- Alert
73-
- Badge
74-
- Button
75-
- Control
76-
- Crumbs *(TODO)*
77-
- Loader
78-
- Modal
79-
- Pagination *(TODO)*
80-
- Progress *(TODO)*
81-
- Table
82-
- Tabs *(TODO)*
83-
- Tree *(TODO)*
84-
85-
## Fields (32)
86-
87-
- Autocomplete
88-
- Checkbox
89-
- Checklist *(TODO)*
90-
- Code *(TODO)*
91-
- Color *(TODO)*
92-
- Country
93-
- Currency
94-
- Date
95-
- Datetime
96-
- Fieldset
97-
- File
98-
- Filelist
99-
- Image
100-
- Imagelist
101-
- Input
102-
- JSON *(TODO)*
103-
- Markdown
104-
- Mask
105-
- Metadata (String, Number, Date, Datetime, Time)
106-
- Number
107-
- Password
108-
- Radio
109-
- Radio Group *(TODO)*
110-
- Select
111-
- Slider *(TODO)*
112-
- Slug
113-
- Switch
114-
- Taglist
115-
- Textarea
116-
- Textlist
117-
- Time
118-
- WYSIWYG *(TODO)*
119-
120-
## Formats (20)
121-
122-
- Color
123-
- Currency
124-
- Date
125-
- Email
126-
- Formula
127-
- HTML
128-
- Image
129-
- Imagelist
130-
- JSON
131-
- Link
132-
- List (Ordered, Unordered)
133-
- Markdown
134-
- Metadata
135-
- Number
136-
- Overflow (Char, Word)
137-
- Phone
138-
- Separated (Space, Comma, Line)
139-
- Table
140-
- Taglist
141-
- Yesno
142-
14327
## Contributing
14428

14529
Thanks for being an awesome developer! We are always looking for
@@ -150,7 +34,7 @@ Clone this repo and run the following commands in the project folder.
15034
```js
15135
$ yarn
15236
$ yarn build
153-
$ yarn start
37+
$ yarn dev
15438
```
15539

15640
Please follow the steps below to properly contribute to this repository.

0 commit comments

Comments
 (0)