You are viewing the deprecated 0.9.2 version of the website. Click here to view the latest version

With node-sass

Use npm/yarn and node-sass


1. Create a package.json file #

In your terminal, create a new folder called mybulma, navigate to it, then type the following command:

npm init

This will launch an interactive setup to create package.json. When prompted for an entry point, enter sass/mystyles.scss.



2. Install the dev dependencies #

You only need 2 packages to customize Bulma: node-sass and bulma itself.

npm install node-sass --save-dev
npm install bulma --save-dev

Your package.json should look like this at this point.

{
  "name": "mybulma",
  "version": "1.0.0",
  "main": "sass/mystyles.scss",
  "license": "MIT",
  "devDependencies": {
    "bulma": "^0.7.2",
    "node-sass": "^4.9.2"
  }
}


3. Create a Sass file #

Create a sass folder in which you add a file called mystyles.scss:

@charset "utf-8";
@import "../node_modules/bulma/bulma.sass";

Make sure to write the correct path to the bulma.sass file.



4. Create an HTML page #

Create an HTML template which uses several Bulma components.

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>My custom Bulma website</title>
    <link rel="stylesheet" href="css/mystyles.css">
  </head>
  <body>
     <h1 class="title">
        Bulma
      </h1>

      <p class="subtitle">
        Modern CSS framework based on <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Flexible_Box_Layout/Basic_Concepts_of_Flexbox">Flexbox</a>
      </p>

      <div class="field">
        <div class="control">
          <input class="input" type="text" placeholder="Input">
        </div>
      </div>

      <div class="field">
        <p class="control">
          <span class="select">
            <select>
              <option>Select dropdown</option>
            </select>
          </span>
        </p>
      </div>

      <div class="buttons">
        <a class="button is-primary">Primary</a>
        <a class="button is-link">Link</a>
      </div>
  </body>
</html>

Save this file as mypage.html.

Notice the css/mystyles.css path for your stylesheet. This will be the location of the CSS file we will generate with Sass.

Open the page in your browser:

Bulma unstyled
The unstyled page


5. Add node scripts to build your CSS #

To build a CSS file from a Sass file, we can use node scripts. In package.json, add the following:

"scripts": {
  "css-build": "node-sass --omit-source-map-url sass/mystyles.scss css/mystyles.css",
  "css-watch": "npm run css-build -- --watch",
  "start": "npm run css-watch"
}
  • css-build takes sass/mystyles.scss as an input, and outputs css/mystyles.css, while omitting the source map
  • css-watch builds the CSS and watches for changes
  • start is simply a shortcut for css-watch

To test it out, go in your terminal and run the following command:

npm run css-build

If set up correctly, you will see the following message:

Rendering Complete, saving .css file...
Wrote CSS to /path/to/mybulma/css/mystyles.css

Reload the page and it should be styled like this:

Bulma default styles
Bulma's default styles

To watch for changes, just launch the following command:

npm start


6. Add your own Bulma styles #

Replace the content of the mystyles.scss file with the following:

@charset "utf-8";

// Import a Google Font
@import url('https://fonts.googleapis.com/css?family=Nunito:400,700');

// Set your brand colors
$purple: #8A4D76;
$pink: #FA7C91;
$brown: #757763;
$beige-light: #D0D1CD;
$beige-lighter: #EFF0EB;

// Update Bulma's global variables
$family-sans-serif: "Nunito", sans-serif;
$grey-dark: $brown;
$grey-light: $beige-light;
$primary: $purple;
$link: $pink;
$widescreen-enabled: false;
$fullhd-enabled: false;

// Update some of Bulma's component variables
$body-background-color: $beige-lighter;
$control-border-width: 2px;
$input-border-color: transparent;
$input-shadow: none;

// Import only what you need from Bulma
@import "../node_modules/bulma/sass/utilities/_all.sass";
@import "../node_modules/bulma/sass/base/_all.sass";
@import "../node_modules/bulma/sass/elements/button.sass";
@import "../node_modules/bulma/sass/elements/container.sass";
@import "../node_modules/bulma/sass/elements/title.sass";
@import "../node_modules/bulma/sass/form/_all.sass";
@import "../node_modules/bulma/sass/components/navbar.sass";
@import "../node_modules/bulma/sass/layout/hero.sass";
@import "../node_modules/bulma/sass/layout/section.sass";

Since you are watching for changes, simply save the file to see the result:

Bulma customized
Bulma's customized theme

And voilà! You've managed to install and customize Bulma.

Made with Bulma
This page is open source. Noticed a typo? Or something unclear?
Improve this page on GitHub

#native_company# #native_desc#
#native_cta#
New!

The official Bulma book! 😲

by Jeremy Thomas, creator of Bulma, Oleksii Potiekhin,
Mikko Lauhakari, Aslam Shah and David Berning

A step-by-step guide that teaches you how to build a web interface from scratch using Bulma.

Formats available:
PDF Epub Mobi
or
Kindle

Newsletter

Features, releases, showcase… stay in the loop!