Figbird

A data fetching library for React + Feathers applications. Used in production at Humaans.

Figbird gives you React hooks that fetch data and keep it updated. When a record changes - from this component, another component, or a realtime event from the server - every query referencing that data re-renders with the new state. No cache invalidation, no manual refetching.

Install

``sh
pnpm add figbird
`

Usage

`ts
import { Figbird, FeathersAdapter, FigbirdProvider, createHooks } from 'figbird'

const figbird = new Figbird({
adapter: new FeathersAdapter(feathersClient),
})

export const { useFind, useGet, useMutation } = createHooks(figbird)

function App() {
return (



)
}

function Notes() {
const { data } = useFind('notes')
const { patch } = useMutation('notes')

return data?.map(note => (



))
}
`

Features

- Live queries - results update as records are created, modified, or removed
- Shared cache - same data across components, always consistent
- Realtime built-in - Feathers websocket events update your UI automatically
- Fetch policies - swr, cache-first, or network-only` per query
- Full TypeScript - define a schema once, get inference everywhere

Documentation

Visit humaans.github.io/figbird for full documentation and API reference.