Nuxt module to create new _headers, _redirects and netlify.toml files for Netlify or to use existing ones
Last updated 8 months ago by mannil .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @nuxtjs/netlify-files 
SYNC missed versions from official npm registry.


npm version npm downloads Github Actions CI Codecov License

Nuxt module to create new _headers, _redirects and netlify.toml files for Netlify or to use existing ones

???? Release Notes


  1. Add @nuxtjs/netlify-files dependency to your project
yarn add --dev @nuxtjs/netlify-files # or npm install --save-dev @nuxtjs/netlify-files
  1. Add @nuxtjs/netlify-files to the buildModules section of nuxt.config.js
export default {
  buildModules: [
    // Simple usage

    // With options
    ['@nuxtjs/netlify-files', { /* module options */ }]

:warning: If you are using Nuxt < v2.9 you have to install the module as a dependency (No --dev or --save-dev flags) and use modules section in nuxt.config.js instead of buildModules.

Using top level options

export default {
  buildModules: [
  netlifyFiles: {
    /* module options */



  • Type: Boolean
  • Default: true

Enable/disable copying of existing files.


  • Type: String
  • Default: srcDir

The directory where your _headers, _redirects and netlify.toml files that should be copied are located.


  • Type: Object or Function (must return Object)
  • Default: undefined

Object to create a netlify.toml from. If set, netlify.toml will not be copied, but programmatically created instead.



The module will look for _headers, _redirects and netlify.toml files and will copy them into the generate folder (default: dist) after static generation. If you have them directly in your project folder, you don't have to do anything else. In case the files are somewhere else, you can configure the directory (see below)

export default {
  netlifyFiles: {
    existingFilesDirectory: 'path/to/nuxt/directory', // The directory where your _headers, _redirects and netlify.toml files are located

Creating a new netlify.toml

For netlify.toml, instead of just copying it, it is also possible to create a new one. This could be useful if certain configurations need to be set dynamically. Since with netlify.toml also redirects and headers can be set, using this option makes it possible to dynamically create those as well, making _redirects and _headers files redundant.

Note that if netlifyToml is set, the module will create the new toml directly in the destination folder. It will ignore the netlify.toml (if it does exist) in the source folder.

export default {
  netlifyFiles: {
    netlifyToml: {
      build: {
        environment: { FOO: process.env.FOO }
      headers: [
          for: '/*',
          values: { 'X-XSS-Protection': '1; mode=block' }
      redirects: [
          from: '/old',
          to: '/new',
          status: 302


MIT License

Copyright (c) Nuxt Community

Current Tags

  • 1.2.0                                ...           latest (8 months ago)

3 Versions

  • 1.2.0                                ...           8 months ago
  • 1.1.0                                ...           9 months ago
  • 1.0.0                                ...           a year ago
Maintainers (1)
Today 0
This Week 1
This Month 5
Last Day 0
Last Week 2
Last Month 14
Dependencies (2)
Dev Dependencies (9)
Dependents (0)

Copyright 2014 - 2017 © taobao.org |