Handle Browser Storage Like a Pro with Kando (2KB Magic!)

Managing localStorage and sessionStorage should be simple, lightweight, and powerful not bloated or painful. That's why I built Kando, a tiny (just ~2KB gzipped!) JavaScript library that gives you next-level control over browser storage with support for expiration times, deep nested objects, arrays, and TypeScript types. No more writing repetitive boilerplate or worrying about browser quirks Kando handles it for you! Why Kando? Ultra lightweight: ~2KB gzipped Deep object and array support: access nested keys easily Session expiration: automatic expiry for sessionStorage items Fallback ready: works even if storage is unavailable TypeScript support: fully typed out of the box Zero dependencies: pure and clean JavaScript Open source and easy to extend Installation Node.js: npm install kando-storage Browser: Quick Examples Node.js const kando = require('kando-storage'); // Set a nested value kando('local.user.name', 'John Doe'); // Get a nested value const userName = kando('local.user.name'); console.log(userName); // John Doe // Remove a value kando('local.user.name', null); // Session storage with expiration (in seconds) kando('session.auth.token', 'abcd1234', 3600); // Expires in 1 hour Advanced Examples // Store a namespaced object with arrays kando('local.appConfig', { theme: 'dark', languages: ['en', 'es', 'fr'], settings: { notifications: true, autoSave: false }, }); // Access nested array item const languages = kando('local.appConfig.languages'); // ['en', 'es', 'fr'] // Update a setting within the nested object kando('local.appConfig.settings.notifications', false); // Add a new language to the languages array kando('local.appConfig.languages[3]', 'de'); // ['en', 'es', 'fr', 'de'] Features You’ll Love Deep Access: kando('local.cart.items[0].name', 'Laptop'); Safe Expiration Handling: If a sessionStorage item expires, Kando automatically cleans it up for you. Simple Deletion: kando('local.settings.theme', null); // Deletes the theme TypeScript Friendly: With provided .d.ts, you get full intellisense and stricter types while coding! Why I Built Kando Most storage utilities are either too heavy, too opinionated, or lack expiration support. I wanted something minimal but smart enough for real-world applications, with deep nested paths and auto-cleanups built-in. Thus, Kando was born: a "small but mighty" helper to make storage elegant again. Get Involved GitHub Repository: Kando Star it if you like it contributions and feedback are super welcome! Final Thoughts If you're tired of bloated libraries for simple storage needs give Kando a try. It’s tiny, powerful, and built with developer happiness in mind. Let’s make browser storage simple again!

Apr 28, 2025 - 07:21

Handle Browser Storage Like a Pro with Kando (2KB Magic!)

Managing localStorage and sessionStorage should be simple, lightweight, and powerful not bloated or painful.
That's why I built Kando, a tiny (just ~2KB gzipped!) JavaScript library that gives you next-level control over browser storage with support for expiration times, deep nested objects, arrays, and TypeScript types.

No more writing repetitive boilerplate or worrying about browser quirks Kando handles it for you!

Why Kando?

Ultra lightweight: ~2KB gzipped
Deep object and array support: access nested keys easily
Session expiration: automatic expiry for sessionStorage items
Fallback ready: works even if storage is unavailable
TypeScript support: fully typed out of the box
Zero dependencies: pure and clean JavaScript
Open source and easy to extend

Installation

Node.js:

npm install kando-storage

Browser:

Quick Examples

Node.js

const kando = require('kando-storage');

// Set a nested value
kando('local.user.name', 'John Doe');

// Get a nested value
const userName = kando('local.user.name');
console.log(userName); // John Doe

// Remove a value
kando('local.user.name', null);

// Session storage with expiration (in seconds)
kando('session.auth.token', 'abcd1234', 3600); // Expires in 1 hour

Advanced Examples

// Store a namespaced object with arrays
kando('local.appConfig', {
  theme: 'dark',
  languages: ['en', 'es', 'fr'],
  settings: { notifications: true, autoSave: false },
});

// Access nested array item
const languages = kando('local.appConfig.languages'); // ['en', 'es', 'fr']

// Update a setting within the nested object
kando('local.appConfig.settings.notifications', false);

// Add a new language to the languages array
kando('local.appConfig.languages[3]', 'de'); // ['en', 'es', 'fr', 'de']

Features You’ll Love

Deep Access:

kando('local.cart.items[0].name', 'Laptop');

Safe Expiration Handling: If a sessionStorage item expires, Kando automatically cleans it up for you.
Simple Deletion:

kando('local.settings.theme', null); // Deletes the theme

TypeScript Friendly: With provided .d.ts, you get full intellisense and stricter types while coding!

Why I Built Kando

Most storage utilities are either too heavy, too opinionated, or lack expiration support.
I wanted something minimal but smart enough for real-world applications, with deep nested paths and auto-cleanups built-in.

Thus, Kando was born: a "small but mighty" helper to make storage elegant again.