Need help with reactstrap?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

10.1K Stars 1.2K Forks MIT License 1.1K Commits 235 Opened issues


Simple React Bootstrap 4 components

Services available


Need anything else?

Contributors list


CDNJS NPM Version Build Status Coverage Status License


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.


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

import 'bootstrap/dist/css/bootstrap.css';

Import required reactstrap components within

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

redone using reactstrap.


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

and need to be manually included when using components that require transitions or popover effects (e.g. Tooltip, Modal, etc).


If you prefer to include Reactstrap globally by marking

as external in your application, the
library provides various single-file distributions, which are hosted on the following CDNs:
  • cdnjs ```html <!-- Main version -->
* [**unpkg**](

Note: To load a specific version of Reactstrap replace

with the version number.


Reactstrap has two primary distribution versions:


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


This file **includes** the optional dependencies – `react-popper` and `react-transition-group`

Recommended use cases:

  • Small applications


<!-- Required dependencies -->
<script type="text/javascript" src="//"></script>
<script type="text/javascript" src="//"></script>
<script type="text/javascript" src="//"></script>
<!-- Optional dependencies -->
<script type="text/javascript" src="//"></script>
<script type="text/javascript" src="//"></script>
<script type="text/javascript" src="//"></script>
<!-- Reactstrap -->
<script type="text/javascript" src="//"></script>
<!-- Lastly, include your app's bundle -->
<script type="text/javascript" src="/assets/bundle.js"></script>

<div id="my-app"></div>

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.

  1. Your content is expected to be composed via props.children rather than using named props to pass in Components.

    // Content passed in via props
    const Example = (props) => {
      return (

    This is a tooltip example!

    ); }

    // Content passed in as children (Preferred) const PreferredExample = (props) => { return (

    This is a tooltip example.

    ); }

  2. 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.


- `isOpen` - current state for items like dropdown, popover, tooltip
- `toggle` - callback for toggling `isOpen` in the controlling component
- `color` - applies color classes, ex: ``
- `size` - for controlling size classes. ex: ``
- `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


Documentation search is powered by Algolia's DocSearch.

CodeSandbox Examples

Here are some ready-to-go examples for CodeSandbox that you can experiment with.



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


Create Release Branch

Note: you must have the

environment variable set to a valid GitHub token with write access to your repo.

To create a release branch and changelog, run the following command, optionally with a semantic release type (major, minor, patch) (if not provided, it will default to semver (it's best to let it default)):


Verify changelog in branch. Create a PR if everything looks good. Merge when tests are green.


Note: you must have write permission to this repo do perform this action

Once the release branch is merged, create a release from the tag generated in the release step via the Github UI. This will trigger a github action to publish the new version to npm and deploy the updated docs to

In the wild

Organizations and projects using


Submit a PR to add to this list!

Looking to build, document and publish reusable components built on top of

? Consider forking to kickstart your project!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.