Skip to content

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

Open
Open
[BUG] CONTRIBUTING.md doesn't mention the Turbopack/--webpack requirement from the Next.js 16 upgrade#1780
Labels
bugSomething isn't working correctlydocumentationDocumentation improvementgssoc'26GirlScript Summer of Code 2026level:beginnerBeginner level - 20 ptstype:bugBug fixtype:docsDocumentation

Description

@magic-peach
magic-peach
opened on Sep 15, 2026

Bug description
Since the Next.js 16 upgrade, package.json's dev/build scripts explicitly pass --webpack to avoid Next 16's new Turbopack default, which would otherwise silently ignore next.config.ts's custom webpack config (needed for FFmpeg.wasm to load). This gotcha is explained only in a code comment in next.config.ts:10-12 — nowhere in CONTRIBUTING.md's "Development Tips" section (which is exactly where a contributor debugging a weird build issue, or "cleaning up" what looks like a redundant flag, would look).

Steps to reproduce
grep -i "turbopack\|webpack" README.md CONTRIBUTING.md → no hits outside next.config.ts itself.

Expected behavior
A short note in CONTRIBUTING.md's Development Tips explaining why --webpack is there and what breaks if it's removed.

Actual behavior
Undocumented outside a code comment — a contributor could plausibly "simplify" the scripts and silently break FFmpeg loading.

Activity

  1. magic-peach
    added
    bugSomething isn't working correctly
    documentationDocumentation improvement
    gssoc'26GirlScript Summer of Code 2026
    level:beginnerBeginner level - 20 pts
    type:docsDocumentation
    on Sep 15, 2026

  2. github-actions commented on Sep 15, 2026

    @github-actions
    github-actionsbot
    on Sep 15, 2026 – with GitHub Actions
    Contributor

    👋 Thanks for opening an issue, @magic-peach!

    Our maintainers will review this shortly 🚀

    Before you start working

    • 📖 Read the CONTRIBUTING.md guide
    • 💬 Wait for a maintainer to assign you the issue before starting work
    • 🔍 Search for existing issues to avoid duplicates

    For GSSoC'26 contributors

    If you're contributing under GirlScript Summer of Code 2026, please mention it in your comment when requesting assignment:

    "I'd like to work on this — contributing under GSSoC'26"

    Architecture notes

    Reframe is a static Next.js app with output: "export". Key points:

    • All video processing uses FFmpeg.wasm (client-side, no server)
    • headers() in next.config.ts won't work — use vercel.json instead
    • not-found.tsx requires public/404.html + vercel.json routes config

    Happy contributing! ⭐ Star the repo if you find it useful!

  3. github-actions
    added
    type:bugBug fix
    on Sep 15, 2026

  4. github-actions commented on Sep 15, 2026

    @github-actions
    github-actionsbot
    on Sep 15, 2026 – with GitHub Actions
    Contributor

    Claude encountered an error —— View job

    I'll analyze this and get back to you.

  5. godlykmathews commented on Oct 1, 2026

    @godlykmathews
    godlykmathews
    on Oct 1, 2026

    Hi, I would like to work this issue, I can update the manual.
    Is it available

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working correctlydocumentationDocumentation improvementgssoc'26GirlScript Summer of Code 2026level:beginnerBeginner level - 20 ptstype:bugBug fixtype:docsDocumentation

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions