Skip to content

NotNull is a modern distributed application built with .NET 9, Aspire, Next.js, WolverineFx, and PostgreSQL—architected for microservices, event-driven messaging, and cloud-native scalability.

Notifications You must be signed in to change notification settings

net0well/NotNull

Repository files navigation

🚀 @NotNull

A modern platform inspired by Stack Overflow
Built to demonstrate real-world distributed architectures with the best of .NET and React with Next.js.




📌 Overview

@NotNull is a modern full-stack application inspired by Stack Overflow, built from scratch with a focus on:

  • 🧩 Microservices architecture
  • 📡 Event-driven messaging
  • 🔐 Security and authentication
  • 📈 Scalability and observability
  • 🏗️ Architectural best practices

The project serves as a practical reference for building real-world distributed systems, ready for local execution or cloud deployment.


🧠 Architecture

🧩 Microservices

Independent, decoupled, and scalable services.

📨 Event-Driven

Asynchronous communication based on events.

🔐 Security

OAuth2 / OpenID Connect with Keycloak.

📊 Observability

Logs, metrics, and tracing with .NET Aspire.


🛠️ Tech Stack

🔧 Backend

  • .NET 9 – Core platform
  • .NET Aspire – Orchestration and observability
  • WolverineFx – Messaging and event-driven architecture
  • PostgreSQL – Relational database
  • Docker – Local execution and orchestration

🎨 Frontend

  • Next.js (App Router)
  • Tailwind CSS – Modern and responsive styling
  • Zustand – Simple and efficient state management

🔐 Authentication & Security

  • Keycloak
  • OAuth2 / OpenID Connect
  • Clear separation between authentication and domain logic

🚀 Running the Project Locally

# Clone the repository
git clone https://github.com/net0well/notnull.git

# Start the infrastructure
docker compose up -d

# Launch the application with Aspire
dotnet run

🎯 Key Features

Microservices-based architecture with clear domain boundaries
Event-driven communication using WolverineFx
OAuth2/OIDC authentication with Keycloak
Built-in observability with .NET Aspire
Modern React frontend with Next.js App Router
Containerized deployment with Docker
Production-ready patterns and best practices


📖 Documentation

For detailed documentation on architecture, patterns, and deployment strategies, visit our Wiki.


🤝 Contributing

Contributions are welcome! Please read our Contributing Guide before submitting pull requests.


📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Built with ❤️ using .NET 9, Aspire, Next.js, WolverineFx, and PostgreSQL

⭐ Star this repo if you find it useful!

About

NotNull is a modern distributed application built with .NET 9, Aspire, Next.js, WolverineFx, and PostgreSQL—architected for microservices, event-driven messaging, and cloud-native scalability.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages