Subsequent.js offers us CSS Modules by default, offering advantages like scoped kinds and centered growth in our app. How can we give our Subsequent.js CSS superpowers with Sass?

What are CSS Modules?

CSS Modules are basically CSS information that, when imported into JavaScript initiatives, present kinds which might be scoped to that individual a part of the undertaking by default.

When importing your module, the lessons are represented by an object mapped with every class identify, permitting you to use that class proper to your undertaking.

As an illustration, if I had a CSS module for the title of my web page:

  shade: blueviolet;

And I import that into my React undertaking:

import kinds from './my-styles.css'

I can then apply that title proper to a component as if it had been a string:

<h1 className=kinds.title>My Title</h1>

By scoping kinds, you now not have to fret about breaking different elements of the appliance with cascading kinds. It’s additionally simpler to handle smaller chunks of code that pertain to a selected piece of the appliance.

What’s Sass?

Sass is an extension of the CSS language that gives highly effective options like variables, features, and different operations that let you extra simply construct complicated options into your undertaking.

For example, if I wished to retailer my shade above in a variable so I can simply change it later, I can add:

$color-primary: blueviolet;

  shade: $color-primary;

If I wished to vary that shade however solely in a single spot, I can use built-in shade features to vary the shade:

$color-primary: blueviolet;


One extra profit is the power to nest kinds. This permits for simpler, extra logical group of your CSS.

As an illustration, if I wished to vary solely a <sturdy> ingredient nested in a title, I can add:

$color-primary: blueviolet;
$color-secondary: cyan;

.title {

  shade: $color-primary;
  border-bottom: strong 2px darken($color-primary, 10);

    shade: $color-secondary;


What are we going to construct?

We will create a brand new React app utilizing Subsequent.js.

With our new app, we’ll learn to set up and configure Sass in order that we are able to take benefit its options within Subsequent.js.

As soon as arrange Sass, we’ll stroll via learn how to use Sass variables and mixins to recreate among the default parts of the Subsequent.js UI.

Wish to skip the tutorial and dive into the code? Take a look at Subsequent.js Sass Starter on GitHub:

Step 0: Creating a brand new Subsequent.js app

To get began with a brand new Subsequent.js app, we are able to use Create Subsequent App.

In your terminal, navigate to the place you wish to create the brand new undertaking and run:

yarn create next-app my-next-sass-app

Observe: you need to use npm as a substitute of yarn for any examples with set up and bundle administration.

As soon as the set up finishes, you’ll be able to navigate into the listing, and begin your growth server:

yarn dev

Which ought to begin your new Subsequent.js undertaking at http://localhost:3000!

New Subsequent.js app

If that is your first time creating a brand new Subsequent.js app, take a look round! It comes with a primary homepage in addition to two CSS information:

  • /kinds/globals.css
  • /kinds/Dwelling.module.css

Right here we’ll be specializing in the house file. When you look inside pages/index.js, there, you’ll see that we’re importing the house file, making these kinds accessible.

Subsequent.js has CSS Modules inbuilt by default. Which means once we import our dwelling kinds file, the CSS lessons are added to the kinds object, and we apply every of these class names to the React parts from that object, comparable to:

<h1 className=kinds.title>

That signifies that our kinds are scoped to that single web page.

To study extra about CSS Modules or the built-in help in Subsequent.js, you’ll be able to try the next sources:

Step 1: Putting in Sass in a Subsequent.js app

Whereas Subsequent.js comes with some good built-in CSS help, it doesn’t include Sass utterly inbuilt.

Fortunately, to get Sass up and operating within our Subsequent.js app, all we have to do is set up the Sass bundle from npm, which can let Subsequent.js embody these information in its pipeline.

To put in Sass, run the next within your undertaking:

yarn add sass

And if we begin again up our growth server and reload the web page, we’ll really discover that nothing has occurred but, which is an efficient factor!

However subsequent we’ll learn to make the most of our CSS superpowers.

Observe together with the commit!

Step 2: Importing Sass information right into a Subsequent.js app

Now that Sass is put in, we’re prepared to make use of it.

So as you utilize any Sass-specific options although, we’ll want to make use of Sass information with both the .sass or .scss extension. For this walkthrough, we’re going to make use of the SCSS syntax and the .scss extension.

To get began, within pages/index.js, change the import of the kinds object on the prime of the web page to:

import kinds from '../kinds/Dwelling.module.scss'

And as soon as the web page reloads, as we in all probability anticipate, the web page is definitely damaged.

Subsequent.js did not compile

To repair this, rename the file:




The distinction is we’re altering the file extension from .css to .scss.

As soon as the web page reloads, we’ll see that our Subsequent.js web site is loading and is again prepared for motion!

New.js app loading

Observe: We’re not going to cowl the worldwide kinds file right here – you are able to do the identical factor by renaming the worldwide kinds file and updating the import within /pages/_app.js

Subsequent, we’ll learn to use Sass options for our Subsequent.js app.

Observe together with the commit!

Step 3: Utilizing Sass variables in a Subsequent.js app

Now that we’re utilizing Sass in our undertaking, we are able to begin utilizing among the primary options like variables.

To point out how this works, we’re going to replace the blue within our app to my favourite shade, purple!

On the prime of /kinds/Dwelling.module.css, add the next:

$color-primary: #0070f3;	

The colour #0070f3 is what Subsequent.js makes use of by default within the app.

Subsequent, replace every location that makes use of that shade in our dwelling CSS file to our new variables, comparable to altering:

.title a {
  shade: #0070f3;


.title a {
  shade: $color-primary;

If we refresh the web page, nothing ought to change.

Unchanged Subsequent.js app

However now as a result of we’re utilizing a variable to outline that shade, we are able to simply change it.

On the prime of the web page, change the $color-primary variable to purple or no matter your favourite shade is:

$color-primary: blueviolet;

And when the web page reloads, we are able to see that our colours are actually purple!

Subsequent.js app with purple shade

Variables are simply the begin to the superpowers Sass offers our CSS, however we are able to see that they permit us to simply handle our colours or different values all through our software.

Observe together with the commit!

Step 4: Utilizing Sass mixins with international imports in Subsequent.js

One of many different many options of Sass is mixins. They offer us the power to create function-like definitions, permitting us to configure guidelines that we are able to repeat and use all through our app.

In our instance, we’re going to create a brand new mixin that enables us to create responsive kinds utilizing a media question all through our app. Whereas we are able to already try this with a media question alone, utilizing a mixin permits us to make use of a single definition, preserving that constant and permitting us to handle that responsive definition from one place.

As a result of this mixin is one thing we wish to use all through our complete software, we are able to additionally use one other characteristic of Sass, which is the power to import information.

To get began, create a brand new file underneath the /kinds listing:


We’re utilizing an underscore in entrance of our filename to indicate that it’s a partial.

Subsequent, within our /kinds/Dwelling.module.scss file, let’s import that new file:

@import "mixins";

As soon as the web page reloads, we’ll discover nothing modified.

If we lookout the underside of Dwelling.module.scss, we’ll see that we’re utilizing a media question to make the .grid class responsive. We’re going to make use of that as a foundation for our mixin.

Within _mixins.scss, add the next:

@mixin desktop() {
  @media (max-width: 600px) 
    @content material;

Observe: whereas we in all probability can provide you with a greater identify for this mixin than desktop, we’ll use that as the idea of our instance.

The @content material signifies that any time we use our desktop mixin, it should embody the nested content material in that location.

To check this out, again in our Dwelling.module.css file, let’s replace our .grid snippet:

@embody desktop() {
  .grid {
    width: 100%;
    flex-direction: column;

If we open our app again up and shrink the browser window, we are able to see that we nonetheless have our responsive kinds!

Responsive kinds in Subsequent.js

We will even take this a step additional. Sass means that you can nest kinds. As an illustration, as a substitute of writing:


.footer img {
  margin-left: 0.5rem;

We will embody that img definition proper within the unique .footer definition:

.footer {

  // Kinds

  img {
    margin-left: 0.5rem;

That img definition will compile to .footer img, simply the identical as if it was written in normal CSS.

So with that in thoughts, we are able to use the identical idea and transfer our desktop mixin into our authentic .grid class:

.grid {

  @embody desktop() {
    width: 100%;
    flex-direction: column;


And if you happen to discover, as a result of we’re within the .grid class already, we are able to take away that from within the mixin, as it should already be utilized.

This permits for a lot simpler group of our responsive kinds.

Lastly, if we glance again at our app, we’ll discover that also, nothing has modified, which suggests we’re efficiently utilizing our Sass mixin.

No change in our Subsequent.js app

Observe together with the commit!

What else can we do with Sass and Subsequent.js?

We’re solely scratching the floor right here with Sass. As a result of our CSS modules now have the ability of Sass, we have now a ton of capabilities that don’t come by default with CSS.

Colour Capabilities

Sass has a ton of features inbuilt that permit us to govern colours, mixing and matching shades rather more simply.

Two that I take advantage of typically are darken and lighten, that let you take a shade and alter the shade.

Study extra about all the accessible shade features in Sass.

Customized Capabilities

Whereas mixins look like features, we are able to outline true features in Sass that permit us to carry out complicated operations and produce values primarily based on an enter.

Study extra about customized features in Sass.

Different Worth Varieties

Whereas more often than not with CSS we’re utilizing strings or numbers, we noticed {that a} easy extension of that’s the capacity to make use of variables.

Along with variables, Sass offers us extra worth varieties like Maps, which operate type of like an object, and Lists, that are type of like arrays.

Study extra in regards to the worth varieties in Sass.