https://github.com/jspuij/Cortex.Net

State management like MobX for .NET and Blazor
https://github.com/jspuij/Cortex.Net

Last synced: 3 months ago
JSON representation

State management like MobX for .NET and Blazor

• Host: GitHub
• URL: https://github.com/jspuij/Cortex.Net
• Owner: jspuij
• License: mit
• Created: 2019-10-17T19:07:17.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-01-06T04:19:51.000Z (over 1 year ago)
• Last Synced: 2024-02-27T16:13:34.256Z (4 months ago)
• Language: C#
• Homepage: https://jspuij.github.io/Cortex.Net.Docs
• Size: 1.92 MB
• Stars: 79
• Watchers: 7
• Forks: 11
• Open Issues: 36
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Lists

• AdrienTorris_awesome-blazor - Cortex.Net - State management like MobX for .NET and Blazor. (Libraries & Extensions / Tools & Utilities)
• awesome-blazor - Cortex.Net -   State management like MobX for .NET and Blazor. [Documentation](https://jspuij.github.io/Cortex.Net.Docs/pages/index.html). (Libraries & Extensions / Tools & Utilities)
• blazor-awesome - Cortex.Net - State management like MobX for .NET and Blazor. (Libraries & Extensions / Tools & Utilities)

README

        




# Cortex.Net

_State management like [MobX](https://mobx.js.org/README.html) for .NET_

## NuGet installation

To install the main library, install the the [Cortex.Net NuGet package](https://nuget.org/packages/Cortex.Net/). The main library allows you to compose observable reactive state yourself.

```powershell

PM> Install-Package Cortex.Net

```

If you want to install the Blazor bindings, they are in a separate package:

Install the [Cortex.Net.Blazor NuGet package](https://nuget.org/packages/Cortex.Net.Blazor/):

```powershell

PM> Install-Package Cortex.Net.Blazor

```

### Add to FodyWeavers.xml

To make life easier Cortex.Net supports weaving to create transparent observable state. To do this you need to create a FodyWeavers.xml file and add it to your project.

Add `` to [FodyWeavers.xml](https://github.com/Fody/Home/blob/master/pages/usage.md#add-fodyweaversxml)

```xml

  

```

## Introduction

Cortex.Net is a library that makes state management simple and scalable by transparently applying [functional reactive programming](https://en.wikipedia.org/wiki/Functional_reactive_programming) (TFRP). It is more or less a direct port of the excellent [MobX](https://mobx.js.org/README.html) library. As C# has Class-based inheritance versus the Prototype-based inheritance model of JavaScript, porting the library introduced some unique challenges. These are mostly solved by [Weaving](https://github.com/Fody/Fody) your library of state objects.

The philosophy behind Cortex.Net is very simple:

_Anything that can be derived from the application state, should be derived. Automatically._

which includes the UI, data serialization, server communication, etc.

[Blazor](https://dotnet.microsoft.com/apps/aspnet/web-apps/blazor) and Cortex.Net together are a powerful combination. Blazor renders the application state by providing mechanisms to translate it into a tree of renderable components. Cortex.Net provides the mechanism to store and update the application state that Blazor then uses.



Both Blazor and Cortex.Net provide optimal and unique solutions to common problems in application development. Blazor provides mechanisms to optimally render UI by using a virtual DOM that reduces the number of costly DOM mutations. Cortex.Net provides mechanisms to optimally synchronize application state with your Blazor components by using a reactive virtual dependency state graph that is only updated when strictly needed and is never stale.

## Documentation

Documentation for this project is available at https://jspuij.github.io/Cortex.Net.Docs.