0.15.0
tl;dr;
offline
option has been rewritten. If you were usingoffline: true
, you
don't need to change anything, you will just have few bug fixes and a change
to "network" first approach.
Otherwise, please check details below and/or the online documentation.
We hope you will enjoy this nice API!- default port is now 3333 in development
- remark has been updated to 5.x version
- boilerplate got some updates, mainly for stylelint
Details
-
Removed:
appcache
option has now completely being removed in favor of
offline
(after being deprecated in 0.11.0). See new API below. -
Changed: Offline option has been completely rewritten.
Service Worker now uses a network first approach.
This is to prevent having an outdated collection that will lead to request
outdated entries urls that might not exist anymore (and that have not been
cached yet, see #451).
This is for the better.
By the way, we now rely on
offline-plugin
to generate Service Worker and Appcache files.
The part that registers the Service Worker is now included in the client
bundle.
Note that for a better caching, the default boilerplate now use[hash]
in the filenames loaded viafile-loader
.
We encourage you to do the same by using a parameter like
loader: "file-loader?name=[path][name].[hash].[ext] // ...
.
Offline API is now much more flexible and clear to setup thanks to the new
cachePatterns
.
Here is an example of the newoffline
option:{ serviceWorker: true, appcache: { // fallback for SW, will cache onInstall and afterInstall pattern. // onDemand cannot be cache with appcache. onInstall: true, afterInstall: true, }, cachePatterns: { onInstall: [ "/", "phenomic.*" ], // cache App Shell on SW install afterInstall: [ "**", ":assets:" ], // cache all content onDemand: [ ], // since everything is cached by default (if offline: true) // you don't need to cache anything on demand. // but this option offers you a lot of flexibility, see documentation // for more examples excludes: [ "**/.*", "**/*.map", "**/*.html" ], // excludes useless files }, }
Using
offline: true
will use the configuration above. To know more about
this option and all the possibility you have, please read the documentation.
(#485 - @MoOx) -
Changed:
remark
has been updated to^5.0.0
.
This is a breaking change and since (for now) remark
is still a dependency,
you should be careful when upgrading if you are using a custom render method
based on remark.
Some plugins have also been updated to work with remark 5.xremark-highlight.js
has been updated to^3.1.1
remark-html
has been updated to^5.0.0
-
Changed: default port is now
3333
.
This is to prevent weird behavior if you useoffline
option.
Since3000
is pretty common, not using it will avoid having your website
Service Worker to be used for others projects.
That said we advise you to choose your own port if you useoffline
option.
(@MoOx)
Boilerplate
- Changed:
postcss-browser-reporter
is now disabled in production.
Just in case you still have some PostCSS messages not handled yet.
Here is the change you can do in your PostCSS config section in your
webpack.config
to do the same on your existing project:
`diff
postcss: () => [
require("stylelint")(),
require("postcss-cssnext")({ browsers: "last 2 versions" }),- require("postcss-browser-reporter")(),
require("postcss-reporter")(),
- ...config.production ? [
-
require("postcss-browser-reporter")(),
- ] : [],
],
`
(@MoOx)
- require("postcss-browser-reporter")(),
- Changed:
stylelint
has been updated to^6.8.0
(@MoOx) - Changed:
stylelint-config-standard
has been updated to^10.0.0
(@MoOx) - Changed: making date structure obvious in examples posts frontmatter.
(#559 - @MoOx)