Summary  
How to implement persistent key-value storage for primitive data types using SharedPreferences, including acquiring an instance asynchronously, saving values, retrieving them safely, and removing or clearing stored entries.

General domain of usage  
User preferences and settings

**SharedPreferences** provides a lightweight way to store simple key-value pairs locally in Flutter apps. It is ideal for saving user preferences, flags, or other small pieces of data that need to persist between app launches but do not require the complexity of a full database.

Definition

**Video: Introduction to SharedPreferences for Local Storage in Flutter**

This video introduces you to using SharedPreferences in Flutter, demonstrating how you can store and retrieve simple key-value data locally on the device with minimal setup. You'll see how SharedPreferences fits into the overall state and data handling landscape, and why it's a common choice for lightweight persistence needs.

Unlike more complex storage solutions, SharedPreferences is synchronous and easy to use, making it a go-to option for persisting primitive data types.

Ly8gbWFpbi5kYXJ0CmltcG9ydCAncGFja2FnZTpmbHV0dGVyL21hdGVyaWFsLmRhcnQnOwppbXBvcnQgJ3BhY2thZ2U6c2hhcmVkX3ByZWZlcmVuY2VzL3NoYXJlZF9wcmVmZXJlbmNlcy5kYXJ0JzsKCnZvaWQgbWFpbigpIHsKICBydW5BcHAoY29uc3QgTXlBcHAoKSk7Cn0KCmNsYXNzIE15QXBwIGV4dGVuZHMgU3RhdGVsZXNzV2lkZ2V0IHsKICBjb25zdCBNeUFwcCh7c3VwZXIua2V5fSk7CiAgQG92ZXJyaWRlCiAgV2lkZ2V0IGJ1aWxkKEJ1aWxkQ29udGV4dCBjb250ZXh0KSB7CiAgICByZXR1cm4gTWF0ZXJpYWxBcHAoCiAgICAgIGhvbWU6IGNvbnN0IFByZWZlcmVuY2VEZW1vKCksCiAgICApOwogIH0KfQoKY2xhc3MgUHJlZmVyZW5jZURlbW8gZXh0ZW5kcyBTdGF0ZWZ1bFdpZGdldCB7CiAgY29uc3QgUHJlZmVyZW5jZURlbW8oe3N1cGVyLmtleX0pOwogIEBvdmVycmlkZQogIFN0YXRlPFByZWZlcmVuY2VEZW1vPiBjcmVhdGVTdGF0ZSgpID0+IF9QcmVmZXJlbmNlRGVtb1N0YXRlKCk7Cn0KCmNsYXNzIF9QcmVmZXJlbmNlRGVtb1N0YXRlIGV4dGVuZHMgU3RhdGU8UHJlZmVyZW5jZURlbW8+IHsKICBmaW5hbCBUZXh0RWRpdGluZ0NvbnRyb2xsZXIgX2NvbnRyb2xsZXIgPSBUZXh0RWRpdGluZ0NvbnRyb2xsZXIoKTsKICBTdHJpbmcgX3NhdmVkVmFsdWUgPSAiIjsKCiAgRnV0dXJlPHZvaWQ+IF9zYXZlVmFsdWUoKSBhc3luYyB7CiAgICBmaW5hbCBwcmVmcyA9IGF3YWl0IFNoYXJlZFByZWZlcmVuY2VzLmdldEluc3RhbmNlKCk7CiAgICBhd2FpdCBwcmVmcy5zZXRTdHJpbmcoJ215S2V5JywgX2NvbnRyb2xsZXIudGV4dCk7CiAgICBzZXRTdGF0ZSgoKSB7CiAgICAgIF9zYXZlZFZhbHVlID0gX2NvbnRyb2xsZXIudGV4dDsKICAgIH0pOwogIH0KCiAgRnV0dXJlPHZvaWQ+IF9sb2FkVmFsdWUoKSBhc3luYyB7CiAgICBmaW5hbCBwcmVmcyA9IGF3YWl0IFNoYXJlZFByZWZlcmVuY2VzLmdldEluc3RhbmNlKCk7CiAgICBzZXRTdGF0ZSgoKSB7CiAgICAgIF9zYXZlZFZhbHVlID0gcHJlZnMuZ2V0U3RyaW5nKCdteUtleScpID8/ICIiOwogICAgfSk7CiAgfQoKICBAb3ZlcnJpZGUKICB2b2lkIGluaXRTdGF0ZSgpIHsKICAgIHN1cGVyLmluaXRTdGF0ZSgpOwogICAgX2xvYWRWYWx1ZSgpOwogIH0KCiAgQG92ZXJyaWRlCiAgV2lkZ2V0IGJ1aWxkKEJ1aWxkQ29udGV4dCBjb250ZXh0KSB7CiAgICByZXR1cm4gU2NhZmZvbGQoCiAgICAgIGFwcEJhcjogQXBwQmFyKHRpdGxlOiBjb25zdCBUZXh0KCdTaGFyZWRQcmVmZXJlbmNlcyBEZW1vJykpLAogICAgICBib2R5OiBQYWRkaW5nKAogICAgICAgIHBhZGRpbmc6IGNvbnN0IEVkZ2VJbnNldHMuYWxsKDE2LjApLAogICAgICAgIGNoaWxkOiBDb2x1bW4oCiAgICAgICAgICBjaGlsZHJlbjogWwogICAgICAgICAgICBUZXh0RmllbGQoCiAgICAgICAgICAgICAgY29udHJvbGxlcjogX2NvbnRyb2xsZXIsCiAgICAgICAgICAgICAgZGVjb3JhdGlvbjogY29uc3QgSW5wdXREZWNvcmF0aW9uKGxhYmVsVGV4dDogJ0VudGVyIGEgdmFsdWUnKSwKICAgICAgICAgICAgKSwKICAgICAgICAgICAgRWxldmF0ZWRCdXR0b24oCiAgICAgICAgICAgICAgb25QcmVzc2VkOiBfc2F2ZVZhbHVlLAogICAgICAgICAgICAgIGNoaWxkOiBjb25zdCBUZXh0KCdTYXZlJyksCiAgICAgICAgICAgICksCiAgICAgICAgICAgIGNvbnN0IFNpemVkQm94KGhlaWdodDogMjApLAogICAgICAgICAgICBUZXh0KCdTYXZlZCB2YWx1ZTogJF9zYXZlZFZhbHVlJyksCiAgICAgICAgICBdLAogICAgICAgICksCiAgICAgICksCiAgICApOwogIH0KfQ==

**SharedPreferences** supports storing primitive types such as `int`, `double`, `bool`, `String`, and `List<String>`. Data saved with **SharedPreferences** persists even after the app is closed or restarted, as shown in the example above. However, it is not suitable for large or complex data structures, and you should use it only for simple, lightweight storage needs.

aW1wb3J0ICdwYWNrYWdlOmZsdXR0ZXIvbWF0ZXJpYWwuZGFydCc7CmltcG9ydCAncGFja2FnZTpzaGFyZWRfcHJlZmVyZW5jZXMvc2hhcmVkX3ByZWZlcmVuY2VzLmRhcnQnOwoKdm9pZCBtYWluKCkgewogIHJ1bkFwcChjb25zdCBNeUFwcCgpKTsKfQoKY2xhc3MgTXlBcHAgZXh0ZW5kcyBTdGF0ZWxlc3NXaWRnZXQgewogIGNvbnN0IE15QXBwKHtzdXBlci5rZXl9KTsKICBAb3ZlcnJpZGUKICBXaWRnZXQgYnVpbGQoQnVpbGRDb250ZXh0IGNvbnRleHQpIHsKICAgIHJldHVybiBNYXRlcmlhbEFwcCgKICAgICAgaG9tZTogY29uc3QgUmVtb3ZlUHJlZmVyZW5jZURlbW8oKSwKICAgICk7CiAgfQp9CgpjbGFzcyBSZW1vdmVQcmVmZXJlbmNlRGVtbyBleHRlbmRzIFN0YXRlZnVsV2lkZ2V0IHsKICBjb25zdCBSZW1vdmVQcmVmZXJlbmNlRGVtbyh7c3VwZXIua2V5fSk7CiAgQG92ZXJyaWRlCiAgU3RhdGU8UmVtb3ZlUHJlZmVyZW5jZURlbW8+IGNyZWF0ZVN0YXRlKCkgPT4gX1JlbW92ZVByZWZlcmVuY2VEZW1vU3RhdGUoKTsKfQoKY2xhc3MgX1JlbW92ZVByZWZlcmVuY2VEZW1vU3RhdGUgZXh0ZW5kcyBTdGF0ZTxSZW1vdmVQcmVmZXJlbmNlRGVtbz4gewogIFN0cmluZyBfc2F2ZWRWYWx1ZSA9ICIiOwoKICBGdXR1cmU8dm9pZD4gX2xvYWRWYWx1ZSgpIGFzeW5jIHsKICAgIGZpbmFsIHByZWZzID0gYXdhaXQgU2hhcmVkUHJlZmVyZW5jZXMuZ2V0SW5zdGFuY2UoKTsKICAgIHNldFN0YXRlKCgpIHsKICAgICAgX3NhdmVkVmFsdWUgPSBwcmVmcy5nZXRTdHJpbmcoJ215S2V5JykgPz8gIiI7CiAgICB9KTsKICB9CgogIEZ1dHVyZTx2b2lkPiBfcmVtb3ZlVmFsdWUoKSBhc3luYyB7CiAgICBmaW5hbCBwcmVmcyA9IGF3YWl0IFNoYXJlZFByZWZlcmVuY2VzLmdldEluc3RhbmNlKCk7CiAgICBhd2FpdCBwcmVmcy5yZW1vdmUoJ215S2V5Jyk7CiAgICBzZXRTdGF0ZSgoKSB7CiAgICAgIF9zYXZlZFZhbHVlID0gIiI7CiAgICB9KTsKICB9CgogIEBvdmVycmlkZQogIHZvaWQgaW5pdFN0YXRlKCkgewogICAgc3VwZXIuaW5pdFN0YXRlKCk7CiAgICBfbG9hZFZhbHVlKCk7CiAgfQoKICBAb3ZlcnJpZGUKICBXaWRnZXQgYnVpbGQoQnVpbGRDb250ZXh0IGNvbnRleHQpIHsKICAgIHJldHVybiBTY2FmZm9sZCgKICAgICAgYXBwQmFyOiBBcHBCYXIodGl0bGU6IGNvbnN0IFRleHQoJ1JlbW92ZSBTaGFyZWRQcmVmZXJlbmNlcyBWYWx1ZScpKSwKICAgICAgYm9keTogUGFkZGluZygKICAgICAgICBwYWRkaW5nOiBjb25zdCBFZGdlSW5zZXRzLmFsbCgxNi4wKSwKICAgICAgICBjaGlsZDogQ29sdW1uKAogICAgICAgICAgY2hpbGRyZW46IFsKICAgICAgICAgICAgVGV4dCgnU2F2ZWQgdmFsdWU6ICRfc2F2ZWRWYWx1ZScpLAogICAgICAgICAgICBFbGV2YXRlZEJ1dHRvbigKICAgICAgICAgICAgICBvblByZXNzZWQ6IF9yZW1vdmVWYWx1ZSwKICAgICAgICAgICAgICBjaGlsZDogY29uc3QgVGV4dCgnUmVtb3ZlIFZhbHVlJyksCiAgICAgICAgICAgICksCiAgICAgICAgICBdLAogICAgICAgICksCiAgICAgICksCiAgICApOwogIH0KfQ==

Which of the following statements best describes the limitations and typical use cases of SharedPreferences in Flutter?

Master state management and data handling in Flutter to build robust, data-driven applications that work seamlessly both online and offline. Explore essential state management techniques, remote data fetching, error handling, and local storage solutions to create resilient Flutter apps.

Explore the core concepts of state management in Flutter, from basic setState to advanced patterns like Provider and Riverpod.

Learn to fetch, parse, and manage remote data in Flutter using REST APIs and JSON serialization.

Persist data locally in Flutter using SharedPreferences, secure storage, and SQLite with Drift.