Introduction

gpui-query is a zero-boilerplate async state management library for GPUI, the framework behind the Zed editor.

What is gpui-query?

gpui-query brings the async state management patterns popularized by libraries like TanStack Query to the GPUI framework. It provides a declarative way to fetch, cache, synchronize, and update server state in your GPUI applications without the boilerplate of manual lifecycle management.

Why gpui-query?

• Zero boilerplate — Define a query, bind it to a view, and let the library handle the rest.
• Automatic caching — Responses are cached and deduplicated out of the box.
• Built-in retry and error handling — Failed requests are retried with configurable policies.
• Observer pattern — Reactively update your UI when data changes.
• Designed for GPUI — First-class integration with GPUI's entity and view system.

Next Steps

• Install gpui-query in your project.
• Follow the Quick Start guide to make your first query.
• Explore the API Reference for detailed documentation.
• Read the Guides for patterns and best practices.