Task

Seo Sites Generator addresses a practical task: A monorepo for generating and customizing SEO sites: frontend, backend, AI service, SEO engine, templates, and deployment. Automation and repeatable content pipelines.

The project is related to commercial development and is actively being developed. It is associated with services: SEO, AEO, and GEO: preparing sites for AI search, growth engineering, and content platforms.

The case demonstrates an approach to tasks in the field of "SEO, AEO, and GEO: preparing sites for AI search": from setup to delivery with a clear module structure.

Before starting, we established readiness criteria: a clear first screen, predictable form errors, and the ability to make improvements without rewriting half of the codebase.

Solution

A comprehensive yet educational implementation has been made, focusing on code readability and reproducible builds.

The scenarios are designed so that the main actions fit into one or two screens: fewer switches, fewer input errors. Navigation and field labels are aligned with familiar patterns — users do not need to "learn the interface".

Special attention is given to loading states and empty lists: skeleton/spinner where data comes asynchronously, and clear empty-state texts instead of an empty table.

Architecture and stack

UI and client: React.

Server and data: Node.js.

Infrastructure and utilities: TypeScript, Monorepo, AI, SEO.

Language distribution in the repository: TypeScript (92.2%), HTML (2.3%), Shell (2.1%), JavaScript (1.7%), CSS (1.5%), MDX (0.1%), Dockerfile (0%), Makefile (0%).

Layers are separated so that the UI does not know the transport details: API/storage adapters, domain types, presentation components. This simplifies backend replacement and targeted UX tweaks.

Key features

• TypeScript — used in product logic: reduces the amount of custom code and speeds up the addition of new screens.
• Node.js — used in product logic: reduces the amount of custom code and speeds up the addition of new screens.
• React — used in product logic: reduces the amount of custom code and speeds up the addition of new screens.
• Monorepo — used in product logic: reduces the amount of custom code and speeds up the addition of new screens.
• AI — used in product logic: reduces the amount of custom code and speeds up the addition of new screens.
• SEO — used in product logic: reduces the amount of custom code and speeds up the addition of new screens.

Additionally:

• Integration and use of TypeScript in product logic and interface.
• Integration and use of Node.js in product logic and interface.
• Integration and use of React in product logic and interface.

Result

The MVP already covers the key scenario; next — expanding reporting, tests, and monitoring.

The source code is open: https://github.com/astropsy999/seo-sites-generator — you can evaluate the module structure and commit style.

What I would improve

The next step is observability (logs/metrics), regression auto-tests, and API documentation for integrators. For high-load scenarios — profiling bottlenecks and caching directories.