소개

소개

shadcn/ui가 무엇인지, 어떤 철학으로 만들었는지를 설명하는 문서예요. 핵심은 컴포넌트 라이브러리가 아니라 재사용 가능한 컴포넌트의 모음이라는 점이에요. 필요한 컴포넌트를 골라 코드를 복사해서 쓰는 방식이라, 코드에 대한 완전한 소유권과 제어권을 가질 수 있어요.

출처: 문서

본문

이 프로젝트는 컴포넌트 라이브러리가 아니에요. 앱에 복사해서 붙여 넣을 수 있는 재사용 가능한 컴포넌트들의 모음이에요.

컴포넌트 라이브러리가 아니라니 무슨 뜻일까요?

의존성으로 설치하는 게 아니라는 뜻이에요. npm으로 배포되거나 제공되지도 않아요. 필요한 컴포넌트를 골라서 코드를 프로젝트에 복사해 붙이고, 원하는 대로 커스터마이즈하면 돼요. 그 코드는 온전히 여러분의 것이에요.

이 프로젝트를 참고로 여러분만의 컴포넌트 라이브러리를 만들어 보세요.

자주 묻는 질문

왜 의존성으로 패키징하지 않고 복사/붙여 넣기 방식인가요? 코드에 대한 소유권과 제어권을 여러분에게 드리기 위해서예요. 컴포넌트를 어떻게 만들고 스타일링할지 직접 결정할 수 있어요.

합리적인 기본값에서 시작한 다음, 필요에 맞게 컴포넌트를 커스터마이즈하면 돼요.

컴포넌트를 npm 패키지로 묶을 때의 단점 중 하나는 스타일이 구현과 결합된다는 점이에요. 여러분 컴포넌트의 디자인은 구현과 분리되어야 해요.

npm 패키지로 배포할 계획이 있나요? 아니요. npm 패키지로 배포할 계획은 없어요. 어떤 프레임워크를 지원하나요?

React를 지원하는 모든 프레임워크를 사용할 수 있어요. Next.js, Astro, Remix, Gatsby 등이 있어요.

내 프로젝트에서 사용해도 되나요? 네. 개인 및 상업 프로젝트 모두 무료로 사용할 수 있어요. 저작자 표기도 필요 없어요.

그래도 사용하신다면 알려주세요. 여러분이 만든 결과물을 보고 싶거든요.

</AccordionContent>

더 알아보기

  • 설치 방법은 설치 문서를 참고해요.
  • 컴포넌트 목록은 컴포넌트 문서에서 확인해요.