Course contentsShow
← Web Development
Lesson 2744 of 2,98249. Dates, Times, and Numbers on the WebFree lesson

Tree-Shaking and Bundle Size

Comparing bundle impact: date-fns's modular imports vs Luxon vs Day.js, and optimizing imports.

Tree-Shaking and Bundle Size

What you'll learn: How different date libraries affect your final JavaScript bundle size and how to minimize bloat through smart importing.

When you add a date library to your project, you don't want to ship your entire toolkit to users who only need a screwdriver. Tree-shaking is the process of eliminating unused code from your final bundle—like shaking a tree to drop dead leaves while keeping the live branches.

Why Bundle Size Matters with Date Libraries

Date libraries vary dramatically in size:

  • date-fns: ~600KB full library, but modular
  • Luxon: ~70KB complete
  • Day.js: ~2KB core

The catch? These numbers only matter if you can't tree-shake effectively.

date-fns: The Modular Champion

date-fns shines with tree-shaking because every function is a separate module:

// ✅ Good: Only imports what you use (~2KB)
import { format, addDays } from 'date-fns';

// ❌ Bad: Imports everything (~600KB)
import * as dateFns from 'date-fns';

Luxon and Day.js: Different Trade-offs

Luxon uses class-based architecture, so importing DateTime brings the whole class (~70KB), but that's still reasonable and includes timezone support.

Day.js starts tiny (~2KB) but grows with plugins. Each plugin adds weight, so audit what you actually need.

Optimization Strategy

  1. Use named imports with date-fns for maximum tree-shaking
  2. Audit your actual usage—do you need 20 functions or just 3?
  3. Check your bundle analyzer to verify tree-shaking worked
  4. Choose libraries based on features needed, not just raw size

Think of it like packing for a trip: date-fns lets you pack individual items, Luxon is a pre-packed suitcase, and Day.js is a small bag you customize.

Key Takeaway: date-fns offers the best tree-shaking with modular imports, but only if you import functions individually—Luxon and Day.js have smaller baseline sizes but less granular optimization potential.