メインコンテンツへスキップ
バージョン: 11.x

はじめに

tRPCの概要​

tRPCのコンセプトの簡単なビデオ概要については、以下のビデオをご覧ください

tRPCを試してみる​

tRPCを試す最も簡単な方法は、オンラインREPLを使用することです。以下に試せるオプションをいくつか示します

  • 最小限の例 - 最小限のNode.js httpサーバーと、サーバー上の関数を呼び出し、リクエストをコンソールに出力するクライアント。
  • 最小限のNext.jsの例 - tRPCを使用する最小限のNext.jsアプリです。文字列を返す単一のエンドポイントと、そのエンドポイントを呼び出して結果を表示するページがあります。

ローカル環境で開始したい場合は、サンプルアプリをスタータープロジェクトとして使用し、ローカルで試すことができます。

tRPCを使用する​

「tRPCを使用する」ということは、人によって意味合いが異なります。このページの目標は、目標に基づいて適切なリソースを案内することです。

既存のtRPCプロジェクトで生産性を上げる​

新しいプロジェクトを作成する​

tRPCはさまざまなフレームワーク内で利用できるため、最初にどこで使用するかを決める必要があります。

バックエンドには、さまざまなフレームワーク用のアダプターと、バニラのNode.jsがあります。フロントエンドでは、ReactまたはNext.jsインテグレーション、さまざまなフレームワーク用のサードパーティインテグレーション、またはJavaScriptが実行される場所ならどこでも動作するVanillaクライアントを使用できます。

スタックを選択したら、テンプレートを使用してアプリをスキャフォールディングするか、選択したバックエンドおよびフロントエンドインテグレーションのドキュメントを使用して最初から開始できます。

既存のプロジェクトにtRPCを追加する​

既存のプロジェクトにtRPCを追加することは、新しいプロジェクトを開始することと大きくは変わりません。したがって、同じリソースが適用されます。主な課題は、tRPCを既存のアプリケーションと統合する方法がわかりにくいと感じることです。以下にいくつかのヒントを示します

  • 既存のバックエンドロジックをすべてtRPCに移植する必要はありません。一般的な移行戦略は、最初は新しいエンドポイントにのみtRPCを使用し、後で既存のエンドポイントをtRPCに移行することです。
  • どこから始めればよいかわからない場合は、バックエンドアダプターとフロントエンド実装のドキュメント、およびサンプルアプリを確認してください。
  • より大きなコードベースの一部としてtRPCがどのように見えるかのインスピレーションを探している場合は、tRPCを使用しているオープンソースプロジェクトにいくつかの例があります。

コミュニティに参加する​

tRPC Discordに参加して、経験を共有したり、質問したり、コミュニティから助けを得たりしましょう！