Next.js + Sass
Import .scss
and .sass
files in your Next.js project
Installation
npm install --save @zeit/next-sass node-sass
or
yarn add @zeit/next-sass node-sass
Usage
Without CSS modules
Create a next.config.js
in your project
// next.config.js
const withSass = require('@zeit/next-sass')
module.exports = withSass()
Create a Sass file styles.scss
$font-size: 50px;
.example {
font-size: $font-size;
}
Create a page file pages/index.js
import "../styles.scss"
export default () => <div className="example">Hello World!</div>
With CSS modules
// next.config.js
const withSass = require('@zeit/next-sass')
module.exports = withSass({
cssModules: true
})
Create a Sass file styles.scss
$font-size: 50px;
.example {
font-size: $font-size;
}
Create a page file pages/index.js
import css from "../styles.scss"
export default () => <div className={css.example}>Hello World!</div>
Production usage
In production the stylesheet is compiled to .next/static/style.css
. You have to include it into the page using either next/head
or a custom _document.js
. The file will be served from /_next/static/style.css
// pages/index.js
import Head from 'next/head'
export default () => {
return <div>
<Head>
<link rel="stylesheet" href="/_next/static/style.css">
</Head>
</div>
}
// ./pages/_document.js
import Document, { Head, Main, NextScript } from 'next/document'
export default class MyDocument extends Document {
render() {
return (
<html>
<Head>
<link rel="stylesheet" href="/_next/static/style.css">
</Head>
<body>
<Main />
<NextScript />
</body>
</html>
)
}
}
PostCSS plugins
Create a next.config.js
in your project
// next.config.js
const withSass = require('@zeit/next-sass')
module.exports = withSass()
Create a postcss.config.js
module.exports = {
plugins: {
// Illustrational
'postcss-css-variables': {}
}
}
Create a CSS file styles.scss
the CSS here is using the css-variables postcss plugin.
:root {
--some-color: red;
}
.example {
/* red */
color: var(--some-color);
}
When postcss.config.js
is not found postcss-loader
will not be added and will not cause overhead.
Configuring Next.js
Optionally you can add your custom Next.js configuration as parameter
// next.config.js
const withSass = require('@zeit/next-sass')
module.exports = withSass({
webpack(config, options) {
return config
}
})