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 — 550+ specs
- Multi-driver support: Django REST Framework, JSON:API, Laravel (pagination-only), Spatie Query Builder, NestJS (
nestjs-paginate), PostgREST / Supabase, and Strapi
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.
- Angular ≥ 16 (uses Signals)
- RxJS ^6.5.0 || ^7.0.0
npm i ng-qubeeA driver must be specified in the configuration:
| Driver | Backend | Wire format snapshot |
|---|---|---|
| DRF | Django REST Framework + django-filter | field=value, field__gte=N, ordering=-field, page=N&page_size=M |
| 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.
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]=10The full query-builder API, pagination helpers, per-driver feature matrices, and TypeScript types are documented at ng-qubee.andreatantimonaco.me.
MIT © Andrea Tantimonaco