By Robbert van Os
Posted on 2023-08-03T00:00:00.000Z

Avoid Over-Engineering: Simplifying Your Medium Size Front-End Application

Balance maintainable code & avoid overengineering. Explore popular approaches & ensure efficiency.

In the realm of software development, small applications are easily managed, and large-scale ones can tap into abundant resources. Yet, it's the middle ground where most real-life applications thrive, facing unique challenges often overlooked. As new companies embark on their development journey, making sound architecture choices becomes crucial. Balancing structure and maintainability in medium-sized applications can be a daunting task, as overengineering and under-preparation lurk as potential pitfalls. In this article, we delve into the food for thought that every starting company should consider when navigating the terrain of architecture decisions. By evaluating popular approaches and techniques, we aim to guide developers in effectively managing complexity and crafting an optimal balance between structure and maintainability in their medium-sized applications.

Typescript ✅

TypeScript is a programming tool that helps developers catch mistakes early on while building software. It does this by making sure all the pieces of code fit together correctly like a puzzle. This helps prevent errors and bugs, making the software more reliable and easier to maintain. TypeScript also provides better guidance for developers, making it easier for teams to work together effectively. Ultimately, using TypeScript results in a smoother development process and a more reliable end product.

State Management ✅

In medium-sized front-end applications, handling the state is crucial. As complexity grows, state management becomes more challenging. Thankfully, there are helpful libraries like Redux, MobX, Vuex, and Pinia to maintain a consistent state and simplify adding new features. However, using a global state can lead to coupling, so dividing the store into smaller modules is advisable. Also, avoid misusing global state for component-specific tasks.

Feature Flags ✅

Feature flags, or feature toggles, are a valuable technique in software development. They enable us to switch specific features on or off during runtime without needing a new deployment. This approach empowers developers to release new features, conduct A/B testing, and efficiently manage the development and deployment process. Implementing feature flags leads to enhanced flexibility, quicker releases, and minimized risks when introducing new features. There are various libraries and tools available to incorporate feature flags into different programming languages and frameworks.

Testing ❓

Testing plays a vital role in the development of any application. By incorporating various testing approaches like unit testing, integration testing, and end-to-end testing, developers can significantly enhance code quality and ensure a smoother development process. Testable code generally translates to better code, and creating test cases early on minimizes the occurrence of bugs, making it easier for new team members to understand and contribute to the project.

In large-scale applications, developers encounter an array of testing types, some of which may not be essential for smaller codebases. These include mutation tests, load tests, stress tests, performance tests, visual tests, snapshot tests, and more. While they have their place in extensive projects, medium-scale applications must strike a balance between ensuring stability through adequate testing and avoiding an overly complex testing process.

Ultimately, investing time and effort in testing contributes to a more efficient and successful application development process.


Continuous Integration and Delivery (CI/CD) have become indispensable in modern software development. By implementing CI/CD, developers can automate crucial tasks like building, testing, and deploying code, leading to significant time savings and reduced errors. Embracing a reliable CI/CD tool enhances the development process's efficiency, ensuring that the application is consistently prepared for deployment. With CI/CD, teams can maintain a streamlined and agile development workflow, allowing them to deliver high-quality software faster and with greater confidence.

Domain Driven Design ⛔️

Domain Driven Design (DDD) is an approach to software development that prioritizes modeling the core business domain, establishing a shared language among developers and stakeholders, and designing software components based on domain complexity. DDD shines in large-scale applications with intricate business logic and multiple teams collaborating. However, for medium-sized applications, a simpler architecture with emphasis on clean, modular code may suffice for maintainability and scalability. DDD could introduce unnecessary overhead and complexity, providing limited benefits. Instead, opt for simpler architectural patterns that promote code organization, separation of concerns, and reusability.

Hexagonal Architecture ⛔️

Hexagonal architecture, also called Ports and Adapters, is a powerful architectural pattern that emphasizes a clear separation between a software application's core business logic and its external dependencies like databases, APIs, and UIs. This separation enhances flexibility, testability, and maintainability.

Like Domain Driven Design, implementing hexagonal architecture can be advantageous for large applications with complex business logic and numerous external dependencies. However, for medium-sized applications, it may be an overkill. In such cases, simpler architectural approaches can be more suitable while still ensuring code organization and maintainability.

Micro Frontends ⛔️

Micro frontends have gained popularity as an architectural pattern, dividing large applications into smaller, independent ones based on features or domains. This approach enables individual development, testing, and deployment, leading to improved scalability and flexibility.

However, for medium-sized applications, adopting micro frontends may not be essential and could introduce unnecessary complexity and overhead, overshadowing the advantages. A traditional monolithic architecture, coupled with a well-structured codebase and efficient use of components, often suffices for most medium-sized applications. If the requirement arises later, the possibility of transitioning to micro frontends can be reassessed. Prioritizing simplicity and maintainability in medium-sized projects can result in a more efficient development process and a successful end product.

Content Distribution Network (CDN) ✅

Employing a CDN (Content Delivery Network) offers a swift, effortless, and budget-friendly method to enhance your application's performance and reliability. By caching content and delivering it from a server closer to the end user, CDNs reduce loading times, improve user experience, and ensure consistent access to resources.

Linting ✅

Linting is a code analysis process that identifies possible errors, inconsistencies, and deviations from coding standards. It offers a simple and quick method to uphold code quality, detect issues early on, and enhance overall readability and maintainability. By implementing linting, developers can ensure cleaner and more reliable code in their projects.

Observability ✅

In medium-sized applications, observability becomes crucial and can lead to significant time and cost savings. Implementing observability allows you to efficiently monitor, comprehend, and troubleshoot your system's performance and overall health.

Various tools and techniques, like logging, metrics collection, and distributed tracing, are available to incorporate observability into your application. The objective is to swiftly identify and resolve issues, ensure optimal application performance, and reduce downtime. Embracing observability empowers developers to maintain a robust and reliable system, enhancing the overall user experience.

Design system ⛔️

A design system encompasses reusable components, guidelines, and principles for creating consistent user interfaces across various applications or platforms. While larger organizations with multiple products and teams can benefit from implementing a design system, it might not be essential for medium-sized applications.

Rather than building an entire design system from scratch, consider configuring an existing component library to suit your requirements. Establish a set of guidelines and reusable components within your application to maintain consistency and streamline development efforts. This approach allows you to strike a balance between maintaining a consistent user experience and optimizing resource allocation for medium-sized projects.


Over-engineering can lead to unnecessary complexities in medium-scale application development. Striking the right balance between essential tools and techniques is vital. Establishing and adhering to a consistent coding style, leveraging automation to catch bugs early, and managing technical debt are key factors for successful development.

Individual experiences may vary, and what is considered harmful to some may be essential to others. If there are tools or techniques that you find crucial or if there are aspects that have caused challenges in your past experiences, we welcome your input in the comments below. Sharing knowledge and insights can further improve our understanding and approach to medium-scale application development.