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 )
11
20
12
21
## Install
13
22
14
23
``` bash
15
24
$ npm install frui
16
25
```
17
26
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
-
143
27
## Contributing
144
28
145
29
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.
150
34
``` js
151
35
$ yarn
152
36
$ yarn build
153
- $ yarn start
37
+ $ yarn dev
154
38
```
155
39
156
40
Please follow the steps below to properly contribute to this repository.
0 commit comments