ngx-oneforall is a collection of 120+ high-quality Angular utilities designed to solve common development challenges. Instead of reinventing the wheel or managing dozens of small dependencies, you get a unified toolkit that just works.

One For All - A single library providing the essential blocks for modern Angular development.

Documentation

Full API documentation and demos are available at: https://love1024.github.io/ngx-oneforall/

Key Features

• Performance First: Every utility is written from scratch and optimized specifically for Angular.
• Tree-Shakable: Import only what you need. Zero bundle bloat—no utility exceeds 3kb gzipped.
• Zero Dependencies: Keeps your dependency tree clean and secure.
• SSR Ready: Built for modern hydration and server-side rendering.
• Modern Angular: Designed for Signals and Standalone Components.
• Fully Tested: Comprehensive test suite with 100% coverage.

Why Use It?

• Stop Re-writing Utilities: Avoid copy-pasting the same services, directives, validators, and helper functions between projects.
• Focus on Business Logic: Don't waste time maintaining generic boilerplate code. Use proven primitives.
• Better Developer Experience: Fully typed APIs and consistent behavior make coding a joy.

Requirements

• Angular: 17.1+ / 18.x / 19.x / 20.x / 21.x
• RxJS: 7.x or 8.x

Installation

npm install ngx-oneforall

Or

yarn add ngx-oneforall

Optional Dependencies

For phone validator, install:

npm install libphonenumber-js

Usage

Simply import what you need. ngx-oneforall is fully tree-shakable.

Example: Using @Cache Decorator

import { Injectable } from '@angular/core';
import { HttpClient } from '@angular/common/http';
import { Observable } from 'rxjs';
import { Cache } from 'ngx-oneforall/decorators/cache';

@Injectable({ providedIn: 'root' })
export class UserService {
  constructor(private http: HttpClient) {}

  // Cache results for 1 minute in localStorage
  @Cache({ ttl: 60000, storage: 'local' })
  getUser(id: number): Observable<User> {
    return this.http.get<User>(`/api/users/${id}`);
  }
}

Available Utilities

| Category | Utilities | |----------|-----------| | Constants | breakpoints, device, file-extension, host-platforms, http, keys, regex, sort-direction, time, types | | Decorators | cache, catch-error, debounce, log-execution-time, memoize, only-in-browser, throttle | | Directives | auto-focus, click-outside, click-throttle, datetime, drag-auto-scroll, draggable, hover-class, infinite-scroll, lowercase, mask, numbers-only, press-enter, repeat, resized, shortcut, typed-template, uppercase, visibility-change | | Guards | param, query-param, unsaved-changes | | Interceptors | base-url, cache, correlation-id, encryption, jwt, performance, timeout | | Pipes | bytes, call, first-error-key, highlight-search, initials, pluralize, range, safe-html, time-ago, truncate | | Rxjs | backoff-retry, catch-error-with-fallback, data-polling, debug, live-search, loading-status | | Services | cache, clipboard, cookie, device, event, history, idle, jwt, logger, network-status, shortcut, storage | | Signals | breakpoint-matcher, debounced-signal, deep-computed, event-signal, interval-signal, route-param-signal, route-query-param-signal, router-event-signal, state-signal, storage-signal, throttled-signal, websocket-signal | | Types | callable, deep-partial, is-arrow-function, keys-of-type, omit-by-value, partial-only, pick-by-value, required-only, simple-changes | | Utils | base64-url, download-link, file-base64, find-type, hash, host-platform, is-key-defined, is-number, is-present, is-record, normalize-key, safe-await, safe-serialize, unique-component-id | | Validators | credit-card, date, match-field, max-date, min-date, min-length-trimmed, not-blank, number, phone, range, range-length, url |

Issues & Feature Requests

Found a bug or edge case? Have an idea for a new utility? We'd love to hear from you!

• Report Issues: If you encounter any bugs or unexpected behavior, please open an issue.
• Feature Requests: Have a utility in mind that would benefit the community? Submit a feature request via GitHub Issues.

Contributing

Contributions are welcome!

1. Create a feature branch.
2. Commit your changes.
3. Make sure tests are passing and coverage is 100%.
4. Make sure build is successful and there are no linting errors.
5. Submit a pull request.

License

MIT License. See LICENSE for details.