What is reactstrap?
Reactstrap is a popular library that provides Bootstrap 4 components for React applications. It allows developers to use Bootstrap's powerful and responsive design system within their React projects, making it easier to create visually appealing and functional user interfaces.
What are reactstrap's main functionalities?
Buttons
Reactstrap provides a variety of button components that can be customized with different colors, sizes, and styles. The example shows a primary button.
<Button color="primary">Primary Button</Button>
Modals
Reactstrap includes modal components that can be used to create dialog boxes. The example demonstrates a modal with a header, body, and footer.
<Modal isOpen={modal} toggle={toggle}><ModalHeader toggle={toggle}>Modal title</ModalHeader><ModalBody>Modal content</ModalBody><ModalFooter><Button color="primary" onClick={toggle}>Do Something</Button><Button color="secondary" onClick={toggle}>Cancel</Button></ModalFooter></Modal>
Forms
Reactstrap provides form components to create various types of forms. The example shows a simple form with email and password fields.
<Form><FormGroup><Label for="exampleEmail">Email</Label><Input type="email" name="email" id="exampleEmail" placeholder="Enter your email" /></FormGroup><FormGroup><Label for="examplePassword">Password</Label><Input type="password" name="password" id="examplePassword" placeholder="Enter your password" /></FormGroup><Button>Submit</Button></Form>
Navbars
Reactstrap includes navbar components to create responsive navigation headers. The example shows a simple navbar with links.
<Navbar color="light" light expand="md"><NavbarBrand href="/">Brand</NavbarBrand><NavbarToggler onClick={toggle} /><Collapse isOpen={isOpen} navbar><Nav className="ml-auto" navbar><NavItem><NavLink href="/components/">Components</NavLink></NavItem><NavItem><NavLink href="https://github.com/reactstrap/reactstrap">GitHub</NavLink></NavItem></Nav></Collapse></Navbar>
Cards
Reactstrap provides card components to create flexible and extensible content containers. The example shows a card with an image, title, text, and button.
<Card><CardImg top width="100%" src="/path/to/image.jpg" alt="Card image cap" /><CardBody><CardTitle>Card Title</CardTitle><CardText>Some quick example text to build on the card title and make up the bulk of the card's content.</CardText><Button>Button</Button></CardBody></Card>
Other packages similar to reactstrap
react-bootstrap
React-Bootstrap is another popular library that provides Bootstrap components for React. It offers a similar set of features to Reactstrap but is built with a different approach. React-Bootstrap replaces the Bootstrap JavaScript with React components, providing a more seamless integration with React's ecosystem.
material-ui
Material-UI is a library that provides React components implementing Google's Material Design. While it offers a different design language compared to Bootstrap, it serves a similar purpose in providing pre-built, customizable components for building user interfaces in React applications.
semantic-ui-react
Semantic UI React is the official React integration for Semantic UI. It provides a set of React components that follow the Semantic UI design framework, offering a different set of design principles and components compared to Bootstrap-based libraries like Reactstrap.


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:
<script src="https://cdnjs.cloudflare.com/ajax/libs/reactstrap/6.0.1/reactstrap.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/reactstrap/6.0.1/reactstrap.full.min.js"></script>
<script src="https://unpkg.com/reactstrap@6.0.1/dist/reactstrap.min.js"></script>
<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.1
with the version number.
Versions
Reactstrap has two primary distribution versions:
-
reactstrap.min.js
This file excludes the optional dependencies – react-popper
and react-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-popper
or react-transition-group
– Reactstrap and your application
will use the single global version included
-
reactstrap.full.min.js
This file includes the optional dependencies – react-popper
and react-transition-group
Recommended use cases:
Example
<!doctype html>
<html lang="en">
<head>
<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/prop-types/15.6.1/prop-types.min.js"></script>
<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/react/16.3.2/umd/react.production.min.js"></script>
<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/react-dom/16.3.2/umd/react-dom.production.min.js"></script>
<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/react-transition-group/2.2.1/react-transition-group.min.js"></script>
<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.3/umd/popper.min.js"></script>
<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/react-popper/0.10.4/umd/react-popper.min.js"></script>
<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/reactstrap/6.0.1/reactstrap.min.js"></script>
<script type="text/javascript" src="/assets/bundle.js"></script>
</head>
<body>
<div id="my-app" />
</body>
</html>
About the Project
This library contains React Bootstrap 4 components that favor composition and control. The library does not depend on jQuery or Bootstrap javascript. However, Poppers.js via react-popper is relied upon for advanced positioning of content like Tooltips, Popovers, and auto-flipping Dropdowns.
There are a few core concepts to understand in order to make the most out of this library.
-
Your content is expected to be composed via props.children rather than using named props to pass in Components.
const Example = (props) => {
return (
<p>This is a tooltip <TooltipTrigger tooltip={TooltipContent}>example</TooltipTrigger>!</p>
);
}
const PreferredExample = (props) => {
return (
<p>
This is a <a href="#" id="TooltipExample">tooltip</a> example.
<Tooltip target="TooltipExample">
<TooltipContent/>
</Tooltip>
</p>
);
}
-
Attributes in this library are used to pass in state, conveniently apply modifier classes, enable advanced functionality (like tether), or automatically include non-content based elements.
Examples:
isOpen
- current state for items like dropdown, popover, tooltiptoggle
- callback for toggling isOpen
in the controlling componentcolor
- applies color classes, ex: <Button color="danger"/>
size
- for controlling size classes. ex: <Button size="sm"/>
tag
- customize component output by passing in an element name or Component- boolean based props (attributes) when possible for alternative style classes or
sr-only
content
https://reactstrap.github.io
Documentation search is powered by Algolia's DocSearch.
Here are some ready-to-go examples for CodeSandbox that you can experiment with.
https://github.com/reactstrap/code-sandbox-examples
Development
Install dependencies:
npm install
Run examples at http://localhost:8080/ with webpack dev server:
npm start
Run tests & coverage report:
npm test
Watch tests:
npm run test-watch
Releasing
Release branches/versioning/notes will be automatically created and maintained by the release-please github action. When you're ready to publish the release, just merge the release branch. The release will be created, the new package will be published, and the updated docs will be deployed to https://reactstrap.github.io/.
In the wild
Organizations and projects using reactstrap
- airframe-react - demo - Airframe provides all the components a developer needs to build data-intensive web apps using React.
- component-template
- video-react
- CoreUI-Free-Bootstrap-Admin-Template - demo
- Admin dashboard example app built with reactstrap - demo
- DevExtreme React Grid - It's a stateless data grid built on top of
reactstrap
with paging, sorting, filtering, grouping, selection, editing and virtual scrolling features. - DevExtreme React Chart - A chart built on top of
reactstrap
that visualizes data using a variety of series types, including bar, line, area, scatter, pie, and more. - reactstrap-scrollspy - demo
- formstrap - demo - Let your
reactstrap
input component integrate seamlessly using Formik
Submit a PR to add to this list!
Looking to build, document and publish reusable components built on top of reactstrap
? Consider forking https://github.com/reactstrap/component-template to kickstart your project!