🗺️ Next.js File-based Routing: Your App’s GPS System

The Big Idea: Folders = Roads in Your App

Imagine your favorite pizza place. When you walk in, there are clear signs:

• “Order Here” → takes you to the counter
• “Pick Up” → takes you to get your food
• “Restrooms” → you know where that goes!

Next.js routing works exactly like this. Your folders are the signs, and your files are the destinations. No complicated setup needed—just create a folder, and boom, you have a new page!

🏠 Pages and Routes: Building Your First Rooms

What’s a Route?

A route is just a path in your website’s address bar. Like:

• mysite.com/ → Home
• mysite.com/about → About page
• mysite.com/contact → Contact page

How Next.js Makes This Easy

In Next.js (App Router), you create routes by making folders inside the app folder:

app/
├── page.tsx      → mysite.com/
├── about/
│   └── page.tsx  → mysite.com/about
└── contact/
    └── page.tsx  → mysite.com/contact

That’s it! Folder name = URL path. Simple as pizza!

Real Example

Want a blog section? Just create:

app/
└── blog/
    └── page.tsx

Now mysite.com/blog works automatically. Magic? Nope—just smart design!

📄 Page Component: The Star of Every Route

What Makes a Page Special?

Every route needs one special file called page.tsx (or page.js). This file is like the welcome mat for that route—it’s what visitors see first.

Your First Page Component

// app/about/page.tsx

export default function AboutPage() {
  return (
    <div>
      <h1>About Us</h1>
      <p>We make awesome apps!</p>
    </div>
  );
}

The Secret Rules

1. Must be named page.tsx - Other names won’t work
2. Must export a default function - This is your component
3. One per folder - Each route gets one page

Think of it like a house: each room (folder) can only have one front door (page.tsx).

🎭 Dynamic Routes: One Template, Many Pages

The Problem

Imagine you have 1000 products. Do you create 1000 folders?

• app/product-1/page.tsx
• app/product-2/page.tsx
• … (yikes!)

NO WAY! That’s crazy talk!

The Solution: Square Brackets

Use [squareBrackets] to create a flexible route:

app/
└── products/
    └── [id]/
        └── page.tsx

Now ONE file handles:

• mysite.com/products/1
• mysite.com/products/999
• mysite.com/products/cool-sneakers

Getting the Dynamic Value

// app/products/[id]/page.tsx

export default function ProductPage({
  params
}: {
  params: { id: string }
}) {
  return (
    <h1>Product: {params.id}</h1>
  );
}

Visit /products/42 → Shows “Product: 42” Visit /products/pizza → Shows “Product: pizza”

One file. Infinite possibilities! 🚀

🎣 Catch-all Routes: The Super Net

When Dynamic Routes Aren’t Enough

What if your URL has multiple parts?

• /docs/getting-started
• /docs/api/hooks/useState
• /docs/advanced/patterns/context/deep-dive

Each has a different number of segments. Dynamic routes can’t handle this alone.

Enter the Triple Dot: [...slug]

app/
└── docs/
    └── [...slug]/
        └── page.tsx

The ... is like a fishing net—it catches EVERYTHING after /docs/.

How It Works

// app/docs/[...slug]/page.tsx

export default function DocsPage({
  params
}: {
  params: { slug: string[] }
}) {
  // slug is an ARRAY of all segments
  return (
    <div>
      <p>Path: {params.slug.join(' → ')}</p>
    </div>
  );
}

⚠️ Important Catch

/docs alone won’t work with [...slug]. You need at least ONE segment after /docs.

🎯 Optional Catch-all Routes: The Friendly Net

The Problem with Catch-all

Remember: /docs alone doesn’t work with [...slug].

But what if you WANT /docs to also show something?

The Solution: Double Brackets [[...slug]]

app/
└── docs/
    └── [[...slug]]/
        └── page.tsx

The extra brackets make the catch-all optional.

Now Everything Works!

// app/docs/[[...slug]]/page.tsx

export default function DocsPage({
  params
}: {
  params: { slug?: string[] }
}) {
  if (!params.slug) {
    return <h1>Welcome to Docs!</h1>;
  }

  return (
    <h1>Reading: {params.slug.join('/')}</h1>
  );
}

Best of both worlds! 🎉

📁 Route Groups: The Invisible Organizers

The Messy Problem

Your app grows. Files everywhere:

app/
├── login/
├── register/
├── forgot-password/
├── dashboard/
├── settings/
├── profile/
└── ...20 more folders

Chaos! You want to organize these, but folders change URLs…

The Magic Parentheses: (groupName)

Folders with parentheses () are invisible in the URL!

app/
├── (auth)/
│   ├── login/
│   │   └── page.tsx    → /login
│   ├── register/
│   │   └── page.tsx    → /register
│   └── forgot-password/
│       └── page.tsx    → /forgot-password
│
└── (dashboard)/
    ├── settings/
    │   └── page.tsx    → /settings
    └── profile/
        └── page.tsx    → /profile

Why This is Awesome

1. Organization - Related pages grouped together
2. Shared Layouts - Each group can have its own layout
3. Clean URLs - (auth) doesn’t appear in the address bar

Shared Layout Example

// app/(auth)/layout.tsx
// This layout wraps login, register, forgot-password

export default function AuthLayout({
  children
}: {
  children: React.ReactNode
}) {
  return (
    <div className="auth-container">
      <img src="/logo.png" alt="Logo" />
      {children}
    </div>
  );
}

All auth pages now share the same logo and container—without affecting their URLs!

🗺️ The Complete Picture

graph TD
    A[app/] --> B[page.tsx]
    A --> C[about/]
    C --> D[page.tsx]
    A --> E["[id]/"]
    E --> F[page.tsx]
    A --> G["[...slug]/"]
    G --> H[page.tsx]
    A --> I["[[...opt]]/"]
    I --> J[page.tsx]
    A --> K["#40;group#41;/"]
    K --> L[route/]
    L --> M[page.tsx]

    B --> B1["/"]
    D --> D1["/about"]
    F --> F1["/123, /abc"]
    H --> H1["/a/b/c"]
    J --> J1["/ or /x/y"]
    M --> M1["/route"]

🎓 Quick Reference

🚀 You Did It!

You now understand Next.js file-based routing like a pro:

1. Folders = URLs - Simple and intuitive
2. page.tsx = Content - The welcome mat for each route
3. [brackets] = Dynamic values
4. […spread] = Catch multiple segments
5. [[…optional]] = Catch OR skip
6. (parentheses) = Invisible organization

The beauty of Next.js routing? Your file structure IS your sitemap. No config files. No router setup. Just folders and files, working together like a well-organized library.

Now go build something amazing! 🎨✨