Foundations

Versioning

컴포넌트 안정성 레벨과 버전 정책. 카피-페이스트 컴포넌트를 도입할 때 무엇을 기대할 수 있는지 정리했습니다.

Stability tiers

각 컴포넌트는 카탈로그에 안정성 레벨이 표시됩니다.

Stable

프로덕션 사용 권장. 메이저 버전 안에서는 breaking change 를 피하며, 불가피한 변경은 changelog 와 마이그레이션 안내를 함께 제공합니다.

현재: 대부분의 컴포넌트 (Button · Card · Input · Dialog · Table 등)

Beta

사용 가능하지만 다듬는 중. 마이너 버전에서 API 가 바뀔 수 있으며 변경은 changelog 에 기록합니다.

현재: 신규 추가 컴포넌트 (New 배지 표시)

Experimental

테스트 / 평가용. 프로덕션 비권장. API 가 빠르게 변할 수 있음.

현재: (현재 없음)

Deprecated

신규 사용 비권장. 제거 전 changelog 로 안내하고 가능하면 대체 컴포넌트를 명시합니다.

현재: (현재 없음)

정책

현재 단계에서 실제로 지키는 약속.

의존성 버전

주요 의존성(@base-ui/react · lucide-react · recharts 등)은 캐럿(^) 범위로 명시됩니다. 정확한 버전은 본인 프로젝트의 lockfile 로 고정해 재현 가능한 빌드를 유지하세요.

Breaking change 안내

공개 API 가 바뀌면 changelog 에 기록하고, 영향이 큰 경우 마이그레이션 메모를 함께 제공합니다.

의존성 확인

각 컴포넌트 페이지의 'Dependencies' 섹션에서 어떤 패키지에 의존하는지 확인할 수 있습니다.

보안

알려진 취약점은 가능한 한 빠르게 패치합니다. 사용자는 본인 프로젝트의 lockfile 을 정기적으로 audit 하시길 권장합니다.

SemVer 해석

Groudit UI 는 Semantic Versioning 2.0 을 따릅니다.

변경 종류	의미	사용자 액션
`x.y.Z` Patch	버그 수정만. 동작 보장.	없음
`x.Y.0` Minor	새 기능 추가. 기존 동작 유지.	선택
`X.0.0` Major	Breaking change. 마이그레이션 가이드 제공.	필수 검증

의존성 확인

각 컴포넌트 페이지의 Dependencies 섹션에서 어떤 패키지에 의존하는지 확인하세요.

Browse Components →

Stability tiers

각 컴포넌트는 카탈로그에 안정성 레벨이 표시됩니다.

Stable

프로덕션 사용 권장. 메이저 버전 안에서는 breaking change 를 피하며, 불가피한 변경은 changelog 와 마이그레이션 안내를 함께 제공합니다.

현재: 대부분의 컴포넌트 (Button · Card · Input · Dialog · Table 등)

Beta

사용 가능하지만 다듬는 중. 마이너 버전에서 API 가 바뀔 수 있으며 변경은 changelog 에 기록합니다.

현재: 신규 추가 컴포넌트 (New 배지 표시)

Experimental

테스트 / 평가용. 프로덕션 비권장. API 가 빠르게 변할 수 있음.

현재: (현재 없음)

Deprecated

신규 사용 비권장. 제거 전 changelog 로 안내하고 가능하면 대체 컴포넌트를 명시합니다.

현재: (현재 없음)

정책

현재 단계에서 실제로 지키는 약속.

의존성 버전

Breaking change 안내

공개 API 가 바뀌면 changelog 에 기록하고, 영향이 큰 경우 마이그레이션 메모를 함께 제공합니다.

의존성 확인

각 컴포넌트 페이지의 'Dependencies' 섹션에서 어떤 패키지에 의존하는지 확인할 수 있습니다.

보안

알려진 취약점은 가능한 한 빠르게 패치합니다. 사용자는 본인 프로젝트의 lockfile 을 정기적으로 audit 하시길 권장합니다.

변경 종류

의미

사용자 액션

x.y.Z Patch

버그 수정만. 동작 보장.

없음

x.Y.0 Minor

새 기능 추가. 기존 동작 유지.

선택

X.0.0 Major

Breaking change. 마이그레이션 가이드 제공.

필수 검증