fnzr / urql

The highly customizable and versatile GraphQL client with which you add on features like normalized caching as you grow.

A highly customisable and versatile GraphQL client

✨ Features

• 📦 One package to get a working GraphQL client in React, Preact, Vue, and Svelte
• ⚙️ Fully customisable behaviour via "exchanges"
• 🗂 Logical but simple default behaviour and document caching
• 🌱 Normalized caching via @urql/exchange-graphcache
• 🔬 Easy debugging with the urql devtools browser extensions

urql is a GraphQL client that exposes a set of helpers for several frameworks. It's built to be highly customisable and versatile so you can take it from getting started with your first GraphQL project all the way to building complex apps and experimenting with GraphQL clients.

📃 For more information, check out the docs.

🙌 Contributing

The urql project was founded by Formidable and is actively developed by the urql GraphQL team.

If you'd like to get involved, check out our Contributor's guide.

📃 Documentation

The documentation contains everything you need to know about urql, and contains several sections in order of importance when you first get started:

• Basics — contains the "Getting Started" guide and all you need to know when first using urql.
• Architecture — explains how urql functions and is built.
• Advanced — covers more uncommon use-cases and things you don't immediately need when getting started.
• Graphcache — documents "Normalized Caching" support which enables more complex apps and use-cases.
• API — the API documentation for each individual package.

You can find the raw markdown files inside this repository's docs folder.