Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/reimagined/resolve

Full stack CQRS, DDD, Event Sourcing framework for Node.js
https://github.com/reimagined/resolve

cqrs ddd es6 event-sourcing nodejs react reactive redux

Last synced: 3 months ago
JSON representation

Full stack CQRS, DDD, Event Sourcing framework for Node.js

Awesome Lists containing this project

README

        

# [](https://github.com/reimagined/resolve/)

[![Build Status](https://github.com/reimagined/resolve/actions/workflows/push-master.yml/badge.svg?branch=master)](https://github.com/reimagined/resolve/actions/workflows/push-master.yml) [![npm version](https://badge.fury.io/js/create-resolve-app.svg)](https://badge.fury.io/js/create-resolve-app) [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/reimagined/resolve/master/LICENSE)

![CQRS DDD Event Sourcing React Redux](https://user-images.githubusercontent.com/19663260/41475089-73b9620e-70c6-11e8-9ca9-633f3857626b.png)

reSolve is a full stack functional JavaScript framework.

- [CQRS](https://martinfowler.com/bliki/CQRS.html) - independent Command and Query sides.
- [DDD Aggregate](https://martinfowler.com/bliki/DDD_Aggregate.html) support.
- [Event sourcing](https://martinfowler.com/eaaDev/EventSourcing.html) - using events as a source of truth and calculating read models from them.
- Integrates with [React](https://reactjs.org) and [Redux](https://redux.js.org) for seamless development experience.

## :rocket: Getting Started

### Installation

Make sure you have **NodeJS** version **14.17** or higher.

Use [create-resolve-app](packages/core/create-resolve-app) package to create a new reSolve application. The easiest way is to use [npx](https://www.npmjs.com/package/npx/v/1.1.1)

```sh
npx create-resolve-app my-awesome-app
cd my-awesome-app
npm run dev
```

You can also use npm or yarn tools

#### [npm](https://www.npmjs.com/)

> Note: Installing a package globally may require administrative privileges.

```sh
npm i -g create-resolve-app
create-resolve-app my-awesome-app
cd my-awesome-app
npm run dev
```

#### [yarn](https://yarnpkg.com/lang/en/)

```sh
yarn create resolve-app my-awesome-app
cd my-awesome-app
yarn run dev
```

Your application will be running at http://localhost:3000/.

### Creating a new app with a code example

There are several [code examples](./examples/) provided. You can add code from these examples into your projects. To list the available examples use the create-resolve-app -h command.

To create a new application with the code of the specific example use the create-resolve-app command with the -e flag followed by the example's name.

For instance, to run the [shopping-list example](./examples/shopping-list), run:

```sh
npx create-resolve-app resolve-example -e shopping-list
```

## :books: Documentation

You can find reSolve documentation in the [docs section](./docs).

To get started with reSolve, see the [step-by-step tutorial](./docs/tutorial.md).

## :loudspeaker: Get in Touch

- Ask questions on Stackoverlow with [resolvejs tag](https://stackoverflow.com/questions/ask?tags=resolvejs)
- Use [GitHub Issues](https://github.com/reimagined/resolve/issues) to report bugs and suggest features
- Follow [@resolvejs on Twitter](https://twitter.com/resolvejs) or join [our Facebook page](https://www.facebook.com/resolvejs/) for product news and updates

![Analytics](https://ga-beacon.appspot.com/UA-118635726-1/readme.md?pixel)