https://github.com/gavinhome/maui.redux

Maui Redux is an assembled cross-platform application framework based on Redux state management for MVU pattern, using C# and Maui
https://github.com/gavinhome/maui.redux

cross-platform csharp dotnet dotnet8 maui maui-app mvu redux starter-app state-management

Last synced: about 1 month ago
JSON representation

Maui Redux is an assembled cross-platform application framework based on Redux state management for MVU pattern, using C# and Maui

• Host: GitHub
• URL: https://github.com/gavinhome/maui.redux
• Owner: GavinHome
• License: mit
• Created: 2023-12-05T05:08:58.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2024-01-03T02:12:51.000Z (12 months ago)
• Last Synced: 2024-04-28T04:59:34.057Z (8 months ago)
• Topics: cross-platform, csharp, dotnet, dotnet8, maui, maui-app, mvu, redux, starter-app, state-management
• Language: C#
• Homepage:
• Size: 5.91 MB
• Stars: 3
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Maui.Redux

Maui Redux is an assembled cross-platform application framework based on Redux state management for MVU pattern,  using C# and Maui. It allows you to manage your application state and logic based on Redux implemention of MVU. MVU is an implementation idea based on one-way data flow, as shown in the figure below:



- **1. When the application start, and state is initialized to the current state.**

- **2. When the state changes, and UI rendering to be rendered will be triggered.**

- **3. When interaction occurs, such as the user clicks on the event, an action is sent to the Reducer.**

- **4. Executing the Update action will create an instance of the updated state.**

- **5. The new state replaces the current state, and returns to step [2].**

## Installation(Coming soon)

You can use the NuGet package manager to install Maui.Redux, just run the following command in your project:

```bash

dotnet add package Maui.Redux

```

Or, you can also add the following dependency in your project file:

```xml

  

```

## Design Principles



The Maui Redux framework mainly contains the following parts:

- **Action Creators**: Create executable actions that represent pages or components. Each action has a type to distinguish different actions, and some optional parameters to pass some additional information.

- **Store**: Create and manage application state, dispatch and process actions. When each Page is initialized, a Store instance is created, the initial state and Reducer function are passed in, and some listeners can also be registered with the Store to update the UI or perform some other operations when the state changes.

- **Reducers**: This is a pure function that receives the current state and an action and returns a new state.

- **Effect**: Extensions that handle application side effects, such as jump routing, request data, etc.

- **Component**: Represents a stateless component, which is combined into a part of the Page through Adapter Connector or Slot Connector.

- **Page**: Represents a stateful page component, inherited from Component, which contains the following three parts.

   - InitState: initialization state function, unique to Page component

   - Middleware: middleware, such as printing logs in listening functions, etc.

   - CombineReducers: Integrate all Reducers of page components and sub-components together

## Usage

To use Maui.Redux, you need to define the following parts:

- **State**: This is a class that represents data and contains some properties, etc.

- **Action**: This is a class or enumeration that represents the actions that the application can perform, such as add, delete, update, etc. Each action has a type to distinguish different actions, and some optional parameters to pass some additional information.

- **Component**: (Optional) This is a class that represents a stateless view component. Use the method (Dispatch) in Store to dispatch actions, or use the properties of Store to obtain the current state.

- **Page**: This is a class that represents a stateful page component, including the following 6 parts, of which initState, Reducer, and View must be set.

   - **InitState**: initialization state function

   - **Reducer**: This is a pure function. According to the action type, the corresponding function is executed to modify the state.

   - **View**: The UI part of the component, which can be built using XAML or C#

   - **Effect**: (optional) An extension to Reducer, which mainly handles side effects and executes corresponding functions according to the action type.

   - **Middleware**: (optional) middleware, such as listening functions for printing logs, etc.

   - **Dependencies**: (Optional) If a complex page is composed of multiple sub-components, you can set Adapter Connector and Slot Connector. The former is suitable for dynamic collection components, and the latter is suitable for single components.

There are five steps to use the counter as an example:

> 1. Import Maui redux package

> 2. Create State

> 3. Define Action and ActionCreator

> 4. Create Reducer that modifies state

> 5. Create Page or Component

 



## Example

You can find a simple example in this repository, showing how to use Maui.Redux to implement a Todo List application. You can run the following commands to clone this repository and run the example:

```bash

git clone https://github.com/GavinHome/Maui.Redux.git

cd Maui.Redux

```

This example is to divide a large Page into different sub-components (Components), and finally assemble it into a complete application in the Page, as shown below:



You can also check the source code in the [Example] folder to understand the implementation details of the example.