Roots Cache Manifest

Roots cache manifest is a roots plugin that allows you to use wildcard globs in your cache manifest's explicit entries.

Installation

• make sure you are in your roots project directory

• npm install roots-cache-manifest --save

• modify your app.coffee file to include the extension, as such

  CacheManifest = require('roots-cache-manifest')
  
  module.exports =
    extensions: [CacheManifest(
      manifest: "assets/manifest.appcache", # required
    )]
  
    # everything else...

Usage

This extension will go through all the files in your output directory and add them to your cache manifest according to specified globs. Paths will be taken as relative to the directory of the final manifest output.

For example, let's say we have this output directory:

|-- outside.css
|-- index.html
|-- manifest.appcache
|-- partials
|   `-- partial.html
|-- css
|   |-- libs
|   |   `-- bootstrap.css
|   `-- master.css
`-- js
    |-- libs
    |   `-- bootstrap.js
    `-- main.js

The extension will take this manifest.appcache:

css/**/*.css
js/*.js
*.html

And compile it into this:

CACHE MANIFEST
#<timestamp>
css/libs/bootstrap.css
css/master.css
js/main.js
index.html
partials/partial.html

Options

manifest

The path to your input manifest.appcache or a minimatch-compatible string matching one or more files to be compiled. This is mandatory.

matchopts

Options for minimatch. By default, matchBase and nonull are enabled.

timestamp

Adds a comment with the current timestamp (so the appcache will be refreshed on each compile). Defaults to true.

License & Contributing

• Details on the license can be found here
• Details on running tests and contributing can be found here