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
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
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
Choose packages
Take the model and engine, a renderer, and a viewer or designer for your host.
Run a first report
Register a data provider, create the engine and run a report definition.
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
- Overview What Beep.Reports is and where the product stands.
- Developer guide Packages, a minimal run, data, designer embedding, output and extension points.
- Designer guide Authoring tasks for report authors, from bands to export.
- Administrator guide Deployment, configuration, backups, scheduling and security.
- MCP server Authoring reports and dashboards from an AI client.
- Localization Multi-language reports and a localized designer.
- All Reports documentation The full guide, from the start page.