Skip to content

Commit 69f76b8

Browse files
committed
build: readme to avoid docz conficts
1 parent 6ab8895 commit 69f76b8

File tree

1 file changed

+144
-0
lines changed

1 file changed

+144
-0
lines changed

README

Lines changed: 144 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,144 @@
1+
<p align="center">
2+
<a href="https://coreui.io/">
3+
<img
4+
src="https://coreui.io/images/brand/coreui-signet.svg"
5+
alt="CoreUI logo"
6+
width="200"
7+
/>
8+
</a>
9+
</p>
10+
11+
<h3 align="center">CoreUI</h3>
12+
13+
<p align="center">
14+
React.js Components Library built on top of Bootstrap 5 and TypeScript.
15+
<br>
16+
<a href="https://coreui.io/react/docs/4.0/getting-started/introduction"><strong>Explore CoreUI docs »</strong></a>
17+
<br>
18+
<br>
19+
<a href="https://github.com/coreui/coreui-react/issues/new?template=bug_report.md">Report bug</a>
20+
·
21+
<a href="https://github.com/coreui/coreui-react/issues/new?template=feature_request.md">Request feature</a>
22+
·
23+
<a href="https://community.coreui.io/">Community</a>
24+
·
25+
<a href="https://blog.coreui.io/">Blog</a>
26+
</p>
27+
28+
29+
## Table of contents
30+
31+
- [Quick start](#quick-start)
32+
- [Status](#status)
33+
- [What's included](#whats-included)
34+
- [Bugs and feature requests](#bugs-and-feature-requests)
35+
- [Documentation](#documentation)
36+
- [Contributing](#contributing)
37+
- [Community](#community)
38+
- [Versioning](#versioning)
39+
- [Creators](#creators)
40+
- [Copyright and license](#copyright-and-license)
41+
42+
## Quick start
43+
44+
### Instalation
45+
46+
Several quick start options are available:
47+
48+
- [Download the latest release](https://github.com/coreui/coreui-react/archive/v4.0.0-alpha.0.zip)
49+
- Clone the repo: `git clone https://github.com/coreui/coreui-react.git`
50+
- Install with [npm](https://www.npmjs.com/): `npm install @coreui/react@next`
51+
- Install with [yarn](https://yarnpkg.com/): `yarn add @coreui/react@next`
52+
53+
Read the [Getting started page](https://coreui.io/react/docs/4.0/getting-started/introduction/) for information on the framework contents, templates and examples, and more.
54+
55+
### Stylesheets
56+
57+
React components are styled using `@coreui/coreui` CSS library, but you can use them also with bootstrap CSS library. That is possible because `@coreui/coreui` library is compatible with bootstrap, it just extends its functionalities. The only exception is custom CoreUI components, which don't exist in the Bootstrap ecosystem.
58+
59+
#### CoreUI CSS files
60+
61+
##### Installation
62+
63+
```bash
64+
npm install @coreui/coreui@next
65+
```
66+
67+
##### Basic usage
68+
69+
```js
70+
import "@coreui/dist/css/coreui.min.css";
71+
```
72+
73+
#### Bootstrap CSS files
74+
75+
##### Installation
76+
77+
```bash
78+
npm install bootstrap@next
79+
```
80+
81+
##### Basic usage
82+
83+
```js
84+
import "bootstrap/dist/css/bootstrap.min.css";
85+
```
86+
87+
## Status
88+
89+
[![Build Status](https://github.com/coreui/coreui-react/workflows/JS%20Tests/badge.svg?branch=main)](https://github.com/coreui/coreui-react/actions?query=workflow%3AJS+Tests+branch%3Amain)
90+
[![npm version](https://img.shields.io/npm/v/@coreui/react)](https://www.npmjs.com/package/@coreui/react)
91+
[![peerDependencies Status](https://img.shields.io/david/peer/coreui/coreui)](https://david-dm.org/coreui/coreui?type=peer)
92+
[![devDependency Status](https://img.shields.io/david/dev/coreui/coreui)](https://david-dm.org/coreui/coreui?type=dev)
93+
[![Coverage Status](https://img.shields.io/coveralls/github/coreui/coreui-react/v4-dev)](https://coveralls.io/github/coreui/coreui-react?branch=v4-dev)
94+
95+
## Bugs and feature requests
96+
97+
Have a bug or a feature request? Please first read the [issue guidelines](https://github.com/coreui/coreui-react/blob/v4-dev/.github/CONTRIBUTING.md#using-the-issue-tracker) and search for existing and closed issues. If your problem or idea is not addressed yet, [please open a new issue](https://github.com/coreui/coreui-react/issues/new).
98+
99+
## Documentation
100+
101+
The documentation for the CoreUI & CoreUI PRO is hosted at our website [CoreUI for React](https://coreui.io/react/docs/4.0/getting-started/introduction)
102+
103+
### Running documentation locally
104+
105+
1. Run `yarn install` to install the Node.js dependencies, including Hugo (the site builder).
106+
2. Run `yarn docz:build` (or a specific npm script) to rebuild distributed CSS and JavaScript files, as well as our docs assets.
107+
3. From the root directory, run `yarn docz:serve` in the command line.
108+
4. Open `http://localhost:3000/` in your browser, and voilà.
109+
110+
## Contributing
111+
112+
Please read through our [contributing guidelines](https://github.com/coreui/coreui-react/blob/v4-dev/.github/CONTRIBUTING.md). Included are directions for opening issues, coding standards, and notes on development.
113+
114+
Editor preferences are available in the [editor config](https://github.com/coreui/coreui-react/blob/v4-dev/.editorconfig) for easy use in common text editors. Read more and download plugins at <https://editorconfig.org/>.
115+
116+
## Community
117+
118+
Stay up to date on the development of CoreUI and reach out to the community with these helpful resources.
119+
120+
- Read and subscribe to [The Official CoreUI Blog](https://coreui.io/blog/).
121+
- Join [the official Community](https://community.coreui.io/).
122+
123+
You can also follow [@core_ui on Twitter](https://twitter.com/core_ui).
124+
125+
## Versioning
126+
127+
For transparency into our release cycle and in striving to maintain backward compatibility, CoreUI is maintained under [the Semantic Versioning guidelines](http://semver.org/).
128+
129+
See [the Releases section of our project](https://github.com/coreui/coreui-react/releases) for changelogs for each release version.
130+
131+
## Creators
132+
133+
**Łukasz Holeczek**
134+
135+
- <https://twitter.com/lukaszholeczek>
136+
- <https://github.com/mrholek>
137+
138+
**Andrzej Kopański**
139+
140+
- <https://github.com/xidedix>
141+
142+
## Copyright and license
143+
144+
Copyright 2021 creativeLabs Łukasz Holeczek. Code released under the [MIT License](https://github.com/coreui/coreui-react/blob/v4-dev/LICENSE). Docs released under [Creative Commons](https://creativecommons.org/licenses/by/3.0/).

0 commit comments

Comments
 (0)