ifl #

Contract-first storage foundation for Flutter apps.

Public API #

• package:ifl/ifl.dart
  • Contracts only (Storage, KvStorage, DatabaseStorage)
• package:ifl/ifl_hive.dart
  • Stable Hive entrypoint (initHiveKvStorage)
• package:ifl/ifl_secure.dart
  • Stable secure storage entrypoint (createSecureKvStorage)

Example: use Hive + Secure KV together #

import 'package:flutter_secure_storage/flutter_secure_storage.dart';
import 'package:ifl/ifl.dart';
import 'package:ifl/ifl_hive.dart';
import 'package:ifl/ifl_secure.dart';

Future<void> setupStorage() async {
  final KvStorage hiveKv = await initHiveKvStorage(boxName: 'app_cache');
  final KvStorage secureKv = createSecureKvStorage(
    name: 'secure_user',
    storage: const FlutterSecureStorage(),
  );

  await secureKv.write('token', 'xxx');
  await hiveKv.write('profile', '{"name":"if"}');
}

Defaults:

• boxName = '@ifl'
• subDir = 'kv_storage'
• after first initialization, a different subDir will be ignored (with log)

Notes #

• Avoid importing package:ifl/src/... directly in app code.
• Keep business code dependent on KvStorage contract, not concrete engines.