이 페이지는 PageTurner AI로 번역되었습니다(베타). 프로젝트 공식 승인을 받지 않았습니다. 오류를 발견하셨나요? 문제 신고 →
End-to-end typesafe APIs made easy
소개
tRPC는 스키마나 코드 생성 없이 완전한 타입 안정성의 API를 구축하고 사용할 수 있게 해줍니다. tRPC는 REST와 GraphQL의 개념을 결합합니다 - 이들 중 어느 것도 익숙하지 않다면 핵심 개념을 살펴보세요.
풀스택 TypeScript 프로젝트에서 클라이언트와 서버 간 API 계약을 동기화하는 것은 흔한 고통 포인트입니다. tRPC는 코드 생성 단계 없이 TypeScript의 타입 추론을 직접 활용하여 이를 해결하며, 빌드 시점에 문제를 포착합니다.
tRPC는 독립 실행형으로 동작하거나 광범위한 어댑터 생태계를 통해 기존 REST API의 엔드포인트로 마운트될 수 있습니다.
기능
-
✅ 철저히 테스트되어 프로덕션 준비 완료.
-
🧙♂️ 클라이언트 측에서 입력, 출력, 오류에 대한 완전한 정적 타입 안전성과 자동 완성.
-
🐎 빠른 개발 경험 - 코드 생성, 런타임 비대화, 빌드 파이프라인이 필요 없음.
-
🍃 가벼움 - tRPC는 런타임 종속성이 전혀 없으며 클라이언트 측 용량이 매우 작습니다.
-
🐻 신규 및 기존 프로젝트 모두 가능 - 새로 시작하거나 기존 브라운필드 프로젝트에 쉽게 추가 가능.
-
🔋 프레임워크 중립 - tRPC 커뮤니티에서 모든 주요 프레임워크용 어댑터를 구축함.
-
🥃 구독 지원 - 애플리케이션에 타입 안전한 실시간 업데이트를 추가합니다.
-
⚡️ 요청 일괄 처리 - 동시에 발생한 요청을 자동으로 하나로 결합.
-
👀 예제 - 학습용 또는 시작점으로 사용할 수 있는 예제 확인.
간단히 살펴보기
더 많은 내용은 동영상 및 커뮤니티 리소스 페이지에서 확인하세요.
tRPC 사용해 보기
-
최소한의 예제 — Node.js HTTP 서버 + 클라이언트.
-
최소한의 Next.js 예제 — 단일 엔드포인트 + 페이지.
또는 예제 앱을 사용하여 로컬에서 시작하세요.
tRPC 도입하기
새 프로젝트 생성하기
tRPC는 다양한 프레임워크 내부에서 사용될 수 있으므로, 먼저 어디에서 사용할지 결정해야 합니다.
백엔드에서는 다양한 프레임워크 및 바닐라 Node.js용 어댑터가 제공됩니다. 프론트엔드에서는 TanStack React Query 또는 Next.js 통합, 다양한 기타 프레임워크용 서드파티 통합, JavaScript가 실행되는 모든 환경에서 작동하는 바닐라 클라이언트를 사용할 수 있습니다.
스택을 선택한 후에는 템플릿을 사용하여 앱을 구성하거나, 선택한 백엔드 및 프론트엔드 통합에 대한 문서를 참고하여 처음부터 시작할 수 있습니다.
기존 프로젝트에 tRPC 추가하기
기존 프로젝트에 tRPC를 추가하는 것은 새 프로젝트를 시작하는 것과 크게 다르지 않으므로 동일한 자료가 적용됩니다. 주요 어려움은 기존 애플리케이션에 tRPC를 통합하는 방법을 알기 어려울 수 있다는 점입니다. 다음은 몇 가지 팁입니다:
-
기존 백엔드 로직을 모두 tRPC로 포팅할 필요는 없습니다. 일반적인 마이그레이션 전략은 초기에 새로운 엔드포인트에만 tRPC를 사용하고, 기존 엔드포인트는 나중에 tRPC로 마이그레이션하는 것입니다.
-
대규모 코드베이스에서 tRPC가 어떻게 적용되는지 영감을 얻고 싶다면 tRPC를 사용하는 오픈소스 프로젝트에서 사례를 참고할 수 있습니다.
커뮤니티
질문을 하고 경험을 공유하려면 Discord에 참여하세요!