자주 묻는 질문

질문에, 답해 드릴게요

사람들이 Indigo에 대해 가장 자주 묻는 것들이에요 — 라이선스, 빌더·보일러플레이트와의 비교, 그리고 그 위에서 만드는 경험.

라이선스 & 비용

무료인가요? 함정은 없나요?

Indigo는 정말 무료인가요?

네. 프레임워크와 거의 모든 모듈은 관대한 Apache-2.0 라이선스로 무료 오픈소스예요. 소스를 공개하지 않는 상업적 제품을 포함해, 비용 없이 만들고, 운영하고, 출시할 수 있어요.

Indigo를 상업적으로 사용할 수 있나요?

물론이에요, 아무런 조건도 없이요. Apache-2.0에는 카피레프트 의무가 없어서, 무료 코어 위에 독점적이고 소스를 공개하지 않는 소프트웨어를 아무것도 사지 않고 만들 수 있어요. 여러분이 만들어낸 코드는 여러분 것이에요.

어떤 모듈이 유료인가요?

딱 세 개예요. core-store(이커머스), core-chat(AI 캐릭터 챗), core-ai-writer(AI 콘텐츠 생성)는 상용 라이선스예요 — 분명하게 수익 제품을 운영하는 버티컬이죠. 나머지는 전부 무료예요.

상용 라이선스는 무엇을 포함하나요?

그 세 개의 프리미엄 모듈만요. 라이선스를 구매하면 그 모듈들을 설치하고 배포할 수 있어요. 그리고 그 비용이 무료 오픈소스 코어의 지속적인 개발 자금이 돼요.

비교하자면

이것도 또 하나의 웹사이트 빌더인가요?

Indigo는 Wix, Lovable, Bolt, v0와 뭐가 다른가요?

그것들은 호스티드 플랫폼이에요 — 앱이 그들의 인프라 위에 살고, 그들의 도구로 만들어지고, 그들의 구독료로 가격이 매겨져요. Indigo는 정반대예요: 여러분의 컴퓨터에, 여러분의 git 저장소에 있는 진짜 오픈소스 Next.js 코드베이스이고, 그 위에서 여러분의 코딩 에이전트가 만들어 나가요. 플랫폼도 없고, 내보낼 것도 없고, 프로토타입이 제품이 되어야 할 때 마주칠 절벽도 없어요.

ShipFast나 create-t3-app과는 뭐가 다른가요?

보일러플레이트는 연결까지 끝난 코드의 스냅샷을 건네줘요 — 글루 코드를 물려받아 영원히 유지보수해야 하고, 에이전트에게는 아무것도 알려주지 않아요. Indigo는 프레임워크예요: 새 기능은 설정과 모듈을 통해 스스로 등록하고, 공유 코어는 절대 수정되지 않고, 에이전트에게는 지도(CLAUDE.md, 라이브 다이어그램), 신호(타입, 테스트, indigo doctor), 그리고 자기가 만든 것을 검증할 손(MCP 페르소나)이 주어져요.

Indigo로 만들기

같이 일해 보면 어떤가요?

프로덕션에 쓸 수 있나요?

Indigo는 대부분의 스타터가 건너뛰는 프로덕션 관심사를 기본 탑재해요 — 인증, RBAC, 결제, 실시간, 백그라운드 작업, i18n, SEO, 그리고 확장 가능한 서버 역할 모델까지. 데모용이 아니라 실제 제품을 돌리기 위해 만들어졌어요.

코드베이스 전체를 이해해야 하나요?

아니요 — 대부분은 평생 읽지 않을 수도 있어요. Indigo는 설정 기반이고 개방-폐쇄예요. 에이전트는 시스템이 확장을 기대하는 바로 그 자리에서 확장하고, 모든 변경은 작고 리뷰할 수 있는 diff로 남아요.

'에이전트 네이티브'가 무슨 뜻인가요?

에이전트가 일차 인터페이스라는 뜻이에요. 에이전트에게는 지도(중첩된 CLAUDE.md, 라이브 아키텍처 다이어그램)와 피드백 신호(엄격한 타입, 테스트, indigo doctor), 그리고 실행 중인 앱을 만질 손(타입이 잡힌 MCP 도구, 테스트 페르소나)이 있어요. 여러분이 제품을 설명하면 에이전트가 만들고, 검증하고, 결정이 여러분 몫일 때는 채팅으로 물어봐요.

모듈을 나중에 추가하거나 제거할 수 있나요?

네. 모듈은 자체 완결형 git 서브트리예요. bun run indigo add <module>이 라우터, 스키마, 시드, 관리자 페이지를 포함해 설치하고, remove가 도로 들어내요.

어떻게 시작하나요?

에이전트에게 한 문장을 건네세요: claude "Set up a new project named my-app from https://github.com/indigo-fw/starter — ask me what you need". 폴더를 만들고, 모든 것을 설치하고, 선택할 것들은 채팅으로 물어봐요. Codex와 Gemini CLI에서도 똑같이 동작하고 — 터미널이 더 편하다면 클래식한 degit + bun run init 경로도 그대로 있어요.

꼭 Claude여야 하나요?

아니요. Indigo는 특정 에이전트에 구애받지 않아요: Claude Code, Codex CLI, Gemini CLI 모두 동작하고, 제공되는 장치들도 열린 표준이에요 — CLAUDE.md/AGENTS.md 컨텍스트 파일, MCP 엔드포인트, 비대화형 CLI. 명령을 실행할 수 있는 코딩 에이전트라면 무엇이든 루프를 돌릴 수 있어요. 에이전트 없이 전부 손으로 개발해도 되고요.

에이전트가 뭔가를 망가뜨리면요?

환경 자체가 조용히 망가뜨릴 수 없게 만들어져 있어요. 엄격한 TypeScript, Zod로 제약된 입력, 소유권 검사가 잘못된 변경을 거부하고, indigo doctor와 테스트가 모든 패스를 채점해요. 공유 코어는 절대 수정되지 않으니 영향 범위는 그 변경 안에 머물러요. 그리고 모든 패스는 평범한 git diff로 안착해요 — 리뷰하거나, 되돌리세요.

프레임워크 업데이트는 제 프로젝트에 어떻게 반영되나요?

코어와 모듈은 git 서브트리로 여러분의 저장소 안에 살고, 여러분의 기능은 그것들을 수정하는 대신 설정과 등록으로 확장해요 — 그래서 업데이트는 여러분이 만든 것과 충돌하지 않고 깔끔하게 당겨져 와요. 강제 마이그레이션도, 대신 결정하는 플랫폼도 없어요: 여러분이 원할 때 pull 하는 거예요.

도움은 어디서 받나요?

질문은 GitHub Discussions, 버그는 GitHub Issues, 가이드는 문서에서요. 상용 지원이 필요하면 팀에 연락해 주세요.

아직 궁금한 게 남았나요?

Indigo를 이해하는 가장 빠른 방법은 직접 써 보는 거예요 — 라이브 데모는 모든 모듈을 돌리고 있어요.