The building blocks of SpanFlow are now open source. 🎉
SpanFlow's integration ecosystem is built on a modular set of small, focused .NET libraries now available on NuGet under the MIT license spanflow.app/open-source. You can integrate them directly into your .NET 8, 9, or 10 applications with zero server requirements.
🧩 7 NuGet Packages, One Job Each
Instead of a monolithic framework, SpanFlow provides independent packages for specific integration tasks:
| Package | What It Does | Targets |
|---|---|---|
SpanFlow.Expressions |
Safe {{ template }} and expression evaluation over JSON |
.NET 8, 9, 10 |
SpanFlow.Connectors.Http |
Builds HTTP requests from JSON and signs them across 10+ auth schemes | .NET 8, 9, 10 |
SpanFlow.Connectors.Files |
Streams/reads CSV, TSV, JSON, NDJSON, and XLSX across local disk, S3, Azure Blob, and FTP | .NET 8, 9, 10 |
SpanFlow.Connectors.Database |
Unified adapter for PostgreSQL, SQL Server, MySQL, and SQLite + SQL Query Advisor | .NET 8, 9, 10 |
SpanFlow.Connectors.Abstractions |
Shared connection and delivery types for connector packages | .NET 8, 9, 10 |
SpanFlow.Mapping.Core |
Declarative JSON mapping definition model and validator | .NET 8, 9, 10 + .NET Standard 2.0 |
SpanFlow.Mapping.Engine |
Executes declarative mappings (paths, functions, joins, grouping, aggregates) | .NET 8, 9, 10 + .NET Standard 2.0 |
(Additional codec support for XML/XSD, EDI, ISO 8583, and EBCDIC is available via SpanFlow.Mapping.Formats.)
🛠️ Highlights & Capabilities
-
Safe Expressions (
SpanFlow.Expressions): Evaluate user templates safely overSystem.Text.Json.Nodeswith support for comparisons, boolean logic,.length, andexists(), avoiding arbitrary code execution nuget.org/packages/SpanFlow.Expressions. -
HTTP & Auth Signing (
SpanFlow.Connectors.Http): Build requests declaratively and sign them using 10+ schemes (including API keys, OAuth 1.0a/2.0, Hawk, Digest, and JWT Bearer) with per-host throttling nuget.org/packages/SpanFlow.Connectors.Http. -
Files & Cloud Storage (
SpanFlow.Connectors.Files): Stream rows viaIAsyncEnumerableacross local folders (with path traversal protection), S3, Azure Blob, or FTP nuget.org/packages/SpanFlow.Connectors.Files. -
Multi-Database & Advisor (
SpanFlow.Connectors.Database): Unified adapters for PostgreSQL, SQL Server, MySQL/MariaDB, and SQLite, paired with aQueryAdvisorthat flags risky or unbounded queries prior to execution nuget.org/packages/SpanFlow.Connectors.Database. -
Declarative JSON Mapping (
SpanFlow.Mapping.Core&Engine): Transform complex JSON in-process using declarative rules, functions, conditional logic, and aggregations nuget.org/packages/SpanFlow.Mapping.Core.
▶️ Try Everything in Your Browser or via Docker
-
Libraries Playground: Test nodes on an interactive canvas and export C# code with
.csprojdependencies at libraries.spanflow.app. - Visual Mapping Designer: Build and debug JSON transformations visually at mapping.spanflow.app or run it locally via Docker:
docker run -p 8080:8080 ghcr.io/spanflow/mapping-designer
🔗 Links & What's Next
- GitHub Repository: SpanFlow Repo
- Open Source Overview & Docs: spanflow.app/open-source
⭐ Star the repo, test your data flows in the playground, and drop a comment below to let us know what you're building with it!
Top comments (0)