Skip to main content

cordova-plugin-nativestorage Alternative for Capacitor

cordova-plugin-nativestorage alternative for Capacitor: persistent key-value storage with @capgo/capacitor-data-storage-sqlite and optional encryption.

Illustration of migrating a Cordova app to Capacitor, used for a native storage plugin guide

The practical cordova-plugin-nativestorage alternative for a Capacitor app is @capgo/capacitor-data-storage-sqlite. It keeps the same small key/value persistence model as NativeStorage but stores strings in SQLite with optional encryption and multi table stores in definitions.ts. This guide covers npm facts, install steps, usage, and an API map for your Cordova to Capacitor move.

Why leave cordova-plugin-nativestorage in Capacitor

cordova-plugin-nativestorage on npm is version 2.3.2. The registry modified timestamp is 14 June 2022. The source lives at TheCocoaProject/cordova-plugin-nativestorage. The README explains it exists because iOS and Android can evict WebView localStorage, and documents:

  • NativeStorage.setItem(reference, object, success, error)
  • getItem, remove, clear, and keys (v2 API through StorageHandle in www)
  • initWithSuiteName for iOS app groups
  • JSON serializable objects stored as native key/value pairs

In a Capacitor codebase the Cordova plugin still means callback style APIs and no typed store management.

@capgo/capacitor-data-storage-sqlite latest on npm is 8.0.64 with a modified date of 13 November 2026. src/definitions.ts documents openStore(), set(), get(), remove(), clear(), keys(), keysvalues(), setTable(), importFromJson(), and exportToJson(). Capgo ships fixes on an open source cadence where a human still reviews, tests and merges 50+ pull requests daily.

Install

bun add @capgo/capacitor-data-storage-sqlite
bunx cap sync

Call openStore() once at startup with database and table names from the docs before other methods.

Usage example

import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

export async function persistSession(token: string) {
  await CapgoCapacitorDataStorageSqlite.openStore({
    database: 'session',
    table: 'kv',
  });
  await CapgoCapacitorDataStorageSqlite.set({ key: 'authToken', value: token });
  const { value } = await CapgoCapacitorDataStorageSqlite.get({ key: 'authToken' });
  return value;
}

Migrating from Cordova to Capacitor

// Before (Cordova)
NativeStorage.setItem('user', { id: 1, name: 'Ada' }, () => {}, console.error);
NativeStorage.getItem('user', (obj) => console.log(obj), console.error);
// After (Capacitor)
import { CapgoCapacitorDataStorageSqlite } from '@capgo/capacitor-data-storage-sqlite';

await CapgoCapacitorDataStorageSqlite.openStore({ database: 'app', table: 'kv' });
await CapgoCapacitorDataStorageSqlite.set({
  key: 'user',
  value: JSON.stringify({ id: 1, name: 'Ada' }),
});
const { value } = await CapgoCapacitorDataStorageSqlite.get({ key: 'user' });
console.log(JSON.parse(value));

API mapping table

cordova-plugin-nativestorage (NativeStorage) @capgo/capacitor-data-storage-sqlite
setItem(reference, object, success, error) set({ key, value }) with string values
getItem(reference, success, error) get({ key }) returns capValueResult
remove(reference, success, error) remove({ key })
clear(success, error) clear()
keys(success, error) keys() returns capKeysResult
initWithSuiteName(suiteName, ...) openStore() options for database and table per docs
Object values stored natively Serialize objects with JSON.stringify()
Callback errors Promise rejection
Cordova plugin install bun add @capgo/capacitor-data-storage-sqlite plus bunx cap sync

Storage still lives in the app sandbox. After you add the plugin, ship a store build via Capgo Build. For the full platform move, read the Cordova to Capacitor migration guide.

Live updates for Capacitor apps

When a web-layer bug is live, ship the fix through Capgo instead of waiting days for app store approval. Users get the update in the background while native changes stay in the normal review path.

Latest from our Blog

Capgo gives you the best insights you need to create a truly professional mobile app.