urql is a highly customizable GraphQL client written in TypeScript that provides framework-agnostic helpers for building GraphQL-powered applications. The project is designed to scale from simple getting-started scenarios to complex applications, with a philosophy of starting with sensible defaults while allowing developers to customize behavior as their needs grow. The client supports multiple modern UI frameworks including React, Preact, Vue, Solid, and Svelte through a single package distribution.
The core architecture of urql centers on an "exchanges" system that enables full customization of client behavior. This exchange-based approach allows developers to compose and extend functionality modularly rather than being locked into a fixed feature set. The client ships with logical but simple default behavior including document caching out of the box. For applications requiring more sophisticated data management, urql offers normalized caching through the separate @urql/exchange-graphcache package, which enables handling of complex application state and cache management patterns.
The repository maintains connections with major open-source projects including Microsoft's VSCode and TypeScript repositories as well as the Rust language project through overlapping contributor networks.
The feature set includes built-in devtools browser extensions for debugging GraphQL operations, making development and troubleshooting more accessible. The project is actively maintained by the urql GraphQL team, originally founded by Formidable, and receives sponsorship from companies including BigCommerce, WunderGraph, The Guild, and BeatGig. The repository uses a changesets-based release process that allows for independent versioning of multiple packages within the monorepo structure. Documentation is comprehensive and organized into sections covering basics, architecture, advanced use cases, normalized caching specifics, and detailed API references, with all APIs additionally documented through TypeScript JSDoc comments for inline editor support.
