프로젝트 소개

coss.com/ui(구 Origin UI)는 Cal.com의 공식 디자인 시스템으로 설명됩니다. 이 저장소는 TypeScript로 작성되고 Turborepo로 관리되는 여러 제품과 애플리케이션을 포함하는 모노레포입니다. 저장소 레이아웃 모노레포에는 다음과 같은 앱과 패키지가 포함되어 있습니다: - apps/www/ — 메인 coss.com 웹사이트 - apps/ui/ — coss ui 컴포넌트 라이브러리 및 문서 - apps/origin/ — 인수 전 스냅샷으로 유지되는 레거시 Origin UI 컴포넌트 - packages/ui/ — 공유 UI 컴포넌트 패키지 - packages/typescript-config/ — TypeScript 설정 - biome.json — 린팅 및 포맷팅을 위한 공유 Biome 설정 환경 변수 여러 Next.js 애플리케이션이 서로 연결되어 있으므로, 로컬에서 앱 간 탐색이 가능하도록 각 앱에 .env.local 파일이 필요합니다. README에는 www 앱(NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_COSS_UI_URL), ui 앱(NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_COSS_URL, NEXT_PUBLIC_ORIGIN_URL), origin 앱(NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_COSS_URL, NEXT_PUBLIC_COSS_UI_URL)을 위한 변수가 로컬호스트 포트 3000, 4000, 4001 예시와 함께 기록되어 있습니다. Turborepo는 .env* 파일을 감시하므로 해당 변수가 변경되면 캐시가 무효화됩니다. 개발 워크플로우 툴링에는 정적 타입 체크를 위한 TypeScript와 린팅 및 포맷팅을 위한 Biome이 포함됩니다. 명령어는 bun으로 실행하며, `bun run build` 및 `bun run dev`는 전체를 빌드하거나 시작하고, `--filter=www`, `--filter=ui` 또는 `--filter=origin`을 통해 단일 앱을 대상으로 지정할 수 있습니다. coss ui 제공 기능 coss ui는 Base UI를 기반으로 구축되고 Tailwind CSS로 스타일링된 접근 가능하며 조합 가능한 React 컴포넌트 모음으로, 개발자가 코드를 복사, 붙여넣기 하여 직접 소유할 수 있도록 설계되었습니다. README에 따르면 Base UI의 스타일이 없는 프리미티브에 즉시 사용 가능한 디자인 시스템을 부여한 것이며, Cal.com이 점진적으로 채택할 계획인 컴포넌트 라이브러리입니다. 개발은 공개적으로 계속 진행됩니다. Origin UI 인수 저장소에는 레거시 스냅샷으로 Origin UI 컴포넌트가 포함되어 있습니다. 이는 Radix 기반의 shadcn 스타일 모음으로 사용은 가능하지만 지원 및 유지보수는 제한적입니다. 현재 활발한 작업은 coss ui 프리미티브를 기반으로 구축된 새로운 Particles 컴포넌트에 집중되어 있습니다. 버그 보고, 기능 제안 및 문서화와 관련된 기여는 apps/ui/CONTRIBUTING.md의 가이드라인을 통해 가능합니다. 라이선스 라이선스는 혼합되어 있습니다. 프로젝트 기본값은 AGPLv3.0이며, apps/origin/ 및 apps/ui/는 기존 MIT 라이선스를 유지합니다. 그 외 모든 디렉토리는 AGPLv3가 적용됩니다. 자세한 내용은 LICENSING.md에 나와 있습니다. 감사의 말 README는 유틸리티 우선 CSS 프레임워크인 Tailwind CSS, 컴포넌트의 기반이 되는 접근 가능한 프리미티브인 Base UI, 복사-붙여넣기 컴포넌트 철학에 영감을 준 shadcn/ui, 그리고 컴포넌트 문서의 기반이 되는 문서 프레임워크인 Fumadocs에 감사를 표하고 있습니다.