#17
docs(bundling): document standalone output tracing excludes
Standalone Output Tracing
Description
This PR adds documentation for handling problematic dependencies in standalone builds via outputFileTracingExcludes.
Changes
- Tracing Excludes: Documentation on excluding native bindings or mobile-only packages from the Next.js standalone output tracing.
- Configuration Example: Practical example using
next.config.mjsto prevent build-time crashes during the asset-copying phase.
Rationale
When using output: 'standalone' in a monorepo that shares code with mobile apps, Next.js often attempts to trace and copy native dependencies that are not relevant to the web build. This frequently results in "file not found" crashes during the build phase; explicit excludes are the recommended fix for these environments.