# emulate - 로컬에서 GitHub·Vercel·Google API를 완전 복제해 실행하기

> Clean Markdown view of GeekNews topic #27802. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=27802](https://news.hada.io/topic?id=27802)
- GeekNews Markdown: [https://news.hada.io/topic/27802.md](https://news.hada.io/topic/27802.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2026-03-24T13:39:23+09:00
- Updated: 2026-03-24T13:39:23+09:00
- Original source: [github.com/vercel-labs](https://github.com/vercel-labs/emulate)
- Points: 14
- Comments: 1

## Summary

Vercel이 공개한 **로컬 API 에뮬레이터** `emulate`는 GitHub·Vercel·Google의 주요 REST 엔드포인트를 실제처럼 복제해 로컬에서 실행합니다. 단순 mock이 아니라 **프로덕션과 동일한 상태·응답 구조**를 유지해서, 네트워크 차단 환경이나 CI에서 OAuth·Webhook·통합테스트를 완전히 재현할 수 있습니다. 외부 API 의존 테스트가 느리고 불안정한 건 대부분의 팀이 겪는 문제인데, CLI 한 줄로 여러 서비스를 띄우고 Node API로 테스트 코드 안에서 직접 제어할 수 있어 **실용성이 바로 와닿는 도구**입니다.

## Topic Body

- Vercel에서 만든 CI 또는 네트워크 차단 환경용 **로컬 API 에뮬레이터**  
- 단순 mock이 아니라 실제 프로덕션과 동일한 상태·응답 구조를 가짐  
- `npx emulate` 한 줄로 Vercel(4000), GitHub(4001), Google(4002) 기동  
- CLI로 서비스 선택, 포트 지정, seed 데이터 주입, 설정 생성 가능  
- Node API로 `createEmulator()` 호출해 테스트 코드 내 직접 제어도 가능  
  - Vitest/Jest 환경에서 자동 초기화·리셋·종료 지원  
- `config.yaml` 또는 JSON으로 사용자·팀·프로젝트·OAuth 앱 구성  
- GitHub App, OAuth, Webhook 이벤트까지 실제 동작처럼 재현  
- Vercel·GitHub·Google 주요 REST 엔드포인트 전부 구현  
- 완전 상태 저장형 in-memory Store 구조, CRUD·필터·페이지네이션 내장  
- **로컬 통합테스트·CI 시뮬레이션·OAuth 플로우 검증**용 도구

## Comments



### Comment 54911

- Author: xguru
- Created: 2026-04-08T12:07:55+09:00
- Points: 1

계속 늘어나고 있네요   
  
Vercel on http://localhost:4000  
GitHub on http://localhost:4001  
Google on http://localhost:4002  
Slack on http://localhost:4003  
Apple on http://localhost:4004  
Microsoft on http://localhost:4005  
AWS on http://localhost:4006  
  
https://github.com/vercel-labs/emulate/releases/tag/v0.4.0 에는   
Next.js, MongoDB, Stripe, Resend(이메일), Okta 까지 들어왔습니다.