Table of Contents

Getting Started

Prerequisites

Before installing Velocity, you'll need:

  • .NET 10 SDK or later (download here)
  • Either:
    • An YndigoBlue subscription with access credentials for the private NuGet feed (for full-featured versions)
    • OR: The free Community Edition from nuget.org (MySQL and PostgreSQL only, with feature limitations)
  • A supported IDE or text editor (Visual Studio, Visual Studio Code, or any editor for command-line development)

Obtaining Access

Community Edition (Free)

The YndigoBlue.Velocity.Community package is freely available on nuget.org without requiring a subscription. This edition provides core Velocity functionality with the following limitations:

Supported Databases:

  • MySQL
  • PostgreSQL

Feature Limitations:

  • ❌ No geospatial data types (Geometry/Geography) or spatial operations
  • ❌ No full-text indexes
  • ❌ No schema versioning or UpdateSchema() functionality
  • ❌ No support for multiple schemas within a database
  • ❌ No support for DB2, Oracle, SQL Server, SQLite, or Teradata

Installing the Community Edition:

dotnet add package YndigoBlue.Velocity.Community

The Community Edition is ideal for:

  • Learning Velocity and evaluating its capabilities
  • Small projects using MySQL or PostgreSQL
  • Applications with basic data access needs
  • Development and testing environments

Cross-Platform Package (Subscription or Partnership Required)

The cross-platform package is distributed either through a private YndigoBlue NuGet feed or downloaded from the YndigoBlue website if you have an active partnership here.

To access this package, you must first subscribe and obtain your credentials or apply for a partnership.

This version includes support for five databases, geospatial operations, full-text indexing, schema versioning, and multi-schema support.

Platform-Specific Packages (Subscription Required)

The platform specific packages are distributed through a private YndigoBlue NuGet feed only. To access these packages, you must first subscribe and obtain your credentials.

This version includes support for all seven databases, geospatial operations, full-text indexing, schema versioning, and multi-schema support.

Configuring the NuGet Feed (with YndigoBlue subscription)

Once you have your credentials, you'll need to configure your development environment to access the YndigoBlue NuGet feed at:

https://www.yndigoblue.com/nuget/v3/index.json

Choose the setup method that matches your development environment:

Visual Studio

  1. Open Visual Studio
  2. Go to Tools > NuGet Package Manager > Package Manager Settings
  3. Navigate to NuGet Package Manager > Sources
  4. Click the + Add button to add a new source
  5. Set the following values:
    • Name: YndigoBlue
    • Source: https://www.yndigoblue.com/nuget/v3/index.json
  6. Click Save
  7. Go to Tools > NuGet Package Manager > Manage NuGet Packages for Solution...
  8. Select YndigoBlue from the package source dropdown
  9. When prompted, enter your username and password provided by YndigoBlue, check Remember Password.

Installing Velocity in a project:

  1. Right-click on your project in Solution Explorer
  2. Select Manage NuGet Packages
  3. Select YndigoBlue from the package source dropdown
  4. Search for YndigoBlue.Velocity (or a platform-specific variant)
  5. Click Install

Visual Studio Code

Visual Studio Code uses the .NET CLI for NuGet operations. Follow the command-line setup below, then use the terminal in VS Code to manage packages.

For a better experience, install the NuGet Package Manager extension:

  1. Open VS Code
  2. Go to Extensions Ctrl+Shift+X (Cmd+Shift+X on macOS)
  3. Search for "NuGet Package Manager"
  4. Install the extension by jmrog

After configuring the NuGet source via command line (see below), you can:

  • Press Ctrl+Shift+P (Cmd+Shift+P on macOS)
  • Type "NuGet: Add Package"
  • Search for and install YndigoBlue.Velocity

Command Line (.NET CLI)

Add the NuGet source:

dotnet nuget add source https://www.yndigoblue.com/nuget/v3/index.json \
  --name YndigoBlue \
  --username YOUR_USERNAME \
  --password YOUR_PASSWORD \
  --store-password-in-clear-text

Security Note: The --store-password-in-clear-text flag stores credentials in plain text. For better security, consider using --configfile to specify a user-specific NuGet.config file with appropriate permissions, or omit the password flag to be prompted interactively.

Alternative: Interactive authentication:

dotnet nuget add source https://www.yndigoblue.com/nuget/v3/index.json \
  --name YndigoBlue \
  --username YOUR_USERNAME

You'll be prompted for the password when accessing packages.

Installing Velocity in a project:

Navigate to your project directory and run:

dotnet add package YndigoBlue.Velocity

Or to specify a particular version:

dotnet add package YndigoBlue.Velocity --version 2026.5.1

For platform-specific packages with DB2 and SQLite support, use:

dotnet add package YndigoBlue.Velocity.Windows
dotnet add package YndigoBlue.Velocity.Linux
dotnet add package YndigoBlue.Velocity.MacOS
dotnet add package YndigoBlue.Velocity.RaspberryPi

Verifying the installation:

dotnet list package

You should see Velocity listed in your project dependencies.

Troubleshooting

Cannot authenticate to NuGet feed:

  • Verify your credentials are correct
  • Ensure your subscription is active
  • Check that the NuGet source URL is exactly: https://www.yndigoblue.com/nuget/v3/index.json

Package not found:

  • Confirm the YndigoBlue source is listed: dotnet nuget list source
  • Try clearing the NuGet cache: dotnet nuget locals all --clear
  • Verify you're searching in the YndigoBlue source, not just nuget.org

Platform-specific errors:

  • Ensure you're using the correct platform package for your target OS
  • Verify .NET 10 SDK is installed: dotnet --version