reactstrap
Stateless React Components for Bootstrap 4.
Getting Started
Follow the create-react-app instructions to get started and then follow the reactstrap version of adding bootstrap.
tl;dr
npx create-react-app my-app
cd my-app/
npm start
or, if npx (Node >= 6 and npm >= 5.2 ) not available
npm install -g create-react-app
create-react-app my-app
cd my-app/
npm start
Then open http://localhost:3000/ to see your app. The initial structure of your app is setup. Next, let's add reactstrap and bootstrap.
Adding Bootstrap
Install reactstrap and Bootstrap from NPM. Reactstrap does not include Bootstrap CSS so this needs to be installed as well:
npm i bootstrap
npm i reactstrap react react-dom
Import Bootstrap CSS in the src/index.js file:
import 'bootstrap/dist/css/bootstrap.css';Import required reactstrap components within src/App.js file or your custom component files:
import { Button } from 'reactstrap';Now you are ready to use the imported reactstrap components within your component hierarchy defined in the render
method. Here is an example App.js redone
using reactstrap.
Dependencies
Required Peer Dependencies
These libraries are not bundled with Reactstrap and required at runtime:
Optional Dependencies
These libraries are not included in the main distribution file reactstrap.min.js and need to be manually
included when using components that require transitions or popover effects (e.g. Tooltip, Modal, etc).
CDN
If you prefer to include Reactstrap globally by marking reactstrap as external in your application, the
reactstrap library provides various single-file distributions, which are hosted on the following CDNs:
<!-- Main version -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/reactstrap/6.0.1/reactstrap.min.js"></script>
<!-- All optional dependencies version -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/reactstrap/6.0.1/reactstrap.full.min.js"></script><!-- Main version -->
<script src="https://unpkg.com/reactstrap@6.0.1/dist/reactstrap.min.js"></script>
<!-- All optional dependencies version -->
<script src="https://unpkg.com/reactstrap@6.0.1/dist/reactstrap.full.min.js"></script>Note: To load a specific version of Reactstrap replace
6.0.1with the version number.
Versions
Reactstrap has two primary distribution versions:
-
reactstrap.min.jsThis file excludes the optional dependencies –
react-popperandreact-transition-group. This is the recommended approach (similar approach in Bootstrap's JavaScript components) for including Reactstrap as it reduces the filesize and gives more flexibility in configuring needed dependencies.Recommended use cases:
- Small, medium, or large applications
- Applications that do not use any transitions or popper components
- Applications that directly use
react-popperorreact-transition-group– Reactstrap and your application will use the single global version included
-
reactstrap.full.min.jsThis file includes the optional dependencies –
react-popperandreact-transition-groupRecommended use cases:
- Small applications