Storage

Mentra Miniapp SDK betaThe SDK is in beta, so its APIs may change before general availability.There is currently no way to distribute a miniapp built with the Miniapp SDK. In a future release, developers will upload miniapps through the Mentra Developer Console, and users will download them from the Mentra Miniapp Store. Neither service supports Miniapp SDK distribution in MentraOS 3.0.Only use the Miniapp SDK if you are comfortable with these limitations.Developing on Mentra Live? We recommend using the Mentra Bluetooth SDK.The developer tools are available in the Mentra App under Settings → Miniapp Developer Settings.Share feedback with an in-app bug report, on Discord, or by email at help@mentra.glass.

session.storage is a phone-local key-value store. It’s scoped to the user and your miniapp, so your keys never collide with another miniapp’s, and the data survives restarts. Keys and values are both strings.

await session.storage.set("lastNote", "buy milk");
const note = await session.storage.get("lastNote"); // "buy milk"

Storage needs no permission and no hardware. Every method is async and round-trips to the phone.

Reading and writing

await session.storage.set("count", "3");
const count = await session.storage.get("count");  // "3", or null if unset
await session.storage.delete("count");
const exists = await session.storage.has("count"); // false

Method	Returns	Notes
`get(key)`	`Promise<string \| null>`	`null` when the key isn’t set.
`set(key, value)`	`Promise<void>`	Overwrites silently.
`delete(key)`	`Promise<void>`	No-op if the key isn’t set.
`has(key)`	`Promise<boolean>`	Whether the key is set.
`keys()`	`Promise<string[]>`	Every key in your namespace.
`clear()`	`Promise<void>`	Drops every key in your namespace.

Bulk operations

For hydrating state on startup or saving several keys at once:

const all = await session.storage.getAll();          // { count: "3", lastNote: "…" }
await session.storage.setMultiple({ a: "1", b: "2" }); // one round-trip

Method	Returns	Notes
`getAll()`	`Promise<Record<string, string>>`	Every key/value pair.
`setMultiple(values)`	`Promise<void>`	Writes many pairs in one round-trip.

Keep the total stored payload small (think under ~1 MB). getAll() pulls everything across the bridge at once, and a large namespace will stall the background context while it resolves. For images, audio, or files, use session.blob instead.

Storing objects

Values are strings, so serialize structured data yourself:

await session.storage.set("notes", JSON.stringify(notes));
const notes = JSON.parse((await session.storage.get("notes")) ?? "[]");

Getting Started

Core Concepts

UI Layer

Display

Audio & Speech

Sensors & Input

Camera

Phone & System

Data

Reference

Reading and writing

Bulk operations

Storing objects

​Reading and writing

​Bulk operations

​Storing objects

Reading and writing

Bulk operations

Storing objects