보일러플레이트가 하는 일

React Native 프로젝트는 항상 같은 20가지 결정으로 시작해요. 네비게이션 라이브러리. 인증. API 레이어. 폴더 구조. iOS 빌드 서명. Android Gradle 설정.

보일러플레이트는 이걸 돌아가는 코드로 결정해줍니다. README가 아니라.

구분이 중요해요. 보일러플레이트는 위에 구축하는 기반이에요. 템플릿은 채워 넣는 UI 목업이고요. 하나는 돌아가는 앱을 줘요. 다른 하나는 예쁘지만 아무것도 안 하는 화면을 줍니다.

셋업에 드는 시간

React Native 프로젝트의 처음 2~4주는 사용자한테 안 보이는 인프라에 가요. 네비게이션, 인증, API, 에러 처리, 환경 설정, 빌드 파이프라인. 다 필요한데 다 안 보여요.

10년 경험 있는데도 새 프로젝트마다 셋업에 몇 주를 날렸어요. 같은 결정. 같은 배선. 이전에 이미 고쳤던 같은 버그.

그래서 앱 코드를 쓰기 전에 첫 주를 기반에 썼어요. 인증. 결제. 푸시 알림. 네비게이션. 필요한 거 다 — 한 번에.

그 다음부터 빨라졌어요. 3주 동안 앱 3개가 앱스토어에 나갔습니다.

좋은 거랑 나쁜 거

대부분의 보일러플레이트는 설치 안내가 달린 폴더 구조예요. 파일이 어디 가는지 알려주지, 문제를 풀어주진 않아요.

좋은 보일러플레이트:

• 바로 실행 — clone, install, start. "47단계 따르기"가 아님
• 인증이 첫날에 돌아감 — TODO 코멘트가 아님
• 배포 포함 — 빌드 스크립트, CI/CD, 스토어 제출 자동화
• 풀스택 — 프론트엔드만 있으면 백엔드는 여전히 백지

나쁜 보일러플레이트는 하루를 아껴요. 좋은 보일러플레이트는 한 달을 아낍니다.

AI 시대에 더 중요해진 이유

2026년에 보일러플레이트는 사람용 스타터 코드가 아니에요. AI 에이전트의 운영 환경입니다.

구조가 잡힌 프로젝트 안에서 AI가 작업하면 — 타입, 패턴, 규칙이 일관된 — 맞는 코드가 나와요. 빈 프로젝트에서 작업하면 추측해요. 추측은 프로덕션에서 깨집니다.

보일러플레이트 없이 바이브 코딩하면 일회용 프로토타입이 나와요. 보일러플레이트 안에서 바이브 코딩하면 출시할 수 있는 앱이 나옵니다.