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 over System.Text.Json.Nodes with support for comparisons, boolean logic, .length, and exists(), 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 via IAsyncEnumerable across 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 a QueryAdvisor that 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 .csproj dependencies 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

⭐ 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!