Roots Netlify

A roots extension for creating Netlify configuration files.

Note: This project is in early development, and versioning is a little different. Read this for more details.

Why Should You Care?

Netlify is a great static hosting platform that allows developers to add powerful features to their static sites, like redirects & rewrites and headers & basic auth.

This abstracts Netlify's config files into your app.coffee with the rest of your configs so they can be one big happy family. This also allows you to create different Netlify configs based on your roots environment.

It's also a common roots convention to start files with an _ to ignore them during compilation. Since Netlify would normally be configured with a _headers and _redirects file, using this extension allows you keep that nice clean convention throughout the whole project.

Installation & Usage

• make sure you are in your roots project directory
• npm install roots-netlify --save
• modify your app.coffee file to include the extension, as such

netlify = require 'roots-netlify'
 
module.exports =
  extensions: [
    netlify
      redirects: [
        '/news /blog 200'
        '/news/:year/:month:/:date/:slug /blog/:year/:month/:date/:story_id 200'
        '/news/* /blog/:splat 200'
        '/redirect / 301'
        '/temp_redirect / 302'
        '/ecommerce /closed 404'
      ]
      headers:
        '/protected/path':
          'Cache-Control': 'max-age: 3000'
          'Basic-Auth': 'username:password'
        '/*':
          'X-Frame-Options': 'DENY'
          'X-XSS-Protection': '1; mode=block'
  ]

Read the Netlify documentation on redirects and headers to learn more.

The redirects property accepts an array of redirects or rewrite rules (in order) with their respective HTTP code appended at the end as described in Netlify's documentation.

Promises

Instead of passing the regular options object into the extension, you can also pass a promise for an options object in case you need to perform any asynchronous work (such as loading a file or making an http request) before configuring roots-netlify.

fs     = require 'fs'
nodefn = require 'when/node'
yaml   = require 'js-yaml'
 
config = nodefn.call(fs.readFile, 'config.yaml')
  .then (contents) -> yaml.safeLoad(contents)
 
module.exports =
  extensions: [
    netlify(config)
  ]

License & Contributing

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