Migrating shared frontend modules : refactoring a Manager folder to Core for scalable Monorepo architecture
Hoang, Duong (2025)
2025
All rights reserved. This publication is copyrighted. You may download, display and print it for Your own personal use. Commercial use is prohibited.
Julkaisun pysyvä osoite on
https://urn.fi/URN:NBN:fi:amk-2025120532786
https://urn.fi/URN:NBN:fi:amk-2025120532786
Tiivistelmä
Modern software-as-a-service (SaaS) companies frequently face the challenge of scaling their frontend systems to support multiple product lines and parallel development teams. A monolithic frontend architecture, while often suitable initially, can introduce significant bottlenecks as the organization grows. These challenges manifest as slow build and test cycles, tight coupling between features that increases the "blast radius" of failures, and difficulty in adopting modern technologies and phasing out legacy code.
This thesis examines the challenges of scaling a frontend codebase through a practical case study conducted within a new-space satellite manufacturing organization. As the organization expanded and product requirements evolved, it initiated a transition from a monolithic frontend architecture toward a more modular structure by migrating selected shared components and utilities from a legacy manager folder into a dedicated, peril-agnostic core package. This core package centralizes shared functionality and design conventions, forming the foundation for more maintainable and scalable team-owned development. The approach is built on technologies such as React and TypeScript, and introduces structured packaging and clear separation of concerns as a practical first step toward improved modularity.
The core objective of this research is to analyze the efficacy of this architectural refactoring. It seeks to understand whether creating a dedicated core package and establishing peril-agnostic design principles has addressed the initial scalability challenges, while also identifying any new bottlenecks or technical debt that may have emerged during the migration. Ultimately, this study provides a critical evaluation of the migration's impact on code organization and team workflows, and proposes evidence-based recommendations for future architectural improvements.
This thesis examines the challenges of scaling a frontend codebase through a practical case study conducted within a new-space satellite manufacturing organization. As the organization expanded and product requirements evolved, it initiated a transition from a monolithic frontend architecture toward a more modular structure by migrating selected shared components and utilities from a legacy manager folder into a dedicated, peril-agnostic core package. This core package centralizes shared functionality and design conventions, forming the foundation for more maintainable and scalable team-owned development. The approach is built on technologies such as React and TypeScript, and introduces structured packaging and clear separation of concerns as a practical first step toward improved modularity.
The core objective of this research is to analyze the efficacy of this architectural refactoring. It seeks to understand whether creating a dedicated core package and establishing peril-agnostic design principles has addressed the initial scalability challenges, while also identifying any new bottlenecks or technical debt that may have emerged during the migration. Ultimately, this study provides a critical evaluation of the migration's impact on code organization and team workflows, and proposes evidence-based recommendations for future architectural improvements.