How to Correctly Use Bootstrap 5 in Next.js

Last updated on August 31, 2021 A Goodman Loading... Post a comment

This article shows you how to correctly use Bootstrap 5 in a Next.js project. By the end of this article, we will be able to:

  • Use all CSS classes provided by Bootstrap 5 whereever you want.
  • Use all Javascript functionality provided by Bootstrap 5 without errors.

Without any further ado, let’s get our hands dirty.

The Steps


You can add Bootstrap 5 to your Next.js project by executing the following command:

npm i bootstrap

Adding CSS

To use the styles from Bootstrap, we need to manually import its CSS file into the pages/_app.js file (create one if it doesn’t exist) :

import 'bootstrap/dist/css/bootstrap.css'; // Add this line
import '../styles/globals.css'

function MyApp({ Component, pageProps }) {
  return <Component {...pageProps} />

export default MyApp

At this point, you are ready to use Bootstrap’s CSS features, like this:

<button className="btn btn-primary m-3">Button Primary</button>

However, components that need Javascript like dropdown, collapse, accordion, carousel... will NOT work and will cause errors even if you import Bootstrap’s Javascript file like this:

import "bootstrap/dist/js/bootstrap";

To fix this, we have to do an extra step.

Using Javascript features

Bootstrap uses some only-client-side objects (window, document) to handle events. On the other hand, Next.js renders the app on both the server-side and client-side. There is no window, document on the server-side thus you can see some error messages like the following:

document is not defined
windows is not defiend

To avoid the mentioned errors, we have to make sure that the window and document objects only be used on the client side. That can be done with the useEffect hook:

// Place this in the pages/_app.js file
useEffect(() => {
}, []);

For more clarity, see the complete example below.

The Example


In this demo, we have some beautiful buttons made with Bootstrap. The dropdown select button is a thing that needs Javascript to work.

The Code

1. pages/_app.js:

import "bootstrap/dist/css/bootstrap.css";
import "../styles/globals.css";

import { useEffect } from "react";

function MyApp({ Component, pageProps }) {
  useEffect(() => {
  }, []);

  return <Component {...pageProps} />;

export default MyApp;

2. pages/index.js:

export default function Home() {
  return (
    <div className="container p-3">
      <button className="btn btn-primary m-3"></button>
      <button className="btn btn-warning m-3">Hello</button>

      <div className="dropdown m-3">
          className="btn btn-secondary dropdown-toggle"
          Dropdown button
        <ul className="dropdown-menu" aria-labelledby="dropdownMenuButton1">
            <a className="dropdown-item" href="#">
              Option 1
            <a className="dropdown-item" href="#">
              Option 2
            <a className="dropdown-item" href="#">
              Option 3


You’ve learned how to fully use Bootstrap 5 in a Next.js project. If you’d like to explore more new and interesting stuff about modern frontend development with Next.js and React, take a look at the following articles:

You can also check our React topic page and Next.js topic page for the latest tutorials and examples.

Notify of
Inline Feedbacks
View all comments

Related Articles