Skip to content

Commit

Permalink
Updated PostCSS docs and added a link to it (#10292)
Browse files Browse the repository at this point in the history
* Updated PostCSS docs and added a link to it

* Added note back

* Update customizing-postcss-config.md

Co-authored-by: Joe Haddad <timer150@gmail.com>
  • Loading branch information
Luis Alvarez D and Timer committed Jan 28, 2020
1 parent 3720312 commit ee9ccc8
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 4 deletions.
8 changes: 4 additions & 4 deletions docs/advanced-features/customizing-postcss-config.md
Expand Up @@ -54,8 +54,8 @@ You can learn more about [Next.js' CSS Module support here](/docs/basic-features

## Customizing Plugins

> **Warning**: When you define a custom PostCSS configuration file, Next.js **completely disables** the defaults listed above.
> Be sure to manually configure all features you need compiled, including [Autoprefixer](https://github.com/postcss/autoprefixer).
> **Warning**: When you define a custom PostCSS configuration file, Next.js **completely disables** the [default behavior](#default-behavior).
> Be sure to manually configure all the features you need compiled, including [Autoprefixer](https://github.com/postcss/autoprefixer).
To customize the PostCSS configuration, create a `postcss.config.json` file in the root of your project.

Expand Down Expand Up @@ -110,10 +110,10 @@ module.exports = {
}
```

Do **not use `require()`** to import the PostCSS Plugins. Plugins must be provided as strings.

> **Note**: Next.js also allows the file to be named `.postcssrc.js`.
Do **not use `require()`** to import the PostCSS Plugins. Plugins must be provided as strings.

> **Note**: If your `postcss.config.js` needs to support other non-Next.js tools in the same project, you must use the interoperable object-based format instead:
>
> ```js
Expand Down
11 changes: 11 additions & 0 deletions docs/basic-features/built-in-css-support.md
Expand Up @@ -165,3 +165,14 @@ To support importing `.scss`, `.sass`, `.less`, or `.styl` files you can use
- [@zeit/next-sass](https://github.com/zeit/next-plugins/tree/master/packages/next-sass)
- [@zeit/next-less](https://github.com/zeit/next-plugins/tree/master/packages/next-less)
- [@zeit/next-stylus](https://github.com/zeit/next-plugins/tree/master/packages/next-stylus)

## Related

For more information on what to do next, we recommend the following sections:

<div class="card">
<a href="/docs/advanced-features/customizing-postcss-config.md">
<b>Customizing PostCSS Config:</b>
<small>Extend the PostCSS config and plugins added by Next.js with your own.</small>
</a>
</div>

0 comments on commit ee9ccc8

Please sign in to comment.