cloud_sync_shared_preferences_adapter 0.0.1

SDKflutter
Platformandroidioswindowslinuxmacosweb

A Flutter plugin for integrating Shared Preferences sync functionality.

CloudSyncSharedPreferencesAdapter

A lightweight local implementation of the SyncAdapter from the cloud_sync package, powered by SharedPreferences.

Perfect for simple sync needs, offline caching, prototypes, or fallback storage — no database required.


✨ Features

  • 📝 Persists metadata (SyncMetadata) and detail content (String) in SharedPreferences.
  • ⚡ Lightweight and fast — ideal for prototyping or minimal sync flows.
  • 📴 Supports offline storage with zero setup.
  • 🔄 Fully compatible with the cloud_sync framework.

📦 Installation

Add to your pubspec.yaml:

dependencies:
  cloud_sync: ^latest
  shared_preferences: ^latest
  cloud_sync_shared_preferences_adapter: ^latest

🚀 Usage

import 'dart:convert';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:cloud_sync_shared_preferences_adapter/cloud_sync_shared_preferences_adapter.dart';
import 'your_models/my_metadata.dart';

void main() async {
  final prefs = await SharedPreferences.getInstance();

  final adapter = CloudSyncSharedPreferencesAdapter<MyMetadata>(
    preferences: prefs,
    metadataToJson: (meta) => jsonEncode(meta.toJson()),
    metadataFromJson: (json) => MyMetadata.fromJson(jsonDecode(json)),
    getMetadataId: (meta) => meta.id,
    isCurrentMetadataBeforeOther: (a, b) => a.updatedAt.isBefore(b.updatedAt),
  );

  // Use this adapter with CloudSync to persist your data locally.
}

🧠 Class Overview

class CloudSyncSharedPreferencesAdapter<M extends SyncMetadata>
  extends SerializableSyncAdapter<M, String>

🛠️ Constructor Parameters

ParameterDescriptionRequiredDefault
preferencesInstance of SharedPreferences.✅–
metadataToJsonSerializes metadata to a String.✅–
metadataFromJsonDeserializes a String into metadata.✅–
getMetadataIdExtracts the unique ID from a metadata object.✅–
isCurrentMetadataBeforeOtherCompares two metadata objects for version ordering.✅–
prefixOptional prefix for namespacing stored keys.❌"$CloudSyncSharedPreferencesAdapter"

✅ When to Use

  • ⚡ Quick local sync for small apps or offline features.
  • 🧪 Ideal for demos, prototypes, or testing sync logic.
  • 🔙 Acts as a fallback when a cloud adapter is unavailable.

⚠️ Limitations

  • Not suitable for large or binary data — use file or database-based adapters instead.
  • SharedPreferences has platform-specific size limits (~1–2MB).


📄 License

MIT (or match your project’s license).