@vitus-labs/tools-nextjs

Opinionated Next.js configuration wrapper with sensible defaults.

Reads from vl-tools.config.mjs and applies security headers, image optimization, and TypeScript defaults.

Installation

bun add @vitus-labs/tools-nextjs

Peer dependency: next >= 14

Usage

Wrap your Next.js config:

// next.config.ts
import { withVitusLabs } from '@vitus-labs/tools-nextjs'

export default withVitusLabs({
  // standard next.config.ts options still work
  experimental: { ppr: true },
})

Configuration

Configure via vl-tools.config.mjs (key: next):

export default {
  next: {
    // Security headers — see options below (default: true)
    headers: true,
    // Image optimization
    images: {
      remotePatterns: [{ hostname: '*.example.com' }],
      formats: ['image/avif', 'image/webp'],
    },
    // Monorepo transpilation
    transpilePackages: ['@my-org/ui-core', '@my-org/ui-base'],
    // TypeScript (default: { ignoreBuildErrors: false })
    typescript: { ignoreBuildErrors: false },
  },
}

Defaults

Security headers

Applied to all routes by default:

| Header | Value | |---|---| | X-DNS-Prefetch-Control | on | | Strict-Transport-Security | max-age=63072000; includeSubDomains; preload | | X-Content-Type-Options | nosniff | | Referrer-Policy | origin-when-cross-origin | | X-Frame-Options | SAMEORIGIN | | Permissions-Policy | camera=(), microphone=(), geolocation=() |

The headers option accepts several forms:

// Enable all defaults
headers: true

// Disable security headers entirely
headers: false

// Override specific header values (others keep their defaults)
headers: { 'Permissions-Policy': 'camera=(self), microphone=(), geolocation=()' }

// Full control via callback
headers: (defaults) => defaults.filter(h => h.key !== 'X-Frame-Options')

TypeScript

Build errors are not ignored by default — strict type checking is enforced.

Exports

| Export | Description | |---|---| | withVitusLabs(config?) | Wraps Next.js config with defaults | | securityHeaders() | Returns the security headers array (for custom use) | | NextjsToolsConfig | TypeScript type for the config shape |

License

MIT