> For the complete documentation index, see [llms.txt](https://docs.soapjs.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.soapjs.com/soapjs.md).

# SoapJS

SoapJS is a lightweight, flexible framework for building applications with clean architecture — strong separation of concerns, minimal boilerplate. Define entities, use cases, repositories, CQRS, events and auth, and let the framework wire the HTTP, DI and persistence around them.

### What you can build

* **Clean architecture** out of the box — `domain / application / data / api` layers
* **Pick your complexity** — a plain `controller → use case → repository` for simple features, or full **CQRS** with commands, queries, **domain events** and read-model **projections** for complex ones
* **Ports & adapters** — swap MongoDB, SQL, or an in-memory fake without touching your domain
* **JWT / local auth**, middleware, and **WebSockets** via plugins

### See it in action

The **Comics Universe demo** (Marvel & DC) is the canonical, always-current reference — from simple CRUD to event-driven CQRS with a WebSocket live feed: 👉 [github.com/soapjs/soap-node-demo](https://github.com/soapjs/soap-node-demo)

### Next

Quick Start · Clean Architecture · Components · Plugins