PolyKV - Dart / Flutter #

Zero Configuration Key-Value Store for Flutter & Dart.

PolyKV for Flutter is the ultimate cross-platform persistence solution. It abstracts away SharedPreferences (Mobile), localStorage (Web), and File I/O (Desktop) into a single, unified API.

One API, Everywhere. This library is part of the PolyKV ecosystem. Use the same consistent API across 12+ languages.

✨ Why PolyKV Dart? #

• 🦋 Flutter Optimized Works seamlessly on iOS, Android, macOS, Windows, Linux, and Web. One package to rule them all.

• 📱 Native Performance Uses platform-native storage engines directly. No SQLite overhead, no heavy initialization.

• 🛡 Compile-Time Safety Strongly typed Dart API prevents runtime errors.

📦 Installation #

flutter pub add polykv

🚀 Usage #

Complete Async Example #

import 'package:polykv/polykv.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // Init
  final kv = await PolyKV.init("MyApp");
  
  // 1. Save (Set)
  await kv.setString("username", "alice");
  await kv.setBool("is_dark_mode", true);
  await kv.setMap("profile", {"age": 30});

  // 2. Read (Get)
  final user = await kv.getString("username");
  print("User: $user");

  // 3. Update
  await kv.setBool("is_dark_mode", false);

  // 4. Delete
  await kv.remove("profile");

  // 5. Clear All
  await kv.clear();
}

📂 Storage Locations #

• Mobile: SharedPreferences (Android) / UserDefaults (iOS)
• Web: Browser localStorage
• Desktop: standard ~/.config or %APPDATA% JSON files.

🌍 Platform Support #

✅ Runtime Verified: Full CRUD operations verified via automated tests on actual devices/simulators.

📜 License #

MIT