Repolode
vadimdemedes

vadimdemedes/ink

터미널에서 컴포넌트와 Flexbox 레이아웃으로 대화형 CLI 앱을 만드는 React 렌더러입니다.

스타
40,136
포크
1,062
열린 이슈
33
마지막 커밋
19일 전

어떤 프로젝트인가요?

Ink를 사용하면 컴포넌트, props, hooks를 활용해 React 웹 UI를 만드는 것과 같은 방식으로 CLI를 구축할 수 있습니다. Yoga 레이아웃 엔진을 사용해 각 요소를 Flexbox 컨테이너로 배치하므로, padding, margin, flexGrow, justifyContent 같은 익숙한 CSS 스타일 속성을 터미널에서도 사용할 수 있습니다.

이 패키지에는 Text, Box, Newline, Spacer, Static, Transform 같은 기본 컴포넌트와 키보드 입력(useInput), 앱 생명주기(useApp), stdin/stdout 접근, 포커스 관리용 hooks가 포함되어 있습니다. React 렌더러이므로 React의 표준 기능을 모두 사용할 수 있으며, 문서에서는 Ink 고유의 API만 다룹니다.

Ink는 여러 에이전트형 코딩 도구, 클라우드 제공업체의 CLI, 그리고 Gatsby와 Tap의 진행 상황 출력 같은 대화형 개발자 도구에서 사용됩니다.

핵심 기능

  • 01React 컴포넌트를 터미널 출력으로 렌더링합니다.
  • 02Yoga를 통해 CSS 스타일 속성을 지원하는 Flexbox 레이아웃을 제공합니다.
  • 03색상, 굵게, 기울임, 텍스트 자르기 등의 Text 스타일을 지원합니다.
  • 04키보드 입력, 포커스 관리, 창 크기 확인용 hooks를 제공합니다.
  • 05실시간 출력 위쪽에 로그와 완료된 항목을 유지하는 Static 렌더링을 제공합니다.

활용 사례

  • 실시간으로 업데이트되는 진행 상황 화면이 있는 대화형 CLI 도구 구축.
  • 키보드 입력에 반응하는 터미널 대시보드 제작.
  • 상태를 스트리밍으로 표시하는 테스트 러너나 빌드 도구 개발.
  • 터미널에서 실행되는 AI 에이전트 또는 채팅 인터페이스 개발.

빠른 시작

  1. 1

    npm으로 Ink와 React를 설치하세요

    npm install ink react
  2. 2

    create-ink-app으로 새 Ink CLI 프로젝트의 기본 구조를 만드세요

    npx create-ink-app my-ink-cli

사용 전 알아둘 점

  • README에는 npm에 공개된 최신 안정 버전이 아니라 다음 버전에 대한 내용이 설명되어 있습니다.

토픽

자주 묻는 질문

ink은(는) 무엇인가요?
터미널에서 컴포넌트와 Flexbox 레이아웃으로 대화형 CLI 앱을 만드는 React 렌더러입니다. Ink를 사용하면 컴포넌트, props, hooks를 활용해 React 웹 UI를 만드는 것과 같은 방식으로 CLI를 구축할 수 있습니다. Yoga 레이아웃 엔진을 사용해 각 요소를 Flexbox 컨테이너로 배치하므로, padding, margin, flexGrow, justifyContent 같은 익숙한 CSS 스타일 속성을 터미널에서도 사용할 수 있습니다.
ink은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
ink은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
ink은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. ink의 마지막 커밋은 2026년 10월 3일입니다.
ink은(는) 어디에 사용할 수 있나요?
실시간으로 업데이트되는 진행 상황 화면이 있는 대화형 CLI 도구 구축. 키보드 입력에 반응하는 터미널 대시보드 제작. 상태를 스트리밍으로 표시하는 테스트 러너나 빌드 도구 개발. 터미널에서 실행되는 AI 에이전트 또는 채팅 인터페이스 개발.
ink는 어떻게 설치하나요?
npm으로 Ink와 React를 설치하세요: npm install ink react create-ink-app으로 새 Ink CLI 프로젝트의 기본 구조를 만드세요: npx create-ink-app my-ink-cli
ink은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/vadimdemedes/ink

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트