@dbosoft/nextjs-plugin

1.0.0 • Public • Published

@dbosoft/nextjs-plugin

A Next.js plugin with all of our default configuration, additional next plugins, custom webpack config, etc. This should be implemented by default for all of our web properties that are using Next.js.

Usage

The plugin looks like this inside of your next.config.js file:

const withDbosoftPlugin = require('@dbosoft/nextjs-plugin')

module.exports = withDbosoftPlugin(/* options */)(/* normal nextjs config */)

Let's go through the full options:

withDbosoftPlugin({
  css: {
    // array of postcss plugins
    plugins: [somePlugin(), otherPlugin()],
    // https://github.com/csstools/postcss-preset-env#options
    presetEnvOptions: { stage: 3 },
  },
  dato: { token: 'xxx', environment: 'xxx' }, // if necessary, override the default datocms token/env with your own
  tipBranch: 'main', // configure a branch name for tip.project.io subdomain, to ensure "noindex" http header is set
  transpileModules: ['foo'], // third party package names that should be transpiled by babel
})

All of these are optional, none are required to make withDbosoftPlugin function properly. In fact, we recommend not using any custom options unless you need to.

Default Plugins and Enhancements

Out of the box, this plugin adds a couple useful utilities:

These can both be used in any project implementing @dbosoft/nextjs-plugin as described in their readmes.

CSS Processing

nextjs-plugin configures a standard stack of postcss plugins, listed below:

If you'd like to add extra plugins before or after the stack, or change the options passed to postcss-preset-env, you can control this via the css options as such:

withDbosoftPlugin({
  css: {
    beforePlugins: [plugin1, plugin2],
    afterPlugins: [plugin3],
    presetEnvOptions: { nesting: false },
  },
})(/* normal nextjs config */)

Readme

Keywords

none

Package Sidebar

Install

npm i @dbosoft/nextjs-plugin

Weekly Downloads

0

Version

1.0.0

License

MPL-2.0

Unpacked Size

11.4 kB

Total Files

7

Last publish

Collaborators

  • dbosoft-package-maintainers
  • fwagner_dbosoft