1 | # React-Bootstrap
|
2 |
|
3 | > [Bootstrap 4][bootstrap] components built with [React][react].
|
4 |
|
5 | [![GitHub Actions CI status][gh-actions-badge]][gh-actions]
|
6 | [![Travis CI Build status][travis-badge]][travis]
|
7 | [![npm][npm-badge]][npm]
|
8 | [![Codecov][codecov-badge]][codecov]
|
9 | [![Discord][discord-badge]][discord]
|
10 | [![Netlify][netlify-badge]][netlify]
|
11 |
|
12 | ## Docs
|
13 |
|
14 | See the [documentation][documentation] with live editable examples and API documentation.
|
15 |
|
16 | To find the documentation for the latest Bootstrap 3 compatible release, [go here](https://react-bootstrap-v3.netlify.com).
|
17 |
|
18 | ### Migrating from Bootstrap 3 to Bootstrap 4
|
19 |
|
20 | If you would like to update React-Bootstrap within an existing project to use Bootstrap 4, please read our docs for **[migrating to React-Bootstrap V1](https://react-bootstrap.github.io/migrating/)**.
|
21 |
|
22 | ## Related modules
|
23 |
|
24 | - [react-router-bootstrap][react-router-bootstrap] – Integration with [React Router][react-router]
|
25 | - [Awesome React Bootstrap Components][awesome-react-bootstrap-components] - Additional components like off-canvas navbar, switch and sliders.
|
26 |
|
27 | ## Local setup
|
28 |
|
29 | Yarn is our package manager of choice here. Check out setup
|
30 | instructions [here](https://yarnpkg.com/en/docs/install) if you don't have it installed already.
|
31 | After that you can run `yarn run bootstrap` to install all the needed dependencies.
|
32 |
|
33 | From there you can:
|
34 |
|
35 | - Run the tests once with `yarn test` (Or run them in watch mode with `yarn run tdd`).
|
36 | - Start a local copy of the docs site with `yarn start`
|
37 | - Or build a local copy of the library with `yarn run build`
|
38 |
|
39 | ## CodeSandbox Examples
|
40 |
|
41 | [Click here](https://github.com/react-bootstrap/code-sandbox-examples) to explore some React-Bootstrap [CodeSandbox](https://codesandbox.io/) examples.
|
42 |
|
43 | [Click here](https://codesandbox.io/s/github/react-bootstrap/code-sandbox-examples/tree/master/basic) to automatically open [CodeSandbox](https://codesandbox.io/) with the React-Bootstrap [CodeSandbox Examples GitHub Repository](https://github.com/react-bootstrap/code-sandbox-examples) as a workspace.
|
44 |
|
45 | ## Contributions
|
46 |
|
47 | Yes please! See the [contributing guidelines][contributing] for details.
|
48 |
|
49 | [bootstrap]: https://getbootstrap.com/
|
50 | [react]: https://reactjs.org/
|
51 | [documentation]: https://react-bootstrap.github.io/
|
52 | [contributing]: CONTRIBUTING.md
|
53 | [travis-badge]: https://travis-ci.org/react-bootstrap/react-bootstrap.svg?branch=master
|
54 | [travis]: https://travis-ci.org/react-bootstrap/react-bootstrap
|
55 | [npm-badge]: https://badge.fury.io/js/react-bootstrap.svg
|
56 | [npm]: http://badge.fury.io/js/react-bootstrap
|
57 | [react-router-bootstrap]: https://github.com/react-bootstrap/react-router-bootstrap
|
58 | [react-router]: https://github.com/reactjs/react-router
|
59 | [react-bootstrap-extended]: https://github.com/rbalicki2/react-bootstrap-extended
|
60 | [awesome-react-bootstrap-components]: https://github.com/Hermanya/awesome-react-bootstrap-components
|
61 | [codecov-badge]: https://img.shields.io/codecov/c/github/react-bootstrap/react-bootstrap/master.svg
|
62 | [codecov]: https://codecov.io/gh/react-bootstrap/react-bootstrap
|
63 | [discord-badge]: https://img.shields.io/badge/Discord-Join%20chat%20%E2%86%92-738bd7.svg
|
64 | [discord]: https://discord.gg/AKfs9vpvRW
|
65 | [netlify-badge]: https://api.netlify.com/api/v1/badges/91501718-8820-4d69-b7fe-1616eff5914e/deploy-status
|
66 | [netlify]: https://app.netlify.com/sites/react-bootstrap/deploys
|
67 | [gh-actions-badge]: https://github.com/react-bootstrap/react-bootstrap/workflows/CI/badge.svg
|
68 | [gh-actions]: https://github.com/react-bootstrap/react-bootstrap/actions
|