eduardopires/equinoxproject

The Equinox Project is an open-source reference application written in C# and ASP.NET that demonstrates how to structure a .NET web application using a collection of architectural patterns that are widely discussed but sometimes difficult to see put together in one working example. The author's stated goal is to show the community a practical way to build well-organized applications, not to deliver a finished product. The application is built on ASP.NET 9, which means it runs as both an MVC web app and a web API, with JWT-based authentication for the API side. It uses Entity Framework Core for database access and ships with SQLite support and automatic database setup so you can clone the repository and run it without any database configuration. The README lists the specific libraries in use for each concern, including FluentValidator for input checking and a lightweight mediator library for routing commands and queries internally. On the architecture side, the project applies Domain-Driven Design, which is an approach to organizing code around the business concepts it models rather than around technical layers alone. It also uses CQRS, which separates the paths for reading data from the paths for changing data, and Event Sourcing, which stores a record of every change as a series of events rather than overwriting current state. The README notes explicitly that this is a learning reference and warns against copying everything into a production app without thinking carefully about what you actually need, naming over-engineering as a real risk. The project has been kept current through multiple .NET versions since 2017, with the most recent update moving it to .NET 9 in 2025 and adding architecture tests that verify the code structure itself follows the intended layering rules. A live demo runs on Azure.