Skip to main content
GoodFirstPicks
DashboardIssuesReposLeaderboard

GoodFirstPicks by Leaveitblank © 2026

CreatorRequest a RepoPrivacy PolicyTerms of Service
Inconsistent 404 Handling with Parallel Routes | GoodFirstPicks

Inconsistent 404 Handling with Parallel Routes

vercel/next.js 3 comments 8d ago
View on GitHub
highopenScope: somewhat clearSkill match: maybeTest focusedNext.jsTypeScriptReact

Why this is a good first issue

The issue involves complex routing behavior and inconsistent 404 handling in parallel routes.

AI Summary

The issue describes inconsistent 404 handling when navigating to non-existent pages within parallel routes. The problem requires understanding Next.js's routing system and debugging navigation behavior. The scope is somewhat clear but involves complex routing logic.

Issue Description

Link to the code that reproduces this issue

https://github.com/r4sheed/nextjs-parallel-routes-404-repro

To Reproduce

  1. Set up the project:

    • Option A: Clone the repository:
      git clone https://github.com/r4sheed/nextjs-parallel-routes-404-repro.git
      cd nextjs-parallel-routes-404-repro
      
    • Option B: Use CodeSandbox: Open the project directly in CodeSandbox: https://codesandbox.io/p/github/r4sheed/nextjs-parallel-routes-404-repro/master?import=true

    Ensure you have the project files as structured. The key files for reproducing the bug are:

    • src/app/(main)/layout.tsx (defines the main layout with the parallel route slot)
    • src/app/(main)/@breadcrumb/default.tsx
    • src/app/(main)/@breadcrumb/[...catchAll]/page.tsx (provides the content for the breadcrumb slot)
    • src/app/(main)/not-found.tsx (custom 404 page for the (main) group)
    • src/app/page.tsx (root page with a link to a non-existent page)
    • src/app/(main)/main-group-page/page.tsx (a page within the group, also with a link to a non-existent page)
    • src/app/(main)/exists/page.tsx (another page within the group)
  2. Install dependencies:

    npm install
    
  3. Run the development server:

    npm run dev
    
  4. Open the application: Open http://localhost:3000 in your browser.

  5. Test Scenario 1 (Correct 404):

    • On the home page (/), you will see a "Go to a page that does not exist (from root)" link.
    • Click this link.
    • Expected: You should see the "Not Found" page defined in src/app/(main)/not-found.tsx. The browser's network tools should show a 200 status for the navigation.
  6. Test Scenario 2 (Incorrect 200 OK):

    • Navigate back to the home page (/).

GitHub Labels

Parallel & Intercepting Routes

Want to work on this?

Claim this issue to let others know you're working on it. You'll earn 30 points when you complete it!

Risk Flags

  • parallel routes
  • 404 handling
  • navigation behavior
Loading labels...

Details

Points30 pts
Difficultyhigh
Scopesomewhat clear
Skill Matchmaybe
Test Focusedyes