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!
