react-native-storage-manager

majiayu000 的头像作者 majiayu000

通过加密处理 MMKV 存储操作和数据持久模式。在 Purrsuit 移动应用程序中实现数据持久性、缓存或用户首选项时使用。

📖 中文导读:通过加密处理 MMKV 存储操作和数据持久模式。在 Purrsuit 移动应用程序中实现数据持久性、缓存或用户首选项时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: react-native-storage-manager description: Handles MMKV storage operations and data persistence patterns with encryption. Use when implementing data persistence, caching, or user preferences in Fitness Tracker App.

React Native Storage Manager

This skill provides established patterns for data persistence using MMKV and Expo SecureStore in the Fitness Tracker App.

When to Use This Skill

Use this skill when you need to:

  • Persist data locally on the device
  • Implement encrypted storage for sensitive data
  • Handle user preferences or application state persistence
  • Manage MMKV storage instances and keys
  • Perform common CRUD operations on local storage

Storage Initialization

The app uses an encrypted MMKV instance initialized in app/utils/storage/index.ts.

Secure Encryption Key

We use Expo SecureStore to persist the encryption key securely.

import * as SecureStore from "expo-secure-store"
import { MMKV } from "react-native-mmkv"

export const storage = new MMKV({
  id: "purrsuit-storage",
  encryptionKey: SecureStore.getItem("mmkv-encryption-key"),
})

Basic CRUD Operations

Use the provided helper functions from @/utils/storage.

Saving Data

import { save, saveString } from "@/utils/storage"

save("user_preferences", { theme: "dark", notifications: true })
saveString("auth_token", "secure-token-here")

Loading Data

import { load, loadString } from "@/utils/storage"

const prefs = load<{ theme: string }>("user_preferences")
const token = loadString("auth_token")

Removing Data

import { remove, clear } from "@/utils/storage"

remove("auth_token")
clear() // Clear all data

Advanced Patterns

Typed Storage Keys

Centralize storage keys to avoid typos and ensure consistency.

// app/utils/storage/keys.ts
export const STORAGE_KEYS = {
  USER_PREFS: "user_preferences",
  AUTH_TOKEN: "auth_token",
  ENCOUNTERS_CACHE: "workouts_cache",
} as const

Integration with MST

Stores can automatically persist their state using onSnapshot or by loading data during afterCreate.

References

See STORAGE_PATTERNS.md for detailed implementation examples.

See SECURITY_AND_ENCRYPTION.md for encryption best practices.