YndigoBlue.Velocity.Community 2026.8.12

YndigoBlue Velocity — Community Edition

Free, cross-vendor database access for .NET. Write your data layer once and run it against MySQL or PostgreSQL with no code changes.

Velocity sits on top of the existing ADO.NET providers and gives you one consistent programming and declarative interface across every supported engine — one query builder, one schema model, one set of types, regardless of which database is behind it.

About this package

YndigoBlue.Velocity.Community is the free edition. No subscription, no trial period, no usage cap — including for commercial use. It is architecture-neutral (AnyCPU) and runs anywhere .NET 10 runs.

It supports MySQL and PostgreSQL, and is a feature-limited build: the enterprise database providers and the advanced schema and spatial features are not included. Everything it does support is the same code you would write against a subscription edition, so upgrading later requires no code changes — only a package swap.

Ideal for learning Velocity, evaluating it before subscribing, and small to medium applications on MySQL or PostgreSQL.

Supported databases

Features

Included:

• Declarative schemas — read and write to and from XML, JSON and YAML
• Programmatic schema creation
• Tables, constraints (primary keys, foreign keys, checks, defaults, unique)
• Views, both SQL and declarative
• Fluent query builder and object binding
• Inserts, updates, deletes and transactions
• CSV import and export

Not included in the Community Edition:

• Geospatial types (Geometry/Geography) and spatial indexes
• Full-text indexes
• Schema versioning / UpdateSchema()
• Multiple schemas within a single database

Installation

dotnet add package YndigoBlue.Velocity.Community

Quick start

using YndigoBlue.Velocity.Model;
using YndigoBlue.Velocity.Engine;
using YndigoBlue.Velocity.Data.PostgreSql;

var connection = new PostgreSqlDatasourceConnection
{
    Hostname = "localhost",
    Port     = 5432,
    Username = "postgres",
    Password = "password",
    Database = "myapp_db"
};

using (Manager manager = new Manager(connection))
{
    Schema schema = manager.LoadSchema("public");
    Table  users  = schema["users"];

    Query query = new Query()
        .Select([users["user_id"], users["username"], users["email"]])
        .From(users);

    using (ResultSet results = manager.Retrieve(query))
    {
        foreach (Result row in results)
        {
            Console.WriteLine($"{row.GetFieldInteger("user_id")}: {row.GetFieldString("username")}");
        }
    }
}

Swap PostgreSqlDatasourceConnection for MySqlDatasourceConnection — the rest of the code is unchanged.

Upgrading

When you need the enterprise databases, geospatial support, full-text indexing or schema versioning, move to a subscription edition. Your code stays the same; only the package reference changes.

See Platform Selection for a full comparison.

Documentation

• Getting Started
• Full documentation
• Pricing and subscriptions

© YndigoBlue LLC. Licensed under the YndigoBlue Commercial Software License Agreement (Community Edition) — see the license included in this package.