Course contentsShow
← Web Development
Lesson 986 of 2,98217. URL and History ManagementFree lesson

Route-Based Code Splitting

Lazy load route components to reduce initial bundle size and improve performance.

Route-Based Code Splitting

What you'll learn: You'll discover how to lazy load route components so your initial page bundle stays small and loads faster.

The Core Problem

When you build a client-side routed application, bundling all route components into one JavaScript file creates a large initial download. Users visiting your homepage don't need the code for your checkout page, profile settings, or admin dashboard—yet they're forced to download it all upfront.

What is Route-Based Code Splitting?

Route-based code splitting means loading the JavaScript for each route only when the user navigates to that route. Instead of one massive bundle, you create separate chunks for different routes. When a user clicks a link, the browser fetches just the code needed for that destination.

Think of it like a library: instead of carrying every book home at once, you check out only the one you're currently reading.

How It Works with Your Router

Your routing logic decides which component to render based on the current URL. With code splitting, instead of importing all route components at the top of your file, you import them dynamically inside your route matching logic:

When the route matches /about, then the browser requests about-page.js. Until that moment, the code stays on the server.

The Performance Win

Your initial bundle shrinks dramatically because it only contains:

  • The router itself
  • The current route's component
  • Shared utilities

Everything else loads on-demand. This means faster initial page loads, especially for users on slow connections or mobile devices.

Key Takeaway: Route-based code splitting uses dynamic imports to load route components only when needed, reducing your initial JavaScript bundle size and significantly improving time-to-interactive for your application.