docs: Update README files to v1.1.1 - Localization fix + API deprecations

- Updated NuGet badge to v1.1.1 in root README.md

- Added v1.1.1 release notes section with localization bugfix details

- Documented culture-independent parsing fixes (CultureInfo.InvariantCulture)

- Added obsolete method migration guidance (sync -> async APIs)

- Updated CHANGELOG.md with complete v1.1.1 release notes

- Updated nuget/README.md with v1.1.1 installation instructions

- Added version history and multi-platform support details

- No breaking changes - full backward compatibility maintained

Author: MPCoreDeveloper

README.md

@@ -7,7 +7,7 @@
 
   [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
   [![.NET](https://img.shields.io/badge/.NET-10.0-blue.svg)](https://dotnet.microsoft.com/download)
-  [![NuGet](https://img.shields.io/badge/NuGet-1.1.0-blue.svg)](https://www.nuget.org/packages/SharpCoreDB)
+  [![NuGet](https://img.shields.io/badge/NuGet-1.1.1-blue.svg)](https://www.nuget.org/packages/SharpCoreDB)
   [![Build](https://img.shields.io/badge/Build-✅_Passing-brightgreen.svg)](https://github.com/MPCoreDeveloper/SharpCoreDB)
   [![Tests](https://img.shields.io/badge/Tests-772_Passing-brightgreen.svg)](https://github.com/MPCoreDeveloper/SharpCoreDB)
   [![Sponsor](https://img.shields.io/badge/Sponsor-❤️-ea4aaa?logo=githubsponsors&logoColor=white)](https://github.com/sponsors/mpcoredeveloper)
@@ -17,6 +17,27 @@
 
 ## 📌 **Current Status (February 2026)**
 
+### ✅ **Version 1.1.1 Released** - Localization Fix + API Cleanup
+
+**Latest Release**: v1.1.1 (February 2026)
+
+#### 🐛 Bug Fixes
+- **Critical**: Fixed localization bug affecting date/time formatting in non-English cultures
+- **Compatibility**: Resolved culture-dependent parsing issues (decimal separators, date formats)
+- **Portability**: Database files now fully portable across different regional settings
+
+#### 🔄 API Improvements
+- **Deprecated Methods**: Added `[Obsolete]` attributes to legacy sync methods
+- **Migration Path**: Clear upgrade guidance to async patterns (see Quickstart below)
+- **Breaking Changes**: None - full backward compatibility maintained
+
+#### 📦 Quick Install
+```bash
+dotnet add package SharpCoreDB --version 1.1.1
+```
+
+---
+
 ### ✅ **All Phases Complete — Phases 1-8 + DDL Extensions**
 
 | Area | Status |
@@ -52,13 +73,17 @@ A high-performance, encrypted, embedded database engine for .NET 10 with **B-tre
 
 ## 🚀 Quickstart
 
-Install:
+Install the latest version:
 
 ```bash
+# Install SharpCoreDB v1.1.1
+dotnet add package SharpCoreDB --version 1.1.1
+
+# Or use wildcard for latest
 dotnet add package SharpCoreDB
 ```
 
-Use:
+Use (Async API - Recommended):
 
 ```csharp
 using Microsoft.Extensions.DependencyInjection;
@@ -72,20 +97,22 @@ var factory = provider.GetRequiredService<DatabaseFactory>();
 using var db = factory.Create("./app_db", "StrongPassword!");
 
 // Create table with B-tree index
-db.ExecuteSQL("CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, age INTEGER)");
-db.ExecuteSQL("CREATE INDEX idx_age ON users(age) USING BTREE");
+await db.ExecuteSQLAsync("CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, age INTEGER)");
+await db.ExecuteSQLAsync("CREATE INDEX idx_age ON users(age) USING BTREE");
 
-// Fast inserts
-db.ExecuteSQL("INSERT INTO users VALUES (1, 'Alice', 30)");
+// Fast inserts with async API (recommended)
+await db.ExecuteSQLAsync("INSERT INTO users VALUES (1, 'Alice', 30)");
 
-// Fast queries with batch API
-var rows = db.ExecuteQuery("SELECT * FROM users WHERE age > 25");
+// Fast queries with async batch API
+var rows = await db.ExecuteQueryAsync("SELECT * FROM users WHERE age > 25");
 
 // Support for large data (>256KB)
 var largeData = new byte[10_000_000]; // 10MB
-db.ExecuteSQL("INSERT INTO files VALUES (1, @data)");
+await db.ExecuteSQLAsync("INSERT INTO files VALUES (1, @data)");
 ```
 
+> ⚠️ **API Migration Notice (v1.1.1)**: Legacy synchronous methods (`ExecuteSQL`, `ExecuteQuery`, `Flush`, `ForceSave`) are marked as `[Obsolete]`. Please migrate to async methods (`ExecuteSQLAsync`, `ExecuteQueryAsync`, `FlushAsync`, `ForceSaveAsync`) for better performance, cancellation support, and culture-independent behavior.
+
 ---
 
 ## ⭐ Key Features

docs/CHANGELOG.md

@@ -5,9 +5,45 @@ All notable changes to SharpCoreDB will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [1.1.1] - 2026-02-08
+
+### 🐛 Fixed
+- **Critical**: Fixed localization bug affecting date/time formatting in non-English locales
+  - Decimal parsing now uses `CultureInfo.InvariantCulture` throughout engine
+  - DateTime serialization now culture-independent using ISO 8601 format
+  - Resolved issues with comma vs. period decimal separators (European vs. US locales)
+  - Fixed floating-point value corruption in non-US regional settings
+- **Compatibility**: Database files now fully portable across different regional settings
+- **Impact**: Prevents data corruption when database is accessed from systems with different locale settings
+
+### 🔄 Changed
+- **API Deprecation**: Added `[Obsolete]` attributes to legacy synchronous methods with migration guidance
+  - `Database.ExecuteSQL()` → Use `Database.ExecuteSQLAsync()` instead
+  - `Database.ExecuteQuery()` → Use `Database.ExecuteQueryAsync()` instead
+  - `Database.Flush()` → Use `Database.FlushAsync()` instead
+  - `Database.ForceSave()` → Use `Database.ForceSaveAsync()` instead
+  - `SingleFileStorageProvider.Flush()` → Use `SingleFileStorageProvider.FlushAsync()` instead
+  - All obsolete methods include clear migration instructions in compiler warnings
+- **Documentation**: Updated README.md and examples to use async patterns as best practice
+- **Performance Note**: Async methods provide better performance, cancellation support, and guaranteed culture-independence
+
+### ✅ No Breaking Changes
+- All deprecated methods remain fully functional in v1.1.1
+- 100% backward compatibility maintained with existing codebases
+- Existing synchronous code continues to work without modifications
+- Deprecation warnings are informational only - upgrade at your convenience
+
+### 📊 Version Info
+- **Package Version**: 1.1.1
+- **Release Date**: February 8, 2026
+- **NuGet**: https://www.nuget.org/packages/SharpCoreDB/1.1.1
+- **GitHub Release**: https://github.com/MPCoreDeveloper/SharpCoreDB/releases/tag/v1.1.1
+
+---
+
+## [1.1.0] - 2026-01-31
 
-### 🎉 **MAJOR ACHIEVEMENT** - Single File Mode Beats SQLite AND LiteDB! (31 januari 2026)
+### 🎉 **MAJOR ACHIEVEMENT** - Single File Mode Beats SQLite AND LiteDB!
 
 **SharpCoreDB Single File mode is now the fastest embedded database for INSERT operations!** 🏆
 

nuget/README.md

@@ -1,54 +1,141 @@
-# NuGet Packaging
+# NuGet Packaging - SharpCoreDB
 
 This directory contains assets for NuGet packaging.
 
+## 📦 Current Version: **1.1.1** (February 2026)
+
+### Installation
+
+```bash
+# Install latest version (1.1.1)
+dotnet add package SharpCoreDB --version 1.1.1
+
+# Or install with wildcard (gets latest)
+dotnet add package SharpCoreDB
+```
+
+### Package Details
+- **Package ID**: SharpCoreDB
+- **Current Version**: 1.1.1
+- **License**: MIT
+- **Target Framework**: .NET 10.0
+- **Language**: C# 14
+- **NuGet Gallery**: https://www.nuget.org/packages/SharpCoreDB/1.1.1
+
+### Version History
+
+- **v1.1.1** (Feb 8, 2026): 
+  - 🐛 Fixed critical localization bug (culture-independent parsing)
+  - 🔄 Added `[Obsolete]` attributes to sync methods
+  - ✅ No breaking changes - full backward compatibility
+- **v1.1.0** (Jan 31, 2026): 
+  - 🎉 Major RDBMS improvements
+  - 🏆 Single-File performance breakthrough (37% faster than SQLite)
+  - ⚡ 17x INSERT speedup with in-memory cache architecture
+- **v1.0.0**: Initial production release
+
+### Quick Start
+
+```csharp
+using Microsoft.Extensions.DependencyInjection;
+using SharpCoreDB;
+
+var services = new ServiceCollection();
+services.AddSharpCoreDB();
+var provider = services.BuildServiceProvider();
+var factory = provider.GetRequiredService<DatabaseFactory>();
+
+// Async API (recommended as of v1.1.1)
+using var db = factory.Create("./app_db", "StrongPassword!");
+await db.ExecuteSQLAsync("CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT)");
+await db.ExecuteSQLAsync("INSERT INTO users VALUES (1, 'Alice')");
+var rows = await db.ExecuteQueryAsync("SELECT * FROM users");
+```
+
+---
+
 ## Package Icon
 
 Place your package icon here as `icon.png` (128x128 or 256x256 pixels recommended).
 
-Current icon location: `../SharpCoreDB.jpg` (referenced in Directory.Build.props)
+Current icon location: `../SharpCoreDB.jpg` (referenced in SharpCoreDB.csproj)
 
 ## README
 
 A package README can be included by referencing `README.md` from the root.
 
 ## Building Packages
 
-To build NuGet packages:
+To build NuGet packages for v1.1.1:
 
 ```bash
-# Build all packages
+# Build all packages (v1.1.1)
 dotnet pack --configuration Release --output ./artifacts
 
 # Build specific package
 dotnet pack src/SharpCoreDB/SharpCoreDB.csproj --configuration Release --output ./artifacts
+
+# Build with explicit version
+dotnet pack -p:Version=1.1.1 --configuration Release --output ./artifacts
 ```
 
 ## Publishing to NuGet
 
 ```bash
-# Publish (requires API key)
-dotnet nuget push artifacts/*.nupkg --api-key YOUR_API_KEY --source https://api.nuget.org/v3/index.json
+# Publish v1.1.1 (requires API key)
+dotnet nuget push artifacts/SharpCoreDB.1.1.1.nupkg --api-key YOUR_API_KEY --source https://api.nuget.org/v3/index.json
+
+# Verify publication
+# Visit: https://www.nuget.org/packages/SharpCoreDB/1.1.1
 ```
 
 ## Package Configuration
 
-Package metadata is configured in `Directory.Build.props` at the root:
-- Package ID
-- Version
-- Authors
-- Description
-- License
-- Icon
-- Tags
-- Repository URL
-
-## Packages
-
-The following packages are produced:
-
-1. **SharpCoreDB** - Core library
-2. **SharpCoreDB.Extensions** - Extension methods
-3. **SharpCoreDB.Data.Provider** - ADO.NET provider
-4. **SharpCoreDB.EntityFrameworkCore** - EF Core provider
-5. **SharpCoreDB.Serilog.Sinks** - Serilog sink
+Package metadata is configured in `src/SharpCoreDB/SharpCoreDB.csproj`:
+- **Package ID**: SharpCoreDB
+- **Version**: 1.1.1
+- **Authors**: MPCoreDeveloper
+- **Company**: SharpCoreDB
+- **Description**: Lightweight, encrypted, file-based database engine with SQL support, AES-256-GCM encryption, and production-ready performance
+- **License**: MIT
+- **Icon**: SharpCoreDB.jpg
+- **Tags**: database, embedded, encryption, sql, nosql, net10, csharp14, performance
+- **Repository**: https://github.com/MPCoreDeveloper/SharpCoreDB
+
+## Multi-Platform Support
+
+The package includes runtime-specific assemblies for:
+- Windows x64 (win-x64)
+- Windows ARM64 (win-arm64)
+- Linux x64 (linux-x64)
+- Linux ARM64 (linux-arm64)
+- macOS x64 (osx-x64)
+- macOS ARM64 (osx-arm64)
+
+## Packages Produced
+
+1. **SharpCoreDB** (v1.1.1) - Core library
+   - Main NuGet package
+   - All storage engines included
+   - Multi-platform support
+   - Symbol package (.snupkg) for debugging
+
+2. **Future Packages** (Planned)
+   - SharpCoreDB.Extensions - Extension methods
+   - SharpCoreDB.Data.Provider - ADO.NET provider
+   - SharpCoreDB.EntityFrameworkCore - EF Core provider
+   - SharpCoreDB.Serilog.Sinks - Serilog sink
+
+## Release Checklist
+
+Before publishing v1.1.1:
+
+- [x] Version updated in SharpCoreDB.csproj (1.1.1)
+- [x] CHANGELOG.md updated with release notes
+- [x] README.md updated with version badge
+- [x] All tests passing (772/772)
+- [x] Build succeeds with 0 errors
+- [x] Package builds successfully
+- [ ] Package published to NuGet.org
+- [ ] GitHub release created with tag v1.1.1
+- [ ] Release notes published on GitHub