+1
-1
.github/ISSUE_TEMPLATE/bug_report.yaml
+1
-1
.github/ISSUE_TEMPLATE/bug_report.yaml
···-description: Please provide a link via [codesandbox](https://codesandbox.io/s/urql-issue-template-client-iui0o) or a link to a repo that can reproduce the problem you ran into. A [minimal reproduction](https://stackoverflow.com/help/minimal-reproducible-example) is required. If a report is vague (e.g. just a generic error message) and if no reproduction is provided the issue will be auto-closed.+description: Please provide a link to a reproduction. Templates can be found in the [examples folder](https://github.com/urql-graphql/urql/tree/main/examples). A [minimal reproduction](https://stackoverflow.com/help/minimal-reproducible-example) is required. If a report is vague (e.g. just a generic error message) and if no reproduction is provided the issue will be auto-closed.
+7
CONTRIBUTING.md
+7
CONTRIBUTING.md
···instead.** Following this makes it very clear whether it's a known behavior, an unexpected issue,+We do ask that issues _aren’t_ created for questions, or where a bug is likely to be either caused+by misusage or misconfiguration. In short, if you can’t provide a reproduction of the issue, then+If you need a template for creating a reproduction, all of our examples can be opened in isolated
+2
docs/advanced/authentication.md
+2
docs/advanced/authentication.md
···The purpose of the [`authExchange`](../api/auth-exchange.md) is to provide a flexible API that facilitates the typical+> **Note:** [You can find a code example for `@urql/exchange-auth` in an example in the `urql` repository.](https://github.com/urql-graphql/urql/tree/main/examples/with-refresh-auth)
+4
docs/advanced/persistence-and-uploads.md
+4
docs/advanced/persistence-and-uploads.md
···+> **Note:** [You can find a code example for `@urql/exchange-persisted` in an example in the `urql` repository.](https://github.com/urql-graphql/urql/tree/main/examples/with-apq)···> **Note:** Previously, this worked by installing the `@urql/multipart-fetch-exchange` package.> however, this package has been deprecated and file uploads are now built into `@urql/core@4`.+[You can find a code example for file uploads in an example in the `urql` repository.](https://github.com/urql-graphql/urql/tree/main/examples/with-multipart)
+2
docs/advanced/retry-operations.md
+2
docs/advanced/retry-operations.md
···+> **Note:** [You can find a code example for `@urql/exchange-retry` in an example in the `urql` repository.](https://github.com/urql-graphql/urql/tree/main/examples/with-retry)
+25
-2
docs/advanced/subscriptions.md
+25
-2
docs/advanced/subscriptions.md
···For backends supporting `graphql-ws`, we recommend using the [graphql-ws](https://github.com/enisdenjo/graphql-ws) client.···[Read more on the `graphql-ws` README.](https://github.com/enisdenjo/graphql-ws/blob/master/README.md)···[Read more about `subscription-transport-ws` on its README.](https://github.com/apollographql/subscriptions-transport-ws/blob/master/README.md)+`fetchExchange` will be used to send subscriptions to the API. If your API supports this transport,+[You can find a code example of subscriptions via `fetch` in an example in the `urql` repository.](https://github.com/urql-graphql/urql/tree/main/examples/with-subscriptions-via-fetch)
+366
-17
examples/README.md
+366
-17
examples/README.md
···-| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |-| [`with-react-native`](./with-react-native) | Shows a basic query in `urql` with React Native. |-| [`with-next`](./with-next) | Shows some examples with `next-urql` in Next.js with the default, `getStaticProps` and `getServerSideProps`. |-| [`with-pagination`](./with-pagination) | Shows how to generically set up pagination with `urql` in UI code. |-| [`with-infinite-pagination`](./with-infinite-pagination) | Shows how to generically set up infinite scrolling pagination with `urql` in UI code. |-| [`with-apq`](./with-apq) | Shows Automatic Persisted Queries with `@urql/exchange-persisted-fetch`. |-| [`with-graphcache-updates`](./with-graphcache-updates) | Shows manual cache updates with `@urql/exchange-graphcache`. |-| [`with-graphcache-pagination`](./with-graphcache-pagination) | Shows the automatic infinite pagination helpers from `@urql/exchange-graphcache`. |-| [`with-multipart`](./with-multipart) | Shows file upload support with `@urql/exchange-multipart-fetch`. |-| [`with-refresh-auth`](./with-refresh-auth) | Shows an example of authentication with refresh tokens using `@urql/exchange-auth`. |-| [`with-retry`](./with-retry) | Shows how to set up `@urql/exchange-retry` for retrying failed operations. |-| [`with-defer-stream-directives`](./with-defer-stream-directives) | Demonstrates `urql` and `@urql/exchange-graphcache` with built-in support for `@defer` and `@stream`. |-| [`with-subscriptions-via-fetch`](./with-subscriptions-via-fetch) | Demonstrates `urql` executing subscriptions with a GraphQL Yoga API via the `fetchExchange`. |+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-react">+<a href="https://stackblitz.com/github/urql-graphql/urql/tree/main/examples/with-react-native">+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-react-native">+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-svelte">+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-vue3">+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-next">+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-pagination">+Shows how to generically set up infinite scrolling pagination with <code>urql</code> in UI code.+<a href="https://stackblitz.com/github/urql-graphql/urql/tree/main/examples/with-infinite-pagination">+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-infinite-pagination">+<a href="https://stackblitz.com/github/urql-graphql/urql/tree/main/examples/with-graphcache-updates">+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-graphcache-updates">+href="https://stackblitz.com/github/urql-graphql/urql/tree/main/examples/with-graphcache-pagination">+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-graphcache-pagination">+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-multipart">+<a href="https://stackblitz.com/github/urql-graphql/urql/tree/main/examples/with-refresh-auth">+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-refresh-auth">+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-retry">+<a href="./with-defer-stream-directives"><strong>with-defer-stream-directives</strong></a><br />+Demonstrates <code>urql</code> and <code>@urql/exchange-graphcache</code> with built-in support for <code>@defer</code> and <code>@stream</code>.+href="https://stackblitz.com/github/urql-graphql/urql/tree/main/examples/with-defer-stream-directives">+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-defer-stream-directives">+<a href="./with-subscriptions-via-fetch"><strong>with-subscriptions-via-fetch</strong></a><br />+Demonstrates <code>@urql/core</code>'s built-in support for executing subscriptions with a GraphQL Yoga API via the <code>fetchExchange</code>.+href="https://stackblitz.com/github/urql-graphql/urql/tree/main/examples/with-subscriptions-via-fetch">+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-subscriptions-via-fetch">
+15
examples/with-apq/README.md
+15
examples/with-apq/README.md
···+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-apq">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"This example shows `urql` in use with `@urql/exchange-persisted-fetch`'s `persistedFetchExchange`
+1
-1
examples/with-apq/package.json
+1
-1
examples/with-apq/package.json
+16
examples/with-defer-stream-directives/README.md
+16
examples/with-defer-stream-directives/README.md
···+<a href="https://stackblitz.com/github/urql-graphql/urql/tree/main/examples/with-defer-stream-directives">+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-defer-stream-directives">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"directives](https://graphql.org/blog/2020-12-08-improving-latency-with-defer-and-stream-directives)
+17
examples/with-graphcache-pagination/README.md
+17
examples/with-graphcache-pagination/README.md
···+href="https://stackblitz.com/github/urql-graphql/urql/tree/main/examples/with-graphcache-pagination">+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-graphcache-pagination">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"This example shows `urql` in use with `@urql/exchange-graphcache`'s infinite pagination helpers to
+17
examples/with-graphcache-updates/README.md
+17
examples/with-graphcache-updates/README.md
···+href="https://stackblitz.com/github/urql-graphql/urql/tree/main/examples/with-graphcache-updates">+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-graphcache-updates">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"This example shows `urql` in use with `@urql/exchange-graphcache` and demonstrates a manual cacheupdate, as explained in [the "Cache Updates" docs page](https://formidable.com/open-source/urql/docs/graphcache/cache-updates/).
+17
examples/with-infinite-pagination/README.md
+17
examples/with-infinite-pagination/README.md
···+href="https://stackblitz.com/github/urql-graphql/urql/tree/main/examples/with-infinite-pagination">+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-infinite-pagination">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"
+16
examples/with-multipart/README.md
+16
examples/with-multipart/README.md
···+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-multipart">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"This example shows `urql` in use with `@urql/exchange-multipart-fetch`'s `multipartFetchExchange`
+15
examples/with-next/README.md
+15
examples/with-next/README.md
···+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-next">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"This example shows `next-urql` and `urql` in use with Next.js as explained [in the "Next.js" section
+16
examples/with-pagination/README.md
+16
examples/with-pagination/README.md
···+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-pagination">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"
+16
examples/with-react-native/README.md
+16
examples/with-react-native/README.md
···+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-react-native">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"
+15
examples/with-react/README.md
+15
examples/with-react/README.md
···+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-react">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"This example shows `urql` in use with React, as explained on the ["React/Preact" page of the "Basics"
+16
examples/with-refresh-auth/README.md
+16
examples/with-refresh-auth/README.md
···+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-refresh-auth">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"to support authentication token and refresh token logic. This largely follows the ["Authentication" docs
+15
examples/with-retry/README.md
+15
examples/with-retry/README.md
···+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-retry">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"
+17
examples/with-subscriptions-via-fetch/README.md
+17
examples/with-subscriptions-via-fetch/README.md
···+href="https://stackblitz.com/github/urql-graphql/urql/tree/main/examples/with-subscriptions-via-fetch">+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-subscriptions-via-fetch">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"
+15
examples/with-svelte/README.md
+15
examples/with-svelte/README.md
···+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-svelte">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"This example shows `@urql/svelte` in use with Svelte, as explained on the ["Svelte" page of the "Basics"
+15
examples/with-vue3/README.md
+15
examples/with-vue3/README.md
···+src="https://img.shields.io/badge/open_in_stackblitz-1269D3?logo=stackblitz&style=for-the-badge"+<a href="https://codesandbox.io/p/sandbox/github/urql-graphql/urql/tree/main/examples/with-vue3">+src="https://img.shields.io/badge/open_in_codesandbox-151515?logo=codesandbox&style=for-the-badge"This example shows `@urql/vue` in use with Vue 3, as explained on the ["Vue" page of the "Basics"