Skip to content
This repository has been archived by the owner on Sep 7, 2020. It is now read-only.

0.15.0

Compare
Choose a tag to compare
@MoOx MoOx released this 13 Jul 14:53
· 1314 commits to master since this release

tl;dr;

  • offline option has been rewritten. If you were using offline: 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 via file-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 new offline 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.x

    • remark-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 use offline option.
    Since 3000 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 use offline 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)
  • 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)