Skip to main content
current (v21)

Introduction

@ng-catbee/jwt – Angular JWT Decoder & Manager

A modern, type-safe Angular library for decoding, validating, and managing JSON Web Tokens (JWT) in client-side applications — fully compatible with Server-Side Rendering (SSR) and offering comprehensive token utilities including expiration tracking, claim extraction, and reactive observables.

Build StatusCodeQLCoverageNPM VersionNPM DownloadsMaintenanceQuality Gate StatusSecurity RatingMaintainability RatingLicense

📦 Demo

Stackblitz

✨ Features

  • 🔓 Token Decoding - Decode JWT headers and payloads with TypeScript support
  • Expiration Management - Check expiration, get remaining time, watch in real-time
  • 🎯 Type-Safe Claims - Extract specific claims with generic type support
  • Format Validation - Validate JWT format before decoding
  • 🔄 Reactive Observables - Watch token expiration with RxJS
  • 🌐 SSR Compatible - Works seamlessly with server-side rendering
  • 🚀 Zero Dependencies - Lightweight (except Angular and RxJS)

⚠️ Security Notice

warning

This library decodes JWTs but does NOT verify signatures. Always verify JWT signatures on your backend server. Client-side decoding should only be used for reading non-sensitive metadata and UI logic.

🧩 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)