Use Commanded to build your own Elixir applications following the [CQRS/ES](http://cqrs.nu/Faq) pattern.
Provides support for:
- Command registration and dispatch.
- Hosting and delegation to aggregates.
- Event handling.
- Long running process managers.
Commanded provides a solid technical foundation for you to build on. It allows you to focus on modelling your domain, the most important part of your app, creating a better application at a faster pace.
You can use Commanded with one of the following event stores for persistence:
- [EventStore](https://github.com/commanded/eventstore) Elixir library using PostgreSQL for persistence
- Greg Young's [Event Store](https://eventstore.org/).
- [In-memory event store](https://github.com/commanded/commanded/wiki/In-memory-event-store) included for test use only.
Please refer to the [CHANGELOG](CHANGELOG.md) for features, bug fixes, and any upgrade advice included for each release.
Requires Erlang/OTP v21.0 and Elixir v1.6 or later.
### Supporting Commanded
You can help support Commanded by helping to fund its ongoing development, new features, and releases.
- [Become a GitHub sponsor](https://github.com/sponsors/slashdotdash).
- [View sponsors & backers](BACKERS.md)
- [What is CQRS/ES?](https://kalele.io/blog-posts/really-simple-cqrs/)
- [Frequently asked questions](https://github.com/commanded/commanded/wiki/FAQ)
- [Getting help](https://github.com/commanded/commanded/wiki/Getting-help)
- [Latest published Hex package](https://hex.pm/packages/commanded) & [documentation](https://hexdocs.pm/commanded/)
[![Build Status](https://github.com/commanded/commanded/workflows/Test/badge.svg?branch=master)](https://github.com/commanded/commanded/actions) [![Join the chat at https://gitter.im/commanded/Lobby](https://badges.gitter.im/commanded/Lobby.svg)](https://gitter.im/commanded/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
> This README and the following guides follow the `master` branch which may not be the currently published version.
> [Read the documentation for the latest published version of Commanded on Hex](https://hexdocs.pm/commanded/).
- [Getting started](guides/Getting%20Started.md)
- [Choosing an event store](guides/Choosing%20an%20Event%20Store.md)
- [PostgreSQL-based EventStore](guides/Choosing%20an%20Event%20Store.md#postgresql-based-elixir-eventstore)
- [Greg Young's Event Store](guides/Choosing%20an%20Event%20Store.md#greg-youngs-event-store)
- [Using Commanded](guides/Usage.md)
- [Example aggregate](guides/Aggregates.md#example-aggregate)
- [Aggregate state snapshots](guides/Aggregates.md#aggregate-state-snapshots)
- [Command handlers](guides/Commands.md#command-handlers)
- [Command dispatch and routing](guides/Commands.md#command-dispatch-and-routing)
- [Define aggregate identity](guides/Commands.md#define-aggregate-identity)
- [Multi-command registration](guides/Commands.md#multi-command-registration)
- [Dispatch timeouts](guides/Commands.md#timeouts)
- [Dispatch consistency guarantee](guides/Commands.md#command-dispatch-consistency-guarantee)
- [Dispatch returning execution result](guides/Commands.md#dispatch-returning-execution-result)
- [Aggregate lifespan](guides/Commands.md#aggregate-lifespan)
- [Composite command routers](guides/Commands.md#composite-command-routers)
- [Example middleware](guides/Commands.md#example-middleware)
- [Composite command routers](guides/Commands.md#composite-command-routers)
- [Domain events](guides/Events.md#domain-events)
- [Event handlers](guides/Events.md#event-handlers)
- [Consistency guarantee](guides/Events.md#consistency-guarantee)
- [Upcasting events](guides/Events.md#upcasting-events)
- [Process managers](guides/Process%20Managers.md)
- [Example process manager](guides/Process%20Managers.md#example-process-manager)
- [Default JSON serializer](guides/Serialization.md#default-json-serializer)
- [Configuring JSON serialization](guides/Serialization.md#configuring-json-serialization)
- [Decoding event structs](guides/Serialization.md#decoding-event-structs)
- [Using an alternative serialization format](guides/Serialization.md#using-an-alternative-serialization-format)
- [Customising serialization](guides/Serialization.md#customising-serialization)
- [Read model projections](guides/Read%20Model%20Projections.md)
- [Single node deployment](guides/Deployment.md#single-node-deployment)
- [Multi node cluster deployment](guides/Deployment.md#multi-node-cluster-deployment)
- [Multi node, but not clustered deployment](guides/Deployment.md#multi-node-but-not-clustered-deployment)
- [Testing with Commanded](guides/Testing.md)
- [Used in production?](#used-in-production)
- [Example application](#example-application)
- [Learn Commanded in 20 minutes](#learn-commanded-in-20-minutes)
- [Choosing an event store provider](guides/Choosing%20an%20Event%20Store.md#writing-your-own-event-store-provider)
- [Need help?](#need-help)
## Used in production?
Yes, see the [companies using Commanded](https://github.com/commanded/commanded/wiki/Companies-using-Commanded).
## Example application
[Conduit](https://github.com/slashdotdash/conduit) is an open source, example Phoenix 1.3 web application implementing the CQRS/ES pattern in Elixir. It was built to demonstrate the implementation of Commanded in an Elixir application for the [Building Conduit](https://leanpub.com/buildingconduit) book.
## Learn Commanded in 20 minutes
[Watch Bernardo Amorim introduce CQRS and event sourcing](https://www.youtube.com/watch?v=S3f6sAXa3-c) at Code Beam SF 2018. Including a tutorial on how to implement an Elixir application using these concepts with Commanded.
Pull requests to contribute new or improved features, and extend documentation are most welcome.
Please follow the existing coding conventions, or refer to the [Elixir style guide](https://github.com/niftyn8/elixir_style_guide).
You should include unit tests to cover any changes. Run `mix test` to execute the test suite.
Commanded exists thanks to the following people who have contributed.
<a href="https://github.com/commanded/commanded/graphs/contributors"><img src="https://opencollective.com/commanded/contributors.svg?width=890&button=false" width="890" /></a>
- [Adil Yarulin](https://github.com/ayarulin)
- [Andrey Akulov](https://github.com/astery)
- [Andrzej Sliwa](https://github.com/andrzejsliwa)
- [Ben Smith](https://github.com/slashdotdash)
- [Benjamin Moss](https://github.com/drteeth)
- [Bernardo Amorim](https://github.com/bamorim)
- [Brenton Annan](https://github.com/brentonannan)
- [Chris Brodt](https://github.com/uberbrodt)
- [Chris Martin](https://github.com/trbngr)
- [Christophe Juniet](https://github.com/cjuniet)
- [Danilo Silva](https://github.com/silvadanilo)
- [Dave Lucia](https://github.com/davydog187)
- [David Carlin](https://github.com/davich)
- [Danni Friedland](https://github.com/BlueHotDog)
- [Fernando Mendes](https://github.com/justmendes)
- [Florian Ebeling](https://github.com/febeling)
- [Henry Hazan](https://github.com/henry-hz)
- [Joan Zapata](https://github.com/JoanZapata)
- [João Thallis](https://github.com/joaothallis)
- [John Wilger](https://github.com/jwilger)
- [Joseph Lozano](https://github.com/joseph-lozano)
- [Kok J Sam](https://github.com/sammkj)
- [Leif Gensert](https://github.com/leifg)
- [Luís Ferreira](https://github.com/zamith)
- [Marcelo Dominguez](https://github.com/marpo60)
- [Matt Doughty](https://github.com/m-doughty)
- [Michael Herold](https://github.com/michaelherold)
- [Miguel Palhas](https://github.com/naps62)
- [Nigel Thorne](https://github.com/nigelthorne)
- [Olafur Arason](https://github.com/olafura)
- [Paolo Laurenti](https://github.com/PaoloLaurenti)
- [Patrick Detlefsen](https://github.com/patrickdet)
- [Phil Chen](https://github.com/fahchen)
- [Raphaël Lustin](https://github.com/rlustin)
- [Štefan Ľupták](https://github.com/EskiMag)
- [Tobiasz Małecki](https://github.com/amatalai)
- [Willy Wombat](https://github.com/octowombat)
- [Yuri de Figueiredo](https://github.com/y86)
## Need help?
Please [open an issue](https://github.com/commanded/commanded/issues) if you encounter a problem, or need assistance. You can also seek help in the [Gitter chat room](https://gitter.im/commanded/Lobby) for Commanded.
For commercial support, and consultancy, please contact [Ben Smith](mailto:email@example.com).