Your next Angular Query Builder 🐝

NgQubee is a query builder for Angular. Compose your API requests without re-inventing the wheel.

• Reactive — URIs emitted as RxJS observables, state held in Angular Signals
• Pagination ready — typed PaginatedCollection, fluent navigation (nextPage, lastPage, goToPage)
• Test-driven — 495+ specs
• Multi-driver support: JSON:API, Laravel (pagination-only), Spatie Query Builder, NestJS (nestjs-paginate), PostgREST / Supabase, and Strapi

📚 Documentation

Full documentation lives at ng-qubee.andreatantimonaco.me — driver guides, query-builder API, pagination helpers, auto-generated API reference, and version history.

This README is intentionally minimal. For everything beyond install + a five-line example, head to the docs site.

Requirements

• Angular ≥ 16 (uses Signals)
• RxJS ^6.5.0 || ^7.0.0

Install

npm i ng-qubee

Drivers

A driver must be specified in the configuration:

| Driver | Backend | Wire format snapshot | |---|---|---| | JSON:API | Any JSON:API-compliant backend | filter[field]=value, sort=-field, page[number]=N&page[size]=N | | Laravel | Plain Laravel pagination | limit=N&page=N (pagination only) | | Spatie | Spatie Laravel Query Builder | filter[field]=value, sort=-field | | NestJS | nestjs-paginate | filter.field=$op:value, sortBy=field:DESC | | PostgREST | PostgREST / Supabase | col=eq.value, order=col.asc, limit=N&offset=M | | Strapi | Strapi v4 / v5 headless CMS | filters[field][$eq]=value, sort[0]=field:asc, pagination[page]=N&pagination[pageSize]=N |

Per-driver guides — wire format, supported operators, response parsing, customisation — live on the docs site.

Quick start

import { bootstrapApplication } from '@angular/platform-browser';
import { DriverEnum, NgQubeeService, provideNgQubee, SortEnum } from 'ng-qubee';

bootstrapApplication(AppComponent, {
  providers: [provideNgQubee({ driver: DriverEnum.STRAPI })]
});

// In a component or service:
constructor(private _qb: NgQubeeService) {}

this._qb
  .setResource('articles')
  .addFilter('status', 'published')
  .addSort('createdAt', SortEnum.DESC)
  .setLimit(10)
  .generateUri()
  .subscribe(uri => console.log(uri));
// → /articles?filters[status][$eq]=published&sort[0]=createdAt:desc&pagination[page]=1&pagination[pageSize]=10

The full query-builder API, pagination helpers, per-driver feature matrices, and TypeScript types are documented at ng-qubee.andreatantimonaco.me.

License

MIT © Andrea Tantimonaco