[🧑‍🎓 LFX]: Upgrading Core Routing and State Management

[yurishkuro]

Modernizing Jaeger-UI: Upgrading Core Routing and State Management

Please read jaegertracing/jaeger#7833 for any application-related questions.

LFX link: https://mentorship.lfx.linuxfoundation.org/project/d13df7c9-06d3-4589-bef8-c13e5c79c2a2

Description:

Jaeger is the industry-standard open-source distributed tracing platform used by companies like Uber and Shopify to monitor complex microservices. To ensure long-term maintainability and performance, the Jaeger-UI is undergoing a major modernization effort to move away from legacy patterns and deprecated libraries.
This project focuses on the final two major "foundational" upgrades for the UI:

1. Routing Renovation: Upgrading from legacy react-router patterns to React Router v7. This involves migrating from a component-based routing approach to the modern data-driven router architecture.
2. State Management Cleanup: Replacing the deprecated history package and older Redux integration patterns with modern standards like redux-first-history.

As a mentee, you will be the primary architect for these upgrades, diving deep into the internals of a high-traffic React application. You will work on refactoring core navigation logic, improving how the UI handles deep-linking into complex trace data, and ensuring the application remains lightning-fast for developers debugging their systems.

Expected Outcomes

• A fully migrated Jaeger-UI running on React Router v7.
• Successful removal of the deprecated history v4/v5 dependency in favor of modern state-navigation integration.
• Refactored functional components that utilize modern hooks (like useNavigate and useParams) instead of legacy HOCs (Higher-Order Components).
• A robust test suite ensuring no regressions in trace visualization or search functionality during the migration.

Recommended Skills

• Javascript/TypeScript & React: Deep familiarity with hooks and component lifecycles.
• State Management: Experience with Redux or similar libraries.
• Routing Knowledge: Understanding of SPAs (Single Page Applications) and browser history APIs.
• Testing: Experience with Jest/Enzyme or React Testing Library is a plus.

Mentor(s):

• Yuri Shkuro (@yurishkuro, github@ysh.us)
• Jonah Kowall (@jkowall, jkowall@kowall.net)

Upstream Issues:

• [Deps] Upgrade history package to 5.x #2531 (History upgrade)
• [Deps] Upgrade react-router-dom to 7.x #2532 (React Router v7 upgrade)
  • May require [Feature]: Refactor class components to functional components #2610

[gmarav05]

Hi @yurishkuro , I’m Aravind. I’ve been building React apps with TypeScript, React Router, hooks. Although, I have only basic experience with testing using Jest but, i am willing to learn and contribute.

Would you recommend any specific issues or areas to focus?

[chinmay3012]

Hi @yurishkuro ,
As a qualifying contribution (Bootcamp Task) for the 'Modernizing Jaeger-UI' project, I successfully refactored the
SearchTracePage :
a central and complex part of the UI , from a Class Component to a Functional Component.
Needed approval to run checks :

#3346

[Parship12]

Also I am unable to view application on LFX Mentorship Term 1 on LinuxFoundation platform mentorship prog. Guidance much appreciated , thanks .

Please read jaegertracing/jaeger#7833 for any application-related questions.

[aryanG9403]

Hi! I picked up a small refactor as part of the Router v7 migration work. The PR removes the deprecated History typing from withRouteProps and simplifies it to rely on router hooks instead.

PR: #3452

This seemed like a useful incremental cleanup toward reducing legacy routing dependencies. Happy to tweak anything or help with another part of the migration if needed.

[bravo1goingdark]

Hi! I’ve applied to this project through LFX.
The React Router v7 migration and state management cleanup align well with my frontend experience.

[Abhra0404]

Hi! I’m interested in working on this mentorship project.

From my understanding, the goal is to modernize Jaeger-UI by migrating legacy routing to React Router v7, removing deprecated history dependencies, and refactoring Redux integration using redux-first-history, while preserving existing behavior in trace visualization and search.

My approach would be to start with a careful audit of the current routing and history usage, propose a staged migration plan, and make incremental, reviewable changes. I’d focus on adopting modern hook-based APIs (useNavigate, useParams) and validating each step with tests to avoid regressions.

I’m comfortable working with React, modern hooks, Redux, and existing codebases, and I value clear communication through issues and pull requests. I can consistently dedicate 15–25 hours per week and would love to learn from the maintainers while contributing meaningful improvements to Jaeger-UI.

Thanks for considering!

[Rasesh2005]

I Am Highly interested in working on this project, and it aligns with my learning goals as well