@gaurav_bhandari/common-frontend-services

A comprehensive collection of framework-agnostic frontend services designed for scalability, maintainability, and performance.


License
ISC
Install
npm install @gaurav_bhandari/common-frontend-services@1.0.6

Documentation

Frontend Services Collection

A comprehensive collection of framework-agnostic frontend services designed for scalability, maintainability, and performance.

🚀 Quick Usage (CLI)

This package provides a CLI to easily discover and install services directly into your project.

1️⃣ List Available Services

To see all the services you can install, run:

npx --package @gaurav_bhandari/common-frontend-services frontend-services list

2️⃣ Install a Service

To add a specific service (e.g., logger, api) to your project, run:

npx --package @gaurav_bhandari/common-frontend-services frontend-services add <service-name>

Example:

npx --package @gaurav_bhandari/common-frontend-services frontend-services add logger

📦 Services Overview

This repository contains the following services. Each service directory includes its own docs folder with detailed usage instructions and examples.

Core Foundation

  • API Service: Base API handling wrapper around Axios with interceptors, error handling, and CSRF protection.
  • Environment Config Service: Centralized configuration management for environment variables and runtime settings.
  • Logger Service: structured logging service with support for multiple transports (Console, External).
  • Monitoring Service: Error tracking and performance monitoring (Web Vitals) with backend reporting capabilities.

Application Logic

  • Authorization Service: Role-Based Access Control (RBAC) service for managing user permissions and route guards.
  • Cache Service: Two-layer caching mechanism (Memory + IndexedDB) with LRU eviction policies for performance optimization.
  • Feature Flag Service: Remote feature toggling service with retry logic and caching.
  • Google Login Service: Integration wrapper for Google Identity Services SDK for easy authentication.
  • GraphQL Service: Client for handling GraphQL queries and mutations.
  • i18n Service: Internationalization service for managing translations and locale settings.
  • Validation Service: Pure TypeScript, framework-agnostic form validation logic.
  • Worker Service: Utility for safely executing heavy computations in Web Workers with timeout support.

Data & Storage

  • Date Service: Date manipulation and formatting utilities (wrapper around date-fns) with time zone support.
  • File Service: Robust file handling service including support for chunked uploads and progress tracking.
  • Storage Service: Type-safe wrappers for LocalStorage, SessionStorage, and IndexedDB.

Documentation & Standards

  • Architecture Reports: Checklists and guidelines for maintaining architectural health and standards.
  • Security Reports: Security best practices, checklists (including OWASP Top 10), and audit guides.

📚 Documentation

For detailed implementation details, API references, and usage examples, please refer to the docs folder located within each service's directory.