Dynamic Routing

All Next.js topics
∙ Next.js

Dynamic routes use bracketed folder names such as [slug] to match variable URL segments. This lesson explains how it works, when to use it, how to implement it safely, and how to verify the result.

📝Syntax
app/posts/[slug]/page.tsx
💻Example
// Topic: Dynamic Routing
import { notFound } from 'next/navigation';

export default async function PostPage({ params }) {
  const { slug } = await params;
  const post = await getPost(slug);
  if (!post) notFound();

  return <h1>{post.title}</h1>;
}
👁Expected Output
The URL slug selects the matching post.
🔍Line-by-line
LineMeaning
import { notFound } from 'next/navigation';Imports a component or framework API used by the example.
export default async function PostPage({ params }) {Exports the React component that Next.js renders for the route.
const { slug } = await params;Reads the resolved dynamic route parameters.
const post = await getPost(slug);Stores a value used later in the example.
if (!post) notFound();Stops rendering and displays the nearest not-found UI.
return <h1>{post.title}</h1>;Returns the response or interface produced by the function.
}Forms part of the component, server operation, or configuration shown above.
🌎Real-World Uses
  • 1Dynamic Routing is useful for building multi-page applications with stable URLs, shared layouts, and deep links.
  • 2For /posts/hello, a route at app/posts/[slug]/page.tsx receives hello as the slug parameter.
  • 3A team should use it when the requirement matches its responsibility in routing.
  • 4It should fit the surrounding route, data, security, and deployment design instead of being added in isolation.
  • 5A successful implementation is visible through correct URLs, predictable layouts, and navigation without full-page reloads.
  • 6SaaS products use Dynamic Routing in services, dashboards, background jobs, and API workflows.
  • 7ERP and banking systems apply Dynamic Routing with validation, logging, review, and rollback plans.
  • 8E-commerce and healthcare platforms use Dynamic Routing carefully because reliability and data correctness matter.
Common Mistakes
  • 1Assuming every parameter maps to valid data can produce broken pages or expose records without proper authorization.
  • 2Copying an example without identifying which code runs on the server and which code reaches the browser.
  • 3Handling only the happy path and forgetting loading, empty, invalid, unauthorized, and failed states.
  • 4Adding client state or third-party libraries before confirming that built-in Next.js and browser features are insufficient.
  • 5Skipping verification in a production build, where caching and runtime behavior can differ from development.
  • 6Skipping the small working example before adding framework code.
  • 7Ignoring null, empty, duplicate, and boundary inputs.
  • 8Mixing business logic, input handling, and output formatting in one place.
  • 9Using broad error handling that hides the real failure.
  • 10Forgetting to test the behavior after refactoring.
  • 11Adding clever code that future maintainers will struggle to read.
  • 12Not checking performance on realistic input sizes.
Best Practices
  • 1Validate route parameters, fetch the matching record on the server, and call notFound() when no resource exists.
  • 2Keep the owning route, component, server function, and validation responsibility easy to identify.
  • 3Use server-side code for trusted data and secrets; send only the data required by interactive browser components.
  • 4Make loading, empty, success, and error states explicit for the user.
  • 5Test a valid value, an unknown value, encoded characters, direct refresh, generated static parameters, and permission checks.
  • 6Start with clear requirements and one minimal working example.
  • 7Use meaningful names that explain business intent.
  • 8Keep examples small enough to debug line by line.
  • 9Validate input at every trust boundary.
  • 10Handle errors explicitly and preserve useful context.
  • 11Prefer simple control flow over deeply nested logic.
  • 12Separate domain logic from I/O and framework code.
  • 13Write tests for normal, boundary, and failure cases.
  • 14Review security assumptions before production use.
  • 15Measure performance before optimizing.
  • 16Document non-obvious decisions close to the code or in project notes.
  • 17Use official documentation when behavior is version-specific.
  • 18Keep dependencies current and remove unused code.
  • 19Avoid hardcoded secrets, credentials, and environment-specific paths.
  • 20Log operational events without exposing sensitive data.
  • 21Design examples so learners can safely modify and rerun them.
  • 22Prefer maintainability over short-term cleverness.
💡What it means
  • 1Dynamic routes use bracketed folder names such as [slug] to match variable URL segments.
  • 2The important question is not only what syntax to write, but what responsibility this feature owns.
  • 3Its behavior should be understood in development, during a production build, and after deployment.
  • 4Before implementing it, decide what input it receives, what result it produces, and how failure is shown.
💡How it works
  • 1For /posts/hello, a route at app/posts/[slug]/page.tsx receives hello as the slug parameter.
  • 2Next.js uses file and component boundaries to decide routing, server execution, browser execution, and caching.
  • 3Data should cross each boundary in a small, serializable, and validated form.
  • 4The final result should remain understandable when a user refreshes the page or opens the URL directly.
💡Step-by-step approach
  • 1Create the smallest route or component that demonstrates Dynamic Routing.
  • 2Add one realistic input or data source and show the successful result.
  • 3Add the most likely failure case and display a useful response.
  • 4Run this check: Test a valid value, an unknown value, encoded characters, direct refresh, generated static parameters, and permission checks.
💡Production checklist
  • 1Confirm server-only values and secrets never enter the browser bundle.
  • 2Confirm direct URLs, refreshes, loading states, and errors behave correctly.
  • 3Confirm caching and revalidation match the required data freshness.
  • 4Measure the result using correct URLs, predictable layouts, and navigation without full-page reloads.
💡Real-world use cases
  • 1Dynamic Routing is useful for building multi-page applications with stable URLs, shared layouts, and deep links.
  • 2For /posts/hello, a route at app/posts/[slug]/page.tsx receives hello as the slug parameter.
  • 3A team should use it when the requirement matches its responsibility in routing.
  • 4It should fit the surrounding route, data, security, and deployment design instead of being added in isolation.
  • 5A successful implementation is visible through correct URLs, predictable layouts, and navigation without full-page reloads.
  • 6SaaS products use Dynamic Routing in services, dashboards, background jobs, and API workflows.
  • 7ERP and banking systems apply Dynamic Routing with validation, logging, review, and rollback plans.
  • 8E-commerce and healthcare platforms use Dynamic Routing carefully because reliability and data correctness matter.
💡Internal working
  • 1A Next.js program first evaluates the surrounding context, then applies the Dynamic Routing rules to the current data.
  • 2The important mental model is input, transformation, result, and failure path.
  • 3In production, the same flow usually sits inside a larger layer such as a controller, service, repository, job, or UI component.
💡Performance considerations
  • 1Choose the simplest implementation first, then measure real workloads.
  • 2Watch for repeated work inside loops, unnecessary allocations, and slow I/O in hot paths.
  • 3Prefer clear data structures and stable APIs before micro-optimizing syntax.
💡Security considerations
  • 1Treat external input as untrusted until it is validated.
  • 2Avoid hardcoded secrets and never print sensitive values in examples or logs.
  • 3Use established libraries for authentication, encryption, parsing, and database access.
💡Common mistakes
  • 1Assuming every parameter maps to valid data can produce broken pages or expose records without proper authorization.
  • 2Copying an example without identifying which code runs on the server and which code reaches the browser.
  • 3Handling only the happy path and forgetting loading, empty, invalid, unauthorized, and failed states.
  • 4Adding client state or third-party libraries before confirming that built-in Next.js and browser features are insufficient.
  • 5Skipping verification in a production build, where caching and runtime behavior can differ from development.
  • 6Skipping the small working example before adding framework code.
  • 7Ignoring null, empty, duplicate, and boundary inputs.
  • 8Mixing business logic, input handling, and output formatting in one place.
  • 9Using broad error handling that hides the real failure.
  • 10Forgetting to test the behavior after refactoring.
💡Professional best practices
  • 1Validate route parameters, fetch the matching record on the server, and call notFound() when no resource exists.
  • 2Keep the owning route, component, server function, and validation responsibility easy to identify.
  • 3Use server-side code for trusted data and secrets; send only the data required by interactive browser components.
  • 4Make loading, empty, success, and error states explicit for the user.
  • 5Test a valid value, an unknown value, encoded characters, direct refresh, generated static parameters, and permission checks.
  • 6Start with clear requirements and one minimal working example.
  • 7Use meaningful names that explain business intent.
  • 8Keep examples small enough to debug line by line.
  • 9Validate input at every trust boundary.
  • 10Handle errors explicitly and preserve useful context.
  • 11Prefer simple control flow over deeply nested logic.
  • 12Separate domain logic from I/O and framework code.
  • 13Write tests for normal, boundary, and failure cases.
  • 14Review security assumptions before production use.
  • 15Measure performance before optimizing.
  • 16Document non-obvious decisions close to the code or in project notes.
  • 17Use official documentation when behavior is version-specific.
  • 18Keep dependencies current and remove unused code.
  • 19Avoid hardcoded secrets, credentials, and environment-specific paths.
  • 20Log operational events without exposing sensitive data.
💡Coding exercises
  • 1Beginner: rewrite the example with different names and values.
  • 2Intermediate: add validation and handle one expected failure case.
  • 3Advanced: place Dynamic Routing inside a small service-style design with tests.
💡Mini project
  • 1Build a small Next.js console feature that demonstrates Dynamic Routing.
  • 2Accept input, process it with the concept, print a clear result, and handle invalid input.
  • 3Add a README note explaining the design choice and two edge cases you tested.
💡Troubleshooting
  • 1If the program does not compile, check spelling, imports, braces, and file/class names first.
  • 2If output is unexpected, print intermediate values and verify each branch of the logic.
  • 3If the design feels complex, reduce it to the smallest working example and add pieces back one at a time.
💡Next steps
  • 1Practice Dynamic Routing with a second example from a business domain such as inventory, payroll, banking, or e-commerce.
  • 2Review related Next.js topics that cover data flow, error handling, testing, and clean design.
  • 3Compare your solution with official documentation and simplify anything you cannot explain clearly.
📋Quick Summary
  • Dynamic routes use bracketed folder names such as [slug] to match variable URL segments.
  • For /posts/hello, a route at app/posts/[slug]/page.tsx receives hello as the slug parameter.
  • Recommended approach: Validate route parameters, fetch the matching record on the server, and call notFound() when no resource exists.
  • Main mistake to avoid: Assuming every parameter maps to valid data can produce broken pages or expose records without proper authorization.
  • Verify it by doing the following: Test a valid value, an unknown value, encoded characters, direct refresh, generated static parameters, and permission checks.
🎯Interview Questions
Q1. What is Dynamic Routing?
Answer: Dynamic routes use bracketed folder names such as [slug] to match variable URL segments.
Q2. How does Dynamic Routing work in Next.js?
Answer: For /posts/hello, a route at app/posts/[slug]/page.tsx receives hello as the slug parameter.
Q3. When should you use Dynamic Routing?
Answer: Use it for building multi-page applications with stable URLs, shared layouts, and deep links, when that responsibility belongs inside the Next.js application.
Q4. What is a common mistake with Dynamic Routing?
Answer: Assuming every parameter maps to valid data can produce broken pages or expose records without proper authorization.
Q5. How would you test Dynamic Routing?
Answer: Test a valid value, an unknown value, encoded characters, direct refresh, generated static parameters, and permission checks. The result should demonstrate correct URLs, predictable layouts, and navigation without full-page reloads.
Q6. What mistakes should be avoided with Dynamic Routing?
Answer: Trusting client input without server validation. Ignoring loading, empty, and error states.
Q7. How do you debug problems with Dynamic Routing?
Answer: Reduce the code to a minimal example, inspect inputs and outputs, then add logging or tests around the failing path.
Q8. How does Dynamic Routing affect maintainability?
Answer: It improves maintainability when responsibilities are clear, names are meaningful, and edge cases are tested.
Q9. How would you use Dynamic Routing in an enterprise project?
Answer: Place it behind a clear service, validate inputs, handle errors, log useful context, and cover the behavior with tests.
Q10. What performance concern should you check with Dynamic Routing?
Answer: Measure realistic data sizes and look for repeated work, blocking I/O, excessive allocation, or unnecessary framework overhead.
Q11. What security concern should you check with Dynamic Routing?
Answer: Validate untrusted input, avoid leaking sensitive data, and use proven libraries for security-sensitive work.
Q12. How do you explain Dynamic Routing to a beginner?
Answer: Start with the problem it solves, show the smallest working example, then explain each line and one common mistake.
Q13. What should you test for Dynamic Routing?
Answer: Test a normal case, an empty or invalid case, a boundary case, and one expected failure path.
Q14. How do you know if Dynamic Routing is the wrong choice?
Answer: It is probably wrong if it adds complexity without improving clarity, safety, reuse, or performance.
Q15. How does Dynamic Routing connect to clean code?
Answer: Clean code uses the concept with clear names, small scopes, predictable behavior, and minimal hidden side effects.
Q16. What documentation is useful for Dynamic Routing?
Answer: Document assumptions, edge cases, version-specific behavior, and any production decision that is not obvious from the code.
Q17. How should code using Dynamic Routing be reviewed?
Answer: Review correctness first, then readability, failure handling, security boundaries, performance, and tests.
Q18. What is a practical exercise for Dynamic Routing?
Answer: Build a small feature, change the inputs, add one validation rule, and explain the result in your own words.
Q19. How does Dynamic Routing appear in APIs?
Answer: It often appears in validation, request processing, transformation, persistence, or response formatting depending on the topic.
Q20. How does Dynamic Routing appear in SaaS products?
Answer: SaaS teams use it inside repeatable workflows where correctness, observability, and maintainability matter.
Q21. How does Dynamic Routing appear in ERP systems?
Answer: ERP systems use it around structured business rules such as orders, invoices, inventory, employees, and approvals.
Quiz

Which approach is best when implementing Dynamic Routing?