SharpCoreDB 1.5.0

dotnet add package SharpCoreDB --version 1.5.0
                    
NuGet\Install-Package SharpCoreDB -Version 1.5.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SharpCoreDB" Version="1.5.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SharpCoreDB" Version="1.5.0" />
                    
Directory.Packages.props
<PackageReference Include="SharpCoreDB" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SharpCoreDB --version 1.5.0
                    
#r "nuget: SharpCoreDB, 1.5.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SharpCoreDB@1.5.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SharpCoreDB&version=1.5.0
                    
Install as a Cake Addin
#tool nuget:?package=SharpCoreDB&version=1.5.0
                    
Install as a Cake Tool

SharpCoreDB v1.5.0 - Production Database Engine

High-Performance Embedded AND Networked Database for .NET 10

SharpCoreDB is a modern, encrypted, file-based database engine with SQL support, built for production applications. Now available as both embedded database and network server.

✨ What's New in v1.5.0

🎉 Phase 11 Complete: Network Database Server

  • SharpCoreDB.Server - Full network database server with gRPC, Binary TCP, HTTPS REST, WebSocket
  • Multi-Language Clients - .NET, Python (PyPI), JavaScript/TypeScript (npm)
  • Enterprise Security - JWT + Mutual TLS + RBAC
  • Cross-Platform Deploy - Docker, Windows Service, Linux systemd

🐛 Critical Bug Fixes

  • Database Reopen: Fixed edge case where closing and immediately reopening a database would fail
  • Metadata Handling: Graceful empty JSON handling for new databases
  • Durability: Immediate metadata flush ensures persistence on disk

📦 New Features

  • Brotli Compression: 60-80% smaller metadata files with zero CPU overhead
  • Backward Compatible: Auto-detects compressed vs raw JSON format
  • Enterprise Distributed: Phase 10 complete with sync, replication, transactions

🚀 Key Features

Embedded Database - Single-file storage, no server required
Network Server Mode - gRPC/HTTP/WebSocket protocols (NEW!)
Encrypted - AES-256-GCM encryption built-in
SQL Support - Full SQL syntax, prepared statements
High Performance - 6.5x faster than SQLite for bulk operations
Modern C# 14 - Latest language features, NativeAOT ready
Cross-Platform - Windows, Linux, macOS, ARM64 native
Production Ready - 1,468+ tests, zero known critical bugs
Multi-Language - .NET, Python, JavaScript/TypeScript clients

📊 Performance

  • Bulk Insert (1M rows): 2.8 seconds
  • Analytics (COUNT 1M): 682x faster than SQLite
  • Vector Search: 50-100x faster than SQLite
  • Metadata Compression: <1ms overhead
  • gRPC Query Latency: 0.8-1.2ms (p50)
  • Concurrent Connections: 1000+ (server mode)

🔗 Package Ecosystem

This package installs the core database engine. Extensions available:

Server Mode (NEW!):

  • SharpCoreDB.Server - Network database server with gRPC/HTTP/WebSocket
  • SharpCoreDB.Client - .NET client library (ADO.NET-style)

Analytics & Search:

  • SharpCoreDB.Analytics - 100+ aggregate & window functions (150-680x faster)
  • SharpCoreDB.VectorSearch - SIMD-accelerated semantic search (50-100x faster)
  • SharpCoreDB.Graph - Lightweight graph traversal (30-50% faster)

Distributed Features:

  • SharpCoreDB.Distributed - Multi-master replication, sharding, transactions
  • SharpCoreDB.Provider.Sync - Dotmim.Sync integration (bidirectional sync)

Optional Integrations:

  • SharpCoreDB.EntityFrameworkCore - EF Core provider
  • SharpCoreDB.Extensions - Helper methods and utilities
  • SharpCoreDB.Serilog.Sinks - Database logging sink

🌐 Multi-Language Support

Python Client (PyPI):

pip install pysharpcoredb

JavaScript/TypeScript (npm):

npm install @sharpcoredb/client

📚 Documentation

Full docs: https://github.com/MPCoreDeveloper/SharpCoreDB/blob/master/docs/INDEX.md

Server Quick Start: https://github.com/MPCoreDeveloper/SharpCoreDB/blob/master/docs/server/QUICKSTART.md

Version 1.5.0 docs:

💻 Quick Example

using SharpCoreDB;

// Create database
var factory = new DatabaseFactory();
var db = factory.Create("myapp.scdb", "master-password");

// Execute SQL
db.ExecuteSQL("CREATE TABLE users (id INT PRIMARY KEY, name TEXT)");
db.ExecuteSQL("INSERT INTO users VALUES (1, 'Alice')");

// Query data
var results = db.ExecuteQuery("SELECT * FROM users WHERE id = 1");
foreach (var row in results)
{
    Console.WriteLine($"{row["id"]}: {row["name"]}");
}

db.Flush(); // Persist to disk

🏆 Production Features

  • ACID Compliance - Full transaction support with WAL
  • Backup & Recovery - Point-in-time recovery, checkpoint management
  • Concurrency - Thread-safe operations, connection pooling
  • Multi-Tenant - Row-level security, schema isolation
  • Enterprise Sync - Bidirectional sync with PostgreSQL, SQL Server, MySQL
  • Monitoring - Health checks, metrics, performance stats

🔒 Security

  • AES-256-GCM encryption for sensitive data
  • Password-based key derivation (PBKDF2)
  • No plaintext passwords or keys in memory
  • Audit logging support

📈 Performance Optimizations

  • Tiered JIT with PGO (1.2-2x improvement)
  • SIMD vectorization where applicable
  • Memory-mapped I/O for fast reads
  • Batched writes for high throughput
  • Query plan caching

🛠️ Use Cases

  • Time Tracking Apps - Embedded, encrypted, offline-first
  • Invoicing Systems - Multi-tenant, backup-friendly
  • AI/RAG Agents - Vector search, knowledge base
  • IoT/Edge Devices - ARM64 native, minimal footprint
  • Mobile Apps - Sync with cloud database
  • Desktop Applications - Single-file deployment

📦 Installation

dotnet add package SharpCoreDB

🔄 Upgrade from v1.3.5

100% backward compatible - No breaking changes!

dotnet add package SharpCoreDB --version 1.5.0

Your existing databases work as-is. New metadata is automatically compressed.

🐛 Bug Reporting

Found an issue? Report it on GitHub: https://github.com/MPCoreDeveloper/SharpCoreDB/issues

📄 License

MIT License - See LICENSE file in the repository

🙏 Contributing

We welcome contributions! Check the repository for contribution guidelines.


Latest Version: 1.5.0 (Feb 20, 2026)
Target: .NET 10 / C# 14
Tests: 1,468+ (100% passing)
Status: ✅ Production Ready

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (13)

Showing the top 5 NuGet packages that depend on SharpCoreDB:

Package Downloads
SharpCoreDB.EntityFrameworkCore

Entity Framework Core provider for SharpCoreDB encrypted database engine. Built for .NET 10 with C# 14. Supports Windows, Linux, macOS, Android, iOS, and IoT/embedded devices with platform-specific optimizations. Compatible with SharpCoreDB 1.5.0.

SharpCoreDB.Serilog.Sinks

A Serilog sink for SharpCoreDB - a lightweight, encrypted, file-based database. Features efficient batch logging with AES-256-GCM encryption, AppendOnly storage engine for maximum write speed, and full async support. Compatible with SharpCoreDB 1.5.0+.

SharpCoreDB.Extensions

Extensions for SharpCoreDB including Dapper integration and ASP.NET Core health checks. Built for .NET 10 with C# 14. Supports Windows, Linux, macOS, Android, iOS, and IoT/embedded devices with platform-specific optimizations.

SharpCoreDB.Data.Provider

Data provider layer for SharpCoreDB on .NET 10.

SharpCoreDB.Provider.YesSql

YesSql provider for SharpCoreDB encrypted database engine. Built for .NET 10 with C# 14. Supports Windows, Linux, macOS, Android, iOS, and IoT/embedded devices with platform-specific optimizations.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.5.0 111 3/14/2026
1.4.1 213 2/28/2026
1.3.5 181 2/21/2026
1.3.0 169 2/14/2026
1.1.1 152 2/8/2026
1.1.0 142 2/8/2026
1.0.6 241 2/1/2026
1.0.5 235 1/11/2026
1.0.4 151 1/3/2026
1.0.0 178 12/26/2025

v1.5.0: New features - Data Compression with LZ4 and Zstd, configurable at runtime. Improved encryption performance. Experimental support for Windows CE and IoT Core. Enhanced globalisation/localisation features. Updated dependencies for security and performance. 1000+ total tests with all CI green. See breaking changes in migration guide.