Changelog

0.3.0 (2026-07-29)

Features

  • Export the WithQRCodeOptions type for TypeScript consumers

  • Add host option to use a custom host/IP in the printed URL instead of the auto-detected local IP

  • Add https option to print the URL with https:// instead of http:// (default false)

  • Add enabled option to fully disable the plugin — skips validation and printing (e.g. enabled: !process.env.CI)

  • Default path to nextConfig.basePath when options.path is not set, so apps with a configured base path no longer need to repeat it

0.2.0 (2026-07-28)

Features

  • Add withQRCode config wrapper — works with both webpack and Turbopack, no bundler integration required
  • Auto-detect the actual dev server port (including automatic fallback when the requested port is in use)
  • Print QR code only once, even though Next.js evaluates the config in several processes

Deprecations

  • QRCodePlugin (webpack-only) is deprecated in favor of withQRCode; it keeps working for existing setups

0.1.1 (2025-11-28)

Documentation

  • Add webpack/Turbopack compatibility

0.1.0 (2025-11-28)

First stable release

Features

  • Display QR code in terminal on Next.js dev server start
  • Auto-detect local IP address
  • Configurable port and path options
  • TypeScript support with full type definitions
  • Validation for port (1-65535) and path options
  • Comprehensive test suite with 33 tests
  • Utility functions extracted for better maintainability

Documentation

  • Complete README with usage examples
  • Screenshot showing QR code in terminal
  • Installation and configuration guide