Documentation

Next.js

The client bundle is browser-safe: no Node-only modules (fs, worker_threads, child_process) are bundled into client chunks. App Router + Turbopack (next dev / next build) is supported.

Maps on Next require MapLibre 6 worker wiring — setWorkerUrl plus copy workers into public/. This applies to both Turbopack and webpack.

transpilePackages

// next.config.js
const nextConfig = {
  transpilePackages: ['@infoplaza/platform'],
}

module.exports = nextConfig

CSS in a Tailwind host

This documentation site and demo-next import @infoplaza/platform/styles.css plus MapLibre CSS in the root layout. Host apps that already run Tailwind should prefer @infoplaza/platform/styles.embed.css so preflight does not reset the site. See Styling.

Auth route

Mount the catch-all at app/api/platform/[...platform]/route.ts as shown in Server setup. Create a token on the Infoplaza developer platform and keep PLATFORM_API_KEY server-side.

geotiff

geotiff is an optional dependency (only needed for GeoTIFF tile decoding). If you do not install it, GeoTIFF decoding throws a descriptive error; everything else works. It is loaded lazily via an external dynamic import('geotiff') so the host bundler applies its own browser resolution.

Webpack fallback

If you hit a bundler edge case, the webpack builder remains a fallback: next dev --webpack / next build --webpack.