Update 2.6.1 migration for postcss

This commit is contained in:
zodern
2022-02-10 17:47:18 -06:00
parent 69ceddc81a
commit e66aea0bd9

View File

@@ -3,25 +3,34 @@ title: Migrating to Meteor 2.6.1
description: How to migrate your application to Meteor 2.6.1.
---
Meteor 2.6.1 introduce the new `accounts-2fa` package and also support to TailwindCSS 3.x incorporating `postcss` minifier code to core in the `standard-minifier-css`. For a complete breakdown of the changes, please refer to the [changelog](http://docs.meteor.com/changelog.html).
Meteor 2.6.1 introduce the new `accounts-2fa` package, support for TailwindCSS 3.x, and built-in support for PostCSS in `standard-minifier-css`. For a complete breakdown of the changes, please refer to the [changelog](http://docs.meteor.com/changelog.html).
The above being said, there are a few items that you should do to have the latest CSS minifier in your project.
<h3 id="new-css-minifier">CSS Minifier with PostCSS</h3>
<h3 id="new-css-minifier">Support for PostCSS</h3>
If you are using `juliancwirko:postcss` as your PostCSS CSS Minifier and you want to use the latest Minifier for PostCSS you should use the core package: `standard-minifier-css` instead. Starting from this version of Meteor (and 1.8.0 of `standard-minifier-css`) it supports the latest PostCSS features as well.
Starting from this version of Meteor (and 1.8.0 of `standard-minifier-css`), Meteor will run PostCSS plugins if you have them configured. If you are using `juliancwirko:postcss` as your css minifier, it is recommended to migrate to using `standard-minifier-css`. For most apps, this will only requiring switching which minifier the app uses:
If you want to use TailwindCSS 3.x you must use the `standard-minifier-css` core package to insure Tailwind JIT working properly.
```bash
meteor remove juliancwirko:postcss
meteor add standard-minifier-css
```
Steps to replace the package:
- `meteor remove juliancwirko:postcss`
- `meteor add standard-minifier-css`
There are two differences with `juliancwirko:postcss`:
After replacing the package with the commands above TailwindCSS 3.x should work fine with Meteor 2.6.1.
- The `excludePackages` PostCSS option was renamed to `excludeMeteorPackages`
- Files with the `.import.css` extension are not treated specially
Please read the [Tailwind Official migration guide](https://tailwindcss.com/docs/upgrade-guide) to make sure you had applied the changes required by TailwindCSS itself.
> Note: In beta.1 of Meteor 2.6.1 we had added a new core package `minifier-css-postcss` but later decided to unify everything inside `standard-minifier-css`. So you shouldn't use `minifier-css-postcss`.
> Note: In beta.1 of Meteor 2.6.1 we had added a new core package `minifier-css-postcss` but later in this discussion we decided to unify everything inside `standard-minifier-css`. So you shouldn't use `minifier-css-postcss`.
<h3 id="tailwind-css">TailwindCSS 3.x</h3>
Improvements in Meteor 2.6.1 enables minifiers to support TailwindCSS 3.x. These minifiers have been updated and tested with TailwindCSS 3:
- `juliancwirko:postcss`, starting with version `2.1.0`
- `standard-minifier-css`
If updating from an older version of TailwindCSS to version 3, please read the [Tailwind Official migration guide](https://tailwindcss.com/docs/upgrade-guide) to make sure you had applied the changes required by TailwindCSS itself.
<h3 id="2fa">Accounts 2FA</h3>