NEXERED

Support Next.js redirects in your hosting provider

Next.js redirects defined in next.config.js do not work in static HTML exports.

However, in many hosting providers (for example Cloudflare Pages) it is possible to define a static redirect config (for example _redirects file).

This package aims to parse existing next.config.js and automatically define configuration for those third party hosting providers.

Get started

1. Install nexered using your package manager

   yarn add nexered

   or if you're using npm

   npm install nexered

2. Add nexered to the postbuild (or the post- script of the static export script if it's named differently) step in package.json

   {
       "scripts": {
           "postbuild": "nexered --provider=cloudflare-pages"
       }
   }

3. ...

4. Profit

Supported providers

• Cloudflare Pages

  Supports :wildcards* and :slugs and same status codes as next.js

  Example:

  // next.config.js
  /**
   * @type {import('next').NextConfig}
   */
  const nextConfig = {
      basePath: "/base-path",
      async redirects() {
          return [
              {
                  source: '/old-page',
                  destination: '/new-page',
                  permanent: true,
              },
              {
                  source: '/old-wildcard/:path*',
                  destination: '/new-wildcard/:path*',
                  permanent: false
              },
              {
                  source: '/old-blog/:slug',
                  destination: '/new-blog/:slug',
                  permanent: true,
              },
              {
                  source: '/without-base-path',
                  destination: '/absolute-path',
                  basePath: false,
                  permanent: false,
              },
              {
                  source: '/custom-status-code',
                  destination: '/status-code-303',
                  statusCode: 303
              }
          ];
      },
  };
  
  module.exports = nextConfig;

  // out/_redirects
  /base-path/old-page /base-path/new-page 308
  /base-path/old-wildcard/* /base-path/new-wildcard/:splat 307
  /base-path/old-blog/:slug /base-path/new-blog/:slug 308
  /without-base-path /absolute-path 307
  /base-path/custom-status-code /base-path/status-code-303 303

Usage

nexered --p=cloudflare-pages

Options:
      --help      Show help                                            [boolean]
      --version   Show version number                                  [boolean]
  -p, --provider  hosting provider type [required] [choices: "cloudflare-pages"]
  -o              `next export` output directory as described in
                  https://nextjs.org/docs/api-reference/next.config.js/exportPat
                  hMap#customizing-the-output-directory[string] [default: "out"]
      --dir       next project directory containing `next.config.js`
                                                         [string] [default: "."]