Home Projects Portfolio Dashboard Export PDF Log in

Building the Foundations of Hestia-Web

The Motivation

When starting a new project like hestia-web, the initial phase is always the most critical. It is about moving from an abstract idea to a concrete structure. We recently focused on "taking shape"—establishing the core architectural layout that will support our future growth using a Domain-Driven Design approach.

The Architecture

To ensure our frontend remains scalable and maintainable, we focused on organizing our HTML, CSS, and JavaScript files to separate concerns effectively. By following domain principles early, we ensure that our UI components reflect the actual business logic of the application.

Establishing the Structure

We started by setting up a robust base template to handle global styles and basic application logic:

<!DOCTYPE html>
<html lang="en">
<head>
  <link rel="stylesheet" href="styles/main.css">
</head>
<body>
  <div id="app-root"></div>
  <script src="js/app.js" type="module"></script>
</body>
</html>

This structure ensures that our JavaScript execution remains modular and decoupled from the presentation layer.

Style Encapsulation

Using CSS modules allows us to keep our styles scoped to individual components, preventing global style pollution as the application expands within our Google Cloud environment:

.component-container {
  display: flex;
  flex-direction: column;
  gap: 1rem;
  padding: 2rem;
}

Future-Proofing

By prioritizing clean boundaries between our markup and logic, we are building a codebase that is ready for deployment and easy to iterate upon. The focus on modularity now will pay dividends when we scale out our services.

Takeaway

Start your projects by defining clear domain boundaries early. Even in the initial "taking shape" phase, consistent structure prevents technical debt and makes future feature integration significantly smoother.


Generated with Gitvlg.com

Building the Foundations of Hestia-Web
Camila Soddu

Camila Soddu

Author

Share: