Stilo Suite

Live demo projects for the Stilo suite — a family of professional, 100% managed-code .NET libraries for Blazor: a WYSIWYG HTML editor, an RDL/RDLC-compatible report designer/viewer, a document conversion engine, and an offline spell checker.

This repository contains two runnable sample apps (Blazor Server / Interactive and Blazor WebAssembly) that consume the official NuGet packages — no project references to source code, no DLLs to copy by hand.

Every Stilo package requires a license key at runtime. Individual developers can get a free annual license — no cost, no credit card, renewable every year.

👉 Get your free license at digitalsolutions.it/stilo/license

Commercial/production use beyond the free tier requires a separate commercial license — see Licensing below.

Package	NuGet	Description
Stilo.Editor		Office-style WYSIWYG HTML editor for Blazor: ribbon toolbar, pages mode, image/table editing, Markdown mode, autosave, dark theme, and more.
Stilo.Reports		Self-contained, RDL/RDLC-compatible report designer and viewer: drag-and-drop designer, Tablix (table/list/matrix), charts, barcodes/QR, PDF export.
Stilo.Documents		Document conversion engine: DOCX import/export, HTML→PDF rendering, Markdown conversion, barcode/QR generation and decoding.
Stilo.Maestro		Pure C# offline spell-checking engine, multilingual, zero JS dependency.

All four packages are 100% managed C# — no native binaries, no external services, works in both Blazor Server and Blazor WebAssembly.

Full documentation and source code: Stilo.Sources.

Everything below ships in the current release of each package — nothing here is planned/roadmap. Current versions: Stilo.Editor 1.0.1, Stilo.Reports/Stilo.Documents/Stilo.Maestro 1.0.0.

The ribbon is organized in tabs (File, Home, Source, Markdown); the Home tab is grouped exactly as below. Every entry is a real, working button in 1.0.1 — none of this is planned.

Appears automatically when you select an image or a table cell — it floats next to the selection.

Image toolbar: Wrap left / Inline / Wrap right (positioning) · quick resize presets Small / Medium / Large / Original · Filters flyout: Grayscale, Sepia, Brightness, Contrast, Remove background, Rotate left/right, Flip horizontal/vertical · Caption (toggle a caption bar under the image) · Replace image (swap the source, keep position/size) · Link (make the image clickable) · Delete image.

Table toolbar: Insert row above/below, Insert column left/right, Delete row, Delete column, Merge cells, Split cell, Delete table, border presets All borders / No borders / Outer borders, table alignment Left / Center / Right. Column widths can also be resized directly by dragging the column border in the canvas.

• Source tab — a raw HTML textarea; an Apply button commits the edited HTML back to the visual view.
• Markdown tab — same idea, editing the document as GitHub-Flavored Markdown; Apply converts it back to HTML.

Current format block · font name/size · paper format · orientation (P/L) · zoom level · live word/character count · autosave status ("Saving…" / "Saved" / error, shown only if AutoSaveCallback is set) · Keyboard shortcuts button (opens the accessibility dialog: shortcut reference, a Hover to speak text-to-speech toggle, a Magnifier toggle, and speech rate/pitch sliders) · UI language selector (ribbon, dialogs and status bar are fully localized).

StiloEditor is fully self-contained: CSS and JavaScript are embedded resources the component injects into the page itself at runtime. No <link>/<script> tags, no <HeadOutlet>, no static-assets base path to configure — register the service and drop the component.

• Multi-selection — click with modifier or drag a marquee; the toolbar shows "{n} items selected".
• 8-handle resize on any selected item; align (Left/Center horiz./Right/Top/Center vert./Bottom) and distribute (Horizontally/Vertically) for multi-selections.
• Tablix column resize by dragging column borders directly on the canvas.
• Resizable header/body/footer section boundaries, with millimeter rulers and snap-to-grid.

Opens from any expression-capable property (double-click, or the fx field): a text editor with autocomplete plus three browsable trees — Parameters, Globals, Functions — and Apply/Cancel buttons. See the expression language reference in the technical docs for the full function/operator list.

A dedicated dialog for "print N labels per page" scenarios:

First page / Previous page / page number input / Next page / Last page · Zoom in/out · Refresh · Export PDF · Print · Search (with previous/next match navigation and a "no matches" state) · Bookmarks panel · an auto-generated Parameters prompt bar (dropdown/checkbox/date input per parameter type) when the report defines any.

Barcode/QR generation and decoding is implemented once, in Stilo.Documents.Bars, and shared by both Stilo.Editor (Insert → barcode dialog) and Stilo.Reports (Barcode 1D/2D toolbox items, BarcodeItem, and the label sheet wizard) — the dropdown of available symbologies you see in either product's UI is generated directly from the same list, so it's always in sync.

Symbologies fully supported — encode and decode, round-trip verified:

For each of these, Stilo.Documents.Bars.BarcodeImageWriter.GeneratePng(...) renders a barcode/QR straight to a PNG byte array (no image assets, no external service, no native dependency), and Stilo.Documents.Bars.BarcodeReader can decode a generated image back to its original value — every symbology above has an automated round-trip test (generate → decode → compare) passing.

Where you'll find this in the two demo apps:

• Editor — Insert → Insert barcode opens a dialog with a symbology dropdown (all 7 above) and a value field; it inserts the result as a normal <img>, so it moves/exports with the rest of the content like any other image.
• Reports — drag a 1D Barcode or 2D Barcode item from the toolbox (or use the barcode field in the label sheet wizard); the Properties panel's Barcode category lets you pick the symbology, bind the value to a dataset field via an expression (=Fields!Sku.Value), toggle Show text, and set the bar color. Because it's a normal report item, it works inside a Tablix cell too — e.g. one barcode per row in a product list.

• DOCX import — Office Open XML (.docx) → HTML conversion.
• DOCX export — HTML → .docx, producing a real Word-compatible document (not an HTML-in-disguise file).
• PDF generation — HTML → PDF rendering, with font embedding, image and table support.
• PDF import — PDF → HTML conversion (layout-preserving: absolute-positioned spans, vector paths, embedded images).
• Markdown conversion — HTML ↔ GitHub-Flavored Markdown, bidirectional.
• Barcode / QR generation and decoding — encoders for QR Code, Code128, EAN-13, Code39, Codabar, Code93 and Interleaved 2 of 5, plus a BarcodeReader for round-trip decoding.
• Pure C# — zero native libraries (no wkhtmltopdf, no GDI+/Skia dependency, no external binaries to deploy), fully compatible with Blazor WebAssembly's sandboxed runtime as well as Blazor Server.

Used internally by Stilo.Editor (import/export ribbon actions) and Stilo.Reports (PDF export, barcodes) — you don't need to reference or configure it yourself for those two packages, it's pulled in automatically. Use it directly if you just need document conversion or barcode generation without the editor/reports UI.

• Inline spell checking — real-time red wavy underline directly in Stilo.Editor's content.
• Multilingual — embedded dictionaries: Italian, English (US), English (UK), German, French, Spanish.
• Contextual suggestions — click a misspelled word to open a suggestion popup.
• Custom dictionary — add words to a personal/user dictionary directly from the suggestion popup ("add to personal dictionary").
• 100% offline — dictionaries are embedded resources; no network calls, no external spell-check service, works disconnected.
• Pure C# — Damerau-Levenshtein distance for suggestions plus a common-mistakes map, zero native dependencies, compatible with both Blazor WASM and Server.
• Standalone flyout — <StiloSpellFlyout /> can also be used outside Stilo.Editor if you're building your own text surface.

Each package is installed independently — take only what you need.

dotnet add package Stilo.Editor
dotnet add package Stilo.Maestro   # optional, adds inline spell checking

Program.cs:

builder.Services.AddStiloEditor();
builder.Services.AddStiloMaestro();  // optional

App.razor / _Host.cshtml:

<link rel="stylesheet" href="_content/Stilo.Editor/css/stilo-editor.css" />
<link rel="stylesheet" href="_content/Stilo.Maestro/css/stilo-maestro.css" />
<script src="_content/Stilo.Editor/js/stilo-editor.js"></script>
<script src="_content/Stilo.Editor/js/stilo-editor-plugins.js" type="module"></script>

Usage:

@using Stilo.Editor.Components

<StiloEditor @bind-Value="_html" Options="_options" />

@code {
    private string _html = "<p>Start writing...</p>";
    private EditorOptions _options = new() { MinHeight = 400, MaxHeight = 700, ShowStatusBar = true };
}

dotnet add package Stilo.Reports

Stilo.Documents is pulled in automatically (used for PDF export and barcodes) — no need to add it manually.

Program.cs:

builder.Services.AddStiloReports();

Make sure a <HeadOutlet> is rendered (already the case in the standard Blazor Web App template) — the components inject their CSS/JS through it, no manual <link>/<script> tags needed.

Usage:

@using Stilo.Reports.Components
@using Stilo.Reports.Data

<StiloReportViewer ReportDefinition="_report" DataSources="_dataSources" />
<StiloReportDesigner @bind-Report="_report" />

dotnet add package Stilo.Documents

No service registration required — inject IHtmlToPdfConverter / use Stilo.Documents.Converters.* and Stilo.Documents.Bars.* directly.

dotnet add package Stilo.Maestro

builder.Services.AddStiloMaestro();

@using Stilo.Maestro.Components
<StiloSpellFlyout />

cd Stilo.Sample.Server
dotnet run

Pages: / (Editor), /report-designer (Report Designer), /report-viewer (Report Viewer).

cd Stilo.Sample.Wasm
dotnet run

Both projects reference the Stilo packages via PackageReference (NuGet), resolved from nuget.org — nothing is copied or referenced by DLL/project path.

• .NET 9.0+
• Blazor Server (Interactive) or Blazor WebAssembly
• A free or commercial Stilo license — see above

• Individual developers: free annual license, renewable every year, no cost — digitalsolutions.it/stilo/license.
• Commercial/production use: requires a separate written authorization from the author.

For commercial licensing inquiries: Francesco Paolo Passaro — info@digitalsolutions.it

Full license terms: see LICENSE in the Stilo.Sources repository.

This repository does not include any license file — do not copy a .license file from another machine/project; request your own from the link above.