Reports

A datasource-agnostic reporting platform for BeepDM, with a visual report designer built on Beep.Skia for the web and the desktop.

Included in the Applications subscription

$80 /monthor$800 /year

Save $160

1 product, and every one added later. Paid in advance, does not renew automatically.

Category
Applications
Status
In development: the solution scaffold and foundation contracts exist
Hosts
WPF, WinForms and Blazor, with starter templates for each
Data
BeepDM data sources and units of work, typed .NET objects and in-memory tables
AI clients
An MCP server over stdio for report and dashboard authoring
Run a report from a definition C#
var providers = new PluginRegistry<IReportDataProvider>();
providers.Register(new InMemoryDataProvider().AddTable("sales", "orders", fields, rows));
var expressions = ExpressionEngine.CreateDefault();
var engine = new ReportEngine(new ReportEngineOptions
{
    Validator = DefinitionValidator.CreateDefault(new ExpressionEngineValidator(expressions)),
    Data = new ReportDataService(providers),
    Expressions = expressions,
    PageStoreFactory = () => new InMemoryPageStore(),
    Measurer = new SkiaTextMeasurer(fontResolver),
    ItemLayouters = BuiltInItemLayouters.CreateRegistry(),
    Reporter = reporter,                 // IOperationReporter: log + audit + UI
});
var outcome = await engine.RunAsync(definition, context, progress, cancellationToken);

What it is

Beep.Reports builds reports and dashboards over any BeepDM data source. Report authors design layouts in a visual designer drawn with Beep.Skia, on WPF, WinForms or in the browser, and reports can carry strings in several languages. Reports are stored as files that follow a published schema, and an MCP server lets AI clients create and edit reports and dashboards. It is in development: the solution scaffold and foundation contracts exist, and the designer and runtime are still being built.

For people who want something that works today.

What it does

Visual designer

  • Bands, items, text alignment and formats
  • Expressions, fields and parameters
  • Totals and carried balances
  • Actions, bookmarks and the document map
  • Page setup, preview, print and export
  • Keyboard and accessibility support

For developers

  • Adapters for BeepDM data sources, units of work and typed .NET objects
  • Filter, sort, top and distinct applied locally when a provider cannot push them down
  • One shared designer core, with the host only drawing and forwarding input
  • A designer policy that limits item types, commands and scripts
  • Failures returned as typed diagnostics with a correlation id, not exceptions

Languages and operations

  • Report content in several languages, with strings stored inside the report file
  • A localized designer, kept separate from report localization
  • Log, audit and user notification through one reporting service

Get started

  1. Choose packages

    Take the model and engine, a renderer, and a viewer or designer for your host.

  2. Run a first report

    Register a data provider, create the engine and run a report definition.

  3. Start the MCP server

    Run the server from a checkout so an MCP client can create and edit reports.

    Run the server Shell
    dotnet run --project src/Beep.Reports.Mcp -c Release

Documentation

Start with Reports

SubscribeApplications: $80/mo or $800/yr, save $160 a year
$ reconnecting --to server connection lost — attempting to rejoin…