1인 앱 개발을 위한 React Native + Expo 베이스 템플릿 — FSD 구조와 AI Agent Harness로 완성하는 생산 라인

1인 앱 개발을 위한 React Native + Expo 베이스 템플릿

도입: 1인 앱 개발의 현실적 허들

혼자 앱을 만든다는 건 매번 같은 보일러플레이트를 다시 짜는 일이다. 인증, API 클라이언트, 상태 관리, 광고 동의, 분석, 인앱 리뷰 정책, 빌드 설정까지 — 새 프로젝트를 만들 때마다 반복되는 작업이 너무 많다. 더 큰 문제는 AI 에이전트가 코드를 아무 데나 생성해 일관성이 무너지는 현상이다. 이런 피로를 줄이기 위해 seungmanchoi/react-native-fsd-agent-template은 React Native + Expo 기반 1인 개발자용 베이스 템플릿으로 등장했다. 바이브 코딩으로 앱 하나를 만들어보는 실험과는 결이 다르다. 한 사람이 여러 앱을 반복적으로 출시할 수 있는 생산 라인에 가깝다.

핵심 1: 스택과 구조

이 템플릿의 근간은 React Native 0.81 + Expo 54다. TypeScript strict mode 위에서 동작한다. 라우팅은 Expo Router로 잡았고, 상태 관리는 Zustand, 서버 상태는 TanStack Query다. HTTP는 Axios, 스타일은 NativeWind로 구성해 네이티브스럽고 일관된 UI를 빠르게 만들 수 있다. 폴더 구조는 FSD(Feature-Sliced Design)를 따른다. features, entities, shared 레이어로 나뉜다. 모듈 경계가 명확하다. AI 에이전트가 어디에 무엇을 넣을지 헷갈리지 않게 미리 가드를 친 셈이다. 단순한 스타터 키트와 가장 다른 지점이다.

핵심 2: AI Agent Harness가 함께 들어 있다

결정적 차이는 Claude Code용 agent 9개와 skill 8개가 템플릿 안에 포함된다는 점이다. 사용자는 "Make an app" 같은 명령 하나만 던지면 된다. 아이디어 → 기획 → 설계 → 구현 → QA 흐름이 자동화된다. 구현 후에는 qa-reviewer와 app-inspector가 코드를 점검한다. 점검 항목에는 코드 품질, UX, Safe Area, 접근성이 포함된다. 사람은 아이디어와 디테일에 집중할 수 있다. AI가 코드를 아무 데나 흩뿌리지 않는다. FSD 규칙과 작업 단계, typecheck/lint 기준이 모두 템플릿 안에 함께 박혀 있기 때문이다.

핵심 3: 수익화와 배포까지 한 번에

광고와 분석 모듈이 이미 세팅돼 있다는 점이 인상적이다. AdMob이 광고를 담당하고, Firebase Analytics가 이벤트를 수집한다. SecureStore가 토큰을 안전하게 보관한다. 인앱 리뷰 정책 모듈도 포함된다. 1인 개발자는 MVP 단계에서 바로 수익 모델을 가늠해볼 수 있다. 배포 흐름도 마찬가지다. EAS Build / Submit 기준으로 정리돼 있어 iOS, Android 양쪽으로 바로 출하할 수 있다. 광고 ID, 번들 ID, 키스토어만 갈아끼우면 된다.

실용 팁: 템플릿을 그대로 쓰는 법

새 프로젝트를 시작할 때마다 FSD 레이어 규칙을 먼저 학습시켜라. Claude Code의 skill 8개는 작업 단계, typecheck/lint 기준, QA 기준을 함께 가지고 있다. 처음 한두 번은 사람이 직접 흐름을 따라가는 편이 낫다. AdMob, Firebase 같은 모듈은 환경변수만 갈아끼우면 된다. 아이디어 검증을 빠르게 돌리는 용도로 활용할 수 있다. 단, 광고 SDK 키와 번들 ID는 프로젝트마다 다르다. 설정 파일을 그대로 복사한 뒤 환경변수만 바꾸는 습관을 들여라. 작은 습관 하나가 첫 빌드 실패를 막아준다. 작업 단계를 한 번만 따라가도 다음부터는 AI에게 맡길 수 있다.

마무리: 1인 개발자에게 템플릿이 갖는 의미

이 프로젝트는 단순한 스타터가 아니다. "1인 개발자 생산 라인"이다. 반복되는 보일러플레이트를 줄이고, AI 에이전트의 출력을 모듈 경계 안에 가둬 코드 일관성을 유지한다. 다음 앱을 만들 때 인증 구조부터 다시 짜야 하는 피로는 이제 그만이다. 새 앱을 한 번에 여러 개 굴리는 1인 개발자라면 한번 꼭 살펴볼 만한 템플릿이다.