Skip to content

docs(contributing): document Next.js 16 --webpack requirement for FFmpeg.wasm - #1821

Open
chiragjangiir wants to merge 1 commit into
reframe-oss:mainfrom
chiragjangiir:fix/contributing-webpack-turbopack-note-1780
Open

chiragjangiir wants to merge 1 commit into
reframe-oss:mainfrom
chiragjangiir:fix/contributing-webpack-turbopack-note-1780

Conversation

@chiragjangiir

Copy link
Copy Markdown

Description

Resolves #1780.

Following the Next.js 16 upgrade, package.json's dev and build scripts explicitly pass --webpack because Next.js 16 defaults to Turbopack. Turbopack ignores or errors on next.config.ts's custom Webpack configuration (config.resolve.fallback = { fs: false }), which is strictly required for @ffmpeg/ffmpeg WebAssembly resolution.

Previously, this requirement was only noted in a brief code comment inside next.config.ts. Contributors looking through developer documentation could inadvertently remove or "simplify" the scripts without knowing it breaks WebAssembly loading.

Changes

  • Added section 9. Webpack Requirement for Next.js 16 (--webpack) to CONTRIBUTING.md under Development Tips detailing why --webpack is present and why removing it breaks FFmpeg.wasm loading.

Verification

  • Ran bun run lint (passed with 0 errors).
  • Validated markdown structure and links against next.config.ts and package.json.

@netlify

netlify Bot commented Oct 21, 2026

Copy link
Copy Markdown

👷 Deploy request for reframe-os pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit c442eaa

@github-actions

Copy link
Copy Markdown
Contributor

👋 Thanks for your PR, @chiragjangiir!

Welcome to Reframe — a browser-based video editor built for everyone 🎬

What happens next

  1. 🤖 Automated checks — build & TypeScript typecheck will run automatically
  2. ✅ Vercel preview — a preview deployment will be created (requires maintainer authorization for fork PRs)
  3. 👀 Code review — a maintainer will review your changes
  4. 🚀 Merge — once approved, your PR will be merged!

Quick checklist

  • PR title follows Conventional Commits (e.g. feat: add dark mode)
  • Linked the issue this PR closes (e.g. Closes #123)
  • Tested the changes locally (bun run dev)
  • Build passes (bun run build)

Useful links

Happy coding! 🎉

@github-actions

Copy link
Copy Markdown
Contributor

✅ PR Format Check Passed — @chiragjangiir

Basic format checks passed. A maintainer will review your code changes.

This does not mean the PR is approved — it just means the format is correct.

@github-actions github-actions Bot added level:beginner Beginner level - 20 pts type:docs Documentation labels Oct 21, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

level:beginner Beginner level - 20 pts type:docs Documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BUG] CONTRIBUTING.md doesn't mention the Turbopack/--webpack requirement from the Next.js 16 upgrade

1 participant