<aside> 💡 Feel free to use this example doc as a starting point for planning and documenting your next migration.

Your Mileage May Vary: A migration document is only useful if it works for you. So feel free to adapt this template to the needs of your project and your team. Larger projects might require more detail, while smaller ones could use a leaner structure.

*Read more about how to use this template:

</aside>

Migration Plan: Frontend Migration from React + Webpack to Next.js

Overview

Use this section to briefly describe what this doc is about, the intended audience, and any other information you’d like to be immediately accessible to readers.

Link to any relevant documents as well to give more context about the project, including:

We’ll be working on migrating the frontend layer of Airline.com from its current React + Webpack implementation to Next.js. This migration aims to modernize our tech stack and improve overall performance and developer productivity.

Date Started 09/01/2024
Date Last Updated 09/22/2024
Status In Review
Project Lead(s) Steve Aoki, Rick Astley

Outcomes

Explain at a high-level what is the problem that you’re trying to solve with the migration. This includes the outcome you’re hoping to achieve as well as any metrics you’ll use to measure success.

The two primary goals of this migration are to:

  1. Reduce the cost of change in the application
  2. Improve client-side performance, particularly on mobile devices

By adopting Next.js, we’ll enable developers to implement features end-to-end in a single language and within a single repository. This will allow them to work across the stack with much less friction.

Additionally, the advanced caching and rendering features of Next.js will allow us to improve our application’s loading performance, particularly on mobile devices.

Key Metrics: