Skip to main content
current (v21)

Introduction

@ng-catbee/storage – Angular Web Storage Wrapper

A modern, type-safe Angular library for simplified interaction with web storage APIs (localStorage and sessionStorage) — fully compatible with Server-Side Rendering (SSR) and offering advanced features like JSON storage, boolean/number parsing, enum validation, reactive observables, and configurable encoding strategies.

Build StatusCodeQLCoverageNPM VersionNPM DownloadsMaintenanceQuality Gate StatusSecurity RatingMaintainability RatingLicense

📦 Demo

Stackblitz

✨ Features

  • 🔒 Type-Safe - Full TypeScript support with generics
  • 📦 Dual Storage - Separate services for localStorage and sessionStorage
  • 🎯 Advanced Getters - Built-in support for JSON, arrays, booleans, numbers, and enums
  • 🔄 Reactive - Observable-based change detection with RxJS
  • 🌐 SSR Compatible - Gracefully handles server-side rendering
  • 🎨 Configurable Encoding - Base64, custom, or no encoding
  • Bulk Operations - Get/set multiple items at once
  • 📦 Zero Dependencies - Lightweight with no external dependencies

🧩 Angular Compatibility

Angular VersionSupported
v17 and above✅ Fully supported

This library is built and tested with Angular 20.x, and supports all modern standalone-based Angular projects (v17+).

📜 License

MIT © Catbee Technologies (see the LICENSE file for the full text)