Dynamic Routing — Complete Guide
Dynamic Routing — Complete Guide: free step-by-step lesson with examples, common mistakes, and interview tips — part of Next.js Tutorial on Toolliyo Academy.
On this page
Next.js Tutorial (LearnHub) · Lesson 10 of 100
Dynamic Routing
Beginner → Intermediate → Advanced → Professional
Beginner · 1 — Foundations · ~12 min read · Module 1: Next.js Foundations
Introduction
This lesson is part of the beginner section. We explain Dynamic Routing slowly, with examples you can copy and run. If something is unclear, read it twice — that is how everyone learns. Dynamic routes use [param] folders. The page receives params — in Next.js 15+, params is a Promise you await. LearnHub uses this for /courses/[slug] and /lessons/[lessonId]. You cannot create one file per course — there may be hundreds. One dynamic page template loads the right course by slug.
Dynamic Routing is setup knowledge. Without it, LearnHub will not run. Spend time here until npm run dev works without errors.
When will you use this?
You need this before writing any Next.js code — same as installing Node.js before opening a project.
- Every React/Next.js job expects you to run npx create-next-app and npm run dev on day one.
- Interviewers often ask you to explain the App Router folder structure and Server vs Client Components.
Real-world: NewsDaily portal
The Media team building NewsDaily portal uses Dynamic Routing to show one lesson page per course slug from a single page.tsx template. readers and editors never see the TypeScript files — they just get a fast, reliable article pages, categories, and SEO metadata.
Production-style code
// app/courses/[slug]/page.tsx
type Props = { params: Promise<{ slug: string }> };
export default async function CoursePage({ params }: Props) {
const { slug } = await params;
return <h1>Course: {slug}</h1>;
}
What happens in production: In NewsDaily portal, getting Dynamic Routing right means readers and editors trust the article pages, categories, and SEO metadata every day.
Lesson example (start here)
Copy this smaller example first. Once it works, compare it with the real-world code above.
// app/courses/[slug]/page.tsx
type Props = { params: Promise<{ slug: string }> };
export default async function CourseDetailPage({ params }: Props) {
const { slug } = await params;
return (
<main>
<h1>Course: {slug}</h1>
<p>Lessons for this course load here.</p>
</main>
);
}
Line-by-line walkthrough
| Code | What it means |
|---|---|
// app/courses/[slug]/page.tsx | Comment — notes for humans; the compiler ignores it. |
type Props = { params: Promise<{ slug: string }> }; | Part of the Dynamic Routing example — read it together with the lines before and after. |
export default async function CourseDetailPage({ params }: Props) { | Default export — the main page or component this file provides to Next.js. |
const { slug } = await params; | Part of the Dynamic Routing example — read it together with the lines before and after. |
return ( | Returns JSX — what the user sees in the browser. |
<main> | Part of the Dynamic Routing example — read it together with the lines before and after. |
<h1>Course: {slug}</h1> | Part of the Dynamic Routing example — read it together with the lines before and after. |
<p>Lessons for this course load here.</p> | Part of the Dynamic Routing example — read it together with the lines before and after. |
</main> | Part of the Dynamic Routing example — read it together with the lines before and after. |
); | Part of the Dynamic Routing example — read it together with the lines before and after. |
} | Closes a block started by { above. |
How it works (big picture)
- await params unwraps the slug from the URL.
- Later you will fetch course by slug from the database.
- generateStaticParams can pre-build popular courses at deploy time.
Do this on your computer
- Create app/courses/[slug]/page.tsx
- Visit /courses/nextjs-fundamentals
- Log slug in the server console during dev
- Add a second dynamic segment lessons/[lessonId] under the course folder
- Read the real-world section and name which part of LearnHub uses this topic.
- Run the example locally with npm run dev and confirm the same behavior.
- Change one value in the example (route, text, or course id) and predict what will happen before you save.
Experiments — try changing this
- Change a string or route in the example and save — watch the browser update.
- Break the code on purpose (remove a bracket), read the error overlay, then fix it.
- Change the API URL or course id and see how the page data changes.
Remember
[slug] captures URL segment. await params in modern Next.js. One template serves many courses.
Common questions
generateStaticParams?
Optional function to pre-render known slugs at build time — great for top courses.
How long should I spend on Dynamic Routing?
Until you can explain it in your own words and run the example without looking at the answer. Beginners often need 30–60 minutes per new concept; setup lessons may take one afternoon.
What if I get stuck on Dynamic Routing?
Re-read the line-by-line walkthrough, check the terminal and browser overlay for errors, and compare your code character-by-character with the example. Search the exact error text — someone else had it too.
Where is Dynamic Routing used in real jobs?
See the real-world section above — the same pattern appears in LMS, e-commerce, SaaS, and dashboards. Interviewers ask you to explain it using one concrete example.