JSPM

@trpc/react-query

11.0.0-alpha-tmp-02-12-response-types-idea.847+368e673e1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1148762
  • Score
    100M100P100Q191874F
  • License MIT

The tRPC React library

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@trpc/react-query) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    tRPC

    tRPC

    End-to-end typesafe APIs made easy

    Demo

    @trpc/react-query

    A tRPC wrapper around react-query.

    Documentation

    Full documentation for @trpc/react-query can be found here

    Installation

    # npm
    npm install @trpc/react-query@next @tanstack/react-query
    
    # Yarn
    yarn add @trpc/react-query@next @tanstack/react-query
    
    # pnpm
    pnpm add @trpc/react-query@next @tanstack/react-query
    
    # Bun
    bun add @trpc/react-query@next @tanstack/react-query

    Basic Example

    Create a utils file that exports tRPC hooks and providers.

    import { createTRPCReact } from '@trpc/react-query';
    import type { AppRouter } from './server';
    
    export const trpc = createTRPCReact<AppRouter>();

    Use the provider to connect to your API.

    import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
    import { trpc } from '~/utils/trpc';
    import React, { useState } from 'react';
    
    export function App() {
      const [queryClient] = useState(() => new QueryClient());
      const [trpcClient] = useState(() =>
        trpc.createClient({
          url: 'http://localhost:5000/trpc',
        }),
      );
      return (
        <trpc.Provider client={trpcClient} queryClient={queryClient}>
          <QueryClientProvider client={queryClient}>
            {/* Your app here */}
          </QueryClientProvider>
        </trpc.Provider>
      );
    }

    Now in any component, you can query your API using the proxy exported from the utils file.

    import { trpc } from '~/utils/trpc';
    
    export function Hello() {
      const { data, error, status } = trpc.greeting.useQuery({ name: 'tRPC' });
    
      if (error) {
        return <p>{error.message}</p>;
      }
    
      if (status !== 'success') {
        return <p>Loading...</p>;
      }
    
      return <div>{data && <p>{data.greeting}</p>}</div>;
    }