DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
Skip to content
World desk5 min

How to Build a Client-Side QR Code Toolkit with Next.js 16

Build a Next.js 16 QR Code toolkit with a small Client Component boundary, browser-safe rendering, QR design fundamentals, and static export.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

You can build a QR code toolkit with Next.js 16 and deploy it as a static site, provided QR generation runs in the browser and the app does not rely on Next.js features that require a server at runtime. The key is to keep interactive code behind a small Client Component boundary, avoid accessing browser APIs during server prerendering, and preserve the QR symbol’s quiet zone when displaying or exporting it.

Plan the client-side boundary

In the Next.js App Router, pages and layouts are Server Components by default. Use a Client Component for the parts of a QR toolkit that need state, event handlers, lifecycle logic, browser APIs, or custom hooks—for example, a text input whose value updates a generated symbol. Add "use client" at the top of the module that defines that boundary.

As an Amazon Associate I earn from qualifying purchases.

The directive affects the module graph: imports and child components beneath that boundary are included in the client bundle. Keep it as narrow as practical. Static instructions, headings, and other content that do not need interaction can remain server-rendered, while the generator itself handles its interactive state.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Account for prerendering

A Client Component is not necessarily rendered only in a browser. Next.js can prerender Client Components to HTML during next build, so code must not assume browser globals exist during rendering. Objects such as window, localStorage, and navigator are unavailable on the server.

#1 Best Overall
Eyoyo EYH2 Handheld USB Wired 2D 1D Barcode Scanner for POS Mobile Payment
  • Continuous Usage All Day: The EY-H2 USB barcode scanner is designed to always be ready for the next scan, which significantly reduces downtime and repair costs; it shortens checkout lines, improves customer service, and boosts business productivity
  • Plug and Play: Eyoyo wired barcode scanner is connected via a USB cable, with no need to install any driver or software; It offers effortless connection and is compatible with Windows, Mac, Android, and Linux; Seamlessly works with Quickbook, Word, Excel, Novell, and all common software
  • Supports Multiple 1D/2D Barcodes: Eyoyo QR code scanner scan with most 1D 2D barcodes with ease; 1D Barcodes: EAN, UPC, Code 39, Code 93, Code 128, UCC/EAN 128, Codabar, Interleaved 2 of 5, ITF-6, ITF-14, ISBN, ISSN, MSI-Plessey, GS1 Databar, Code 11, Industrial 25, Matrix 2 of 5, etc. 2D Barcodes: QR, DataMatrix, PDF417, and so on
  • Supports Screen Scanning: The Eyoyo 2D scanner is capable of reading barcodes from smartphone screens, such as mobile coupons, digital wallets, and digital loyalty cards; Before scanning, simply turn your screen brightness to the maximum
  • Sturdy Anti-Shock and Durable Design: The Eyoyo 2D barcode scanner features an ergonomic design made of high-quality ABS, enabling it to withstand repeated drops from 5 ft/1.5 m high onto the concrete ground; The durable plastic material ensures a long service life

Access browser-only APIs during browser execution, such as inside an effect, rather than at module scope or in code that runs while the component renders. If the QR library you select touches browser globals as soon as it is imported or rendered, follow that library’s documented requirements and isolate or dynamically load it as appropriate. The correct treatment depends on the library; there is no universal package-specific fix.

Generate the symbol in the browser

Choose a QR library based on the features the toolkit actually needs. Check its documentation for supported payload characters, output formats and resolution, and how it handles margins. The Next.js and QR Code sources cited here do not establish a particular library, API, file format, or browser-compatibility result, so those details should be verified for the package you use.

Rank #2
Tera Barcode Scanner with Battery Indicator: 2D Wireless, D5100 Orange
  • 【Battery Level Indicator and 2200mAh Capacity】Larger battery enables longer continuous usage and twice the stand-by time of others. With the unique battery indicator light showing the remaining battery level, no more Low Battery Anxiety.
  • 【Ergonomic Design】 The curved handle is extended and thickened, tailor-made for North America customers. Specially designed smooth and flat trigger for better grip. 【Package Includes】Barcode Scanner x1, USB Cable x1, Dongle x1, User Manual x1.
  • 【Anti-Shock Silicone】 The orange anti-shock silicone protective cover can avoid scratches and friction while falling from the height of 6.56 feet. IP54 technology protects the wireless barcode scanner from dust.
  • 【2.4 GHz Wireless plus USB 2.0 Wired Connection】 Plug and play with the USB receiver or the USB cable, no driver installation needed. Easy and quick to set up. Wireless transmission distance reaches up to 328 ft. in barrier free environment.
  • 【Digital and Printed 1D 2D QR Bar Code Symbologies】1D: Codabar, Code 11, Code93, MSI, Code 128, UCC/EAN-128, Code 39, EAN-8, EAN-13, UPC-A, ISBN, Industrial 25, Interleaved 25, Standard25, Matrix 2D: QR, DataMatrix, Aztec, Hanxin, Micro PDF417. (Note: Not compatible with Square.)

If the generator creates the QR symbol locally and does not send the payload in a network request, the generation step itself need not transmit that content to a server. That does not establish that the whole application is private: analytics, remote fonts, or other services could still make network requests. Check the app’s network behavior before making a broader privacy claim.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose an error-correction level

QR Code offers four standard error-correction levels: L, M, Q, and H. Raising the level improves correction capability but uses more of the symbol’s data capacity, leaving less room for the payload. DENSO WAVE’s technical guidance says, “Typically, Level M (15%) is most frequently selected.” That is general guidance, not a rule for every use case.

Rank #3
Tera Barcode Scanner with Battery Indicator: 2D Wireless, D5100, Blue
  • 【Battery Level Indicator and 2200mAh Capacity】Larger battery enables longer continuous usage and twice the stand-by time of others. With the unique battery indicator light showing the remaining battery level, no more Low Battery Anxiety.
  • 【Ergonomic Design】 The curved handle is extended and thickened, tailor-made for North America customers. Specially designed smooth and flat trigger for better grip. 【Package Includes】Barcode Scanner x1, USB Cable x1, Dongle x1, User Manual x1
  • 【Anti-Shock Silicone】 The orange anti-shock silicone protective cover can avoid scratches and friction while falling from the height of 6.56 feet. IP54 technology protects the wireless barcode scanner from dust.
  • 【2.4 GHz Wireless + USB 2.0 Wired Connection】 Plug and play with the USB receiver or the USB cable, no driver installation needed. Easy and quick to set up. Wireless transmission distance reaches up to 328 ft. in barrier free environment.
  • 【Digital and Printed 1D 2D QR Bar Code Symbologies】1D: Codabar, Code 11, Code93, MSI, Code 128, UCC/EAN-128, Code 39, EAN-8, EAN-13, UPC-A, ISBN, Industrial 25, Interleaved 25, Standard25, Matrix 2D: QR, DataMatrix, PDF417, Aztec, Hanxin, Micro PDF417. (Note: Not compatible with Square.)

For a toolkit that offers a correction setting, make the trade-off clear to users:

  • Correction capability: Higher levels can recover from more damage or obstruction.
  • Payload capacity and density: Higher levels consume more capacity. For the same payload, the symbol may need to be denser or larger.
  • Use conditions: Consider payload length, the size at which the code will be displayed or printed, and the environment in which it will be scanned.

Do not treat error correction as a substitute for good layout. It does not guarantee that a code with an obstructed finder pattern or missing quiet zone will scan reliably.

Rank #4
Sale
Tera Barcode Scanner Wireless with Screen: Pro Version 1D 2D QR with Setting Keypad Charging Cradle Works with Bluetooth 2.4G Wireless USB Wired Handheld Bar Code Reader HW0009
  • 【Unique Designed Screen Setting】It allows you to customize the screen display according to your preferences. With this innovative feature, you can easily set the language, adjust volume settings, select connection options, and view stored and total barcodes. Experience unparalleled convenience and flexibility as you personalize the settings of your Tera HW0009 to suit your specific needs. 【Package Includes: Barcode Scanner x1, Charging Cradle x1, Charging Cable x1, User Manual x1】
  • 【Superior Global CMOS Imaging Scanning】This advanced scanner excels in fast and accurate reading of both ordinary and high-density barcodes, including challenging formats like PDF417 found on driver's licenses. Its exceptional performance effortlessly handles various scanning scenarios, including underwater scanning, reading barcodes on silver paper, reflective materials, and more.
  • 【Charging Cradle & 2500mAh Large Battery】Designed with a convenient charging cradle, the HW0009 barcode scanner allows you to easily charge it whenever it's not in use. In addition, the scanner itself is equipped with a powerful 2500mAh battery, ensuring seamless all-day operation without the need for frequent charging.
  • 【3-in-1 Connections & Widely Compatible】 Tera HW0009 wireless barcode scanner can work with bluetooth & 2.4G wireless & usb wired. The transmission distance can be 328ft in barrier free environment and 114ft in obstacles environment using 2.4G USB dongle. It can be connected with a variety of devices, such as smartphones, computers, POS, tablets. In addition, it is also compatible with various operating systems, such as windows 11/10/8/7/xp, Mac OS, iOS, android, linux.
  • 【1D 2D QR code Programmable】2D: QR code, Data Matrix, PDF417(including PDF417 on driver’s license), Aztec, Maxicode, Micro QR, Micro PDF417; 1D: UPC/EAN, Code 128/EAN128, GS1-128, ISBT-128, Standard 2 of 5, Matrix 2 of 5, Code 39, Code 32, Code 93, Code 11, Codabar, PLESSEY, MSI, GSI Databar, ITF-14, GS1.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Understand payload size and symbol dimensions

QR Code versions range from Version 1, which is 21 × 21 modules, to Version 40, which is 177 × 177 modules; each successive version adds four modules per side. DENSO WAVE does not state a publication year for these figures. The version and resulting dimensions depend on the payload’s length and character type as well as the selected correction level, so there is no single capacity figure that applies to every input.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A short value can fit in a smaller symbol, while a long URL or arbitrary text can require a larger, denser one. When checking a library’s output, confirm that it supports the characters your users may enter and that the resulting symbol remains readable at the intended display or print size. Test actual outputs with the chosen library rather than assuming one fixed maximum length.

Best Value
Tera Barcode Scanner 2D Portable Wireless: BT 2.4G USB Pocket Reader, 1200
  • 【IP66 Waterproof Dustproof Mini Pocket 2D Scanner】Just bring this scanner with you. Anytime you want to collect data, just connect it with your device via Bluetooth or use the storage mode. 【Package Includes】Barcode Scanner x1, USB Cable x1, Dongle x1, User Manual x1.
  • 【Waterproof Dustproof Silicone Port Plug】Newly designed waterproof and dustproof silicone port plug on marketplace, it enables better performance of the scanner in every working conditions. The silicone button on the scanner body enables every soft and smooth scanning experience.
  • 【3-in-1 Connection Ways】This scanner works with Bluetooth, 2.4GHz wireless and USB 2.0 wired mode. The transmission distance can be 656ft in barrier free environment and 98 ft in an environment with obstacles using a 2.4G USB dongle. In addition, it is also compatible with various operating systems, such as windows 11/10/8/7/xp, Mac OS, iOS, android, linux.(Note: Not Compatible with Square)
  • 【Vibration Alert】: When you need a quiet working environment, just turn the volume off and the vibration function will let you know if a barcode is detected.
  • 【1D 2D QR Scanner】:Supports Both Digital and Printed 1D 2D QR Bar Code Symbologies: 1D Decode Capability: Codabar, Code 11, Code93, MSI, Code 128, UCC/EAN-128, Code 39, EAN-8, EAN-13, UPC-A, ISBN, Industrial 25, Interleaved 25, Standard 25, 2/5 Matrix 2D Decode Capability: QR, PDF417, Data Matrix, Aztec code, Maxi Code.

Preserve the four-module quiet zone

A regular QR Code requires a clear quiet zone four modules wide on every side, according to DENSO WAVE’s technical guidance. Include that margin in the full area needed to display or print the code; the symbol’s module dimensions alone do not describe its complete footprint.

When configuring a library or styling a preview, ensure the clear border remains intact in the exported image and in any printed version. Avoid cropping the margin or placing nearby text and graphics into it. Evaluate the result at the size and on the medium where people will scan it.

Deploy as a static Next.js site

For an app whose QR generation happens in the browser, Next.js static export can produce assets for a static web server, as long as the routes and features do not depend on an unsupported Next.js runtime. Set output: 'export' in next.config.js, then run a production build with next build. The build emits an out folder containing HTML, CSS, and JavaScript assets that can be served by a web server capable of serving static files.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Static export does not support every Next.js feature. Runtime-dependent features such as Server Actions, cookies, request-dependent route handlers, rewrites, redirects, headers, and Incremental Static Regeneration (ISR) are unsupported in export mode. If the toolkit needs one of those features, a purely static deployment is not suitable without changing the design or deployment approach.

Review the finished toolkit

Before publishing, evaluate the implementation with the actual QR library and deployment configuration you chose:

  • Confirm that browser globals are accessed only during browser execution, not during server prerendering.
  • Check that the selected library supports the payload characters and output format the interface promises.
  • Inspect generated symbols for a retained four-module quiet zone and adequate output resolution.
  • Scan examples at their intended display or print size, including longer inputs and each offered correction level.
  • Verify that static export completes and that the exported pages work from the intended static web server.
  • Inspect network requests before describing the tool as private or claiming that payloads never leave the device.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.