Question 1

How to sync data with iCloud Keychain using capacitor-secure-storage?

Accepted Answer

Enable iCloud Keychain sync globally by calling setSynchronize() or override it per operation with the sync option. Ensure the user has iCloud Keychain enabled on their iOS device for synchronization to work effectively, as detailed in the README.

Question 2

What data types can I store with capacitor-secure-storage?

Accepted Answer

You can store any JSON-parseable data: strings, numbers, booleans, arrays, objects, null, and dates if formatted as ISO 8601 strings (e.g., 2020-08-27). This flexibility supports complex data structures for secure storage in mobile apps.

Question 3

capacitor-secure-storage vs @capacitor/storage – which is better for secure data?

Accepted Answer

capacitor-secure-storage uses native encryption (iOS Keychain, Android Keystore) for high security, ideal for sensitive data like credentials. @capacitor/storage may use less secure methods, so for non-critical data, it could be simpler, but for security, capacitor-secure-storage is superior.

Question 4

Is capacitor-secure-storage secure on Android?

Accepted Answer

Yes, on Android, data is encrypted with AES in GCM mode using a secret key from Android KeyStore, then stored in app-specific SharedPreferences, ensuring robust security that deletes with the app, as explained in the documentation.

Question 5

How to debug storage on web with capacitor-secure-storage?

Accepted Answer

On the web, data is stored unencrypted in localStorage, so you can inspect it using browser developer tools. This is intended for debugging only; the README warns against using it in production due to lack of encryption.

Question 6

Does capacitor-secure-storage work with Capacitor 7 or earlier?

Accepted Answer

No, it is specifically designed for Capacitor 8, and breaking changes are mentioned, so it's not backward compatible. You'd need to migrate or use alternative plugins for older Capacitor versions.

Question 7

Why does the demo require pnpm and building the plugin first?

Accepted Answer

The demo setup mandates pnpm for dependency management and requires building the plugin locally, which adds complexity. This is because the demos reference a local build, unlike more straightforward plug-and-play examples in other projects.

Secure Storage

What is Secure Storage?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions