AlisReactive 1.0.0-preview.22

Alis.Reactive

Plan-driven reactive framework for ASP.NET MVC. C# fluent builders produce JSON plans executed by a browser runtime. Zero JavaScript in views.

Packages

All library packages target net48 and net10.0 (NativeTagHelpers is net10.0 only).

Getting Started

Prerequisites: .NET SDK 10.0.x and Node.js 22+.

A fresh clone has no installed dependencies and no built bundles. Run these three commands from the repo root, in order:

npm ci                                          # 1. install JS dependencies
npm run build:all                               # 2. build the JS/CSS bundles
dotnet run --project Alis.Reactive.SandboxApp    # 3. start the sandbox

Open http://localhost:5220 — the sandbox home page is the index of component demos.

Order matters: the sandbox serves the bundles produced by build:all and refuses to start without them. If you skip step 2, startup throws with a message telling you to run npm run build:all.

Developing

Three terminals give a live edit/refresh loop:

npm run watch                                    # framework JS  — rebuild on .ts edit
npm run watch:css                                # framework CSS — rebuild on .css edit
dotnet watch --project Alis.Reactive.SandboxApp  # Razor + C# hot reload

• Edit .ts / .css under Alis.Reactive.Assets/ → save → browser refresh. No restart.
• Edit .cshtml / .cs → dotnet watch hot-reloads automatically.

The full command reference — every build, test, and pack command — lives in CLAUDE.md → Build & Run, the canonical guide.

How the bundles ship

npm run build:all produces JS/CSS bundles that three places consume. Every bundle output path is gitignored — git status stays clean after a build.

Repo Layout

Alis.Reactive/                    C# core library (packed as AlisReactive NuGet)
Alis.Reactive.Native/             C# native-component library
Alis.Reactive.Fusion/             C# Syncfusion-component library
Alis.Reactive.FluentValidator/    C# validator-extraction library
Alis.Reactive.NativeTagHelpers/   C# tag helpers (net10 only)
Alis.Reactive.Analyzers/          Roslyn analyzers (shipped with AlisReactive)
Alis.Reactive.Assets/             Framework JS + CSS source — pure npm package, no csproj
Alis.Reactive.SandboxApp/         Dev harness + live component demos
examples/resident-intake/         Published-NuGet consumer example
tests/                            Test projects (NUnit + vitest + Playwright)

The framework's JS runtime lives in Alis.Reactive.Assets/ — a sibling folder with its own package.json, no csproj, no MSBuild orchestration of npm. This mirrors how dotnet/aspnetcore ships Blazor's Web.JS and SignalR's TypeScript client.

License

MIT