Dash

Warning

This project is in very early, heavy development. Expect breaking changes, missing features, and rough edges. It is not ready for use.

Information dashboard application built with Avalonia and Ink. Runs locally as a desktop app or on a server with multi-user support, with a WASM demo available in the browser.

Documentation | Live demo

Solution Layout

• src/Dash.Client/: master folder for the shared Avalonia client project and platform-specific hosts.
• src/Dash.Server/: master folder for the ASP.NET Core health API scaffold, provider-neutral persistence/migrations contracts, SQLite provider implementations, domain entities, persistence readiness checks, and observability wiring.
• src/Dash.WidgetSdk/: public widget SDK contracts for configuration, state envelopes, Avalonia rendering, server execution, and shared JSON serialization.
• src/Dash.Widgets/: isolated widget implementations. Widgets depend on the SDK, not on each other.

Widget Shape

• DigitalClock demonstrates a client-only widget: the server only needs to persist its configuration.
• EmailChecker demonstrates a client-and-server widget: the server produces JSON state and the client renders it.
• Dash.WidgetSdk.Avalonia is the client rendering boundary. Widgets return Avalonia controls and the app provides styling later.
• Dash.Client.WidgetHost and Dash.Server.WidgetHost are lightweight catalogs for Avalonia and server widget implementations.

Server Persistence

• The server uses EF Core with SQLite via Microsoft.EntityFrameworkCore.Sqlite.
• Dash.Server.Persistence contains provider-neutral settings, EF model/configuration, and readiness abstractions.
• Dash.Server.Persistence.Sqlite contains the current SQLite EF registration and readiness probe.
• Dash.Server.Migrations contains the portable FluentMigrator migration set plus startup coordination.
• Provider selection lives in configuration under Database:Provider. Sqlite is implemented today; PostgreSql is scaffolded as the next provider to add.
• Current domain shape: User (UserId, Name) -> Page (PageId, UserId, Name) -> Widget (WidgetId, PageId, WidgetType, ConfigurationJson)
• Default database files: src/Dash.Server/Dash.Server.Api/data/dash.db src/Dash.Server/Dash.Server.Api/data/dash.dev.db
• The shared migration set also seeds a small sample dashboard with a couple of users, pages, and the current digital-clock / email-checker widgets.

API Docs

• In development, the server exposes OpenAPI at /openapi/v1.json and Scalar at /scalar.

Contact

• Security isssues: security@inventing-animals.com
• Talk to us at: hello@inventing-animals.com

License

MIT