Registry 구조

소스 관리 위치

생성된 출력

• registry/registry.json · registry/public/r — 레지스트리 소스로부터 생성합니다.
• docs/public/r — 문서에서도 같은 설치 엔드포인트를 제공하도록 복사합니다.
• docs/src/registry — 동기화된 빌드 입력이며 Git 관리에서 제외합니다. 별도의 원본 소스가 아닙니다.
• 생성된 CSS와 테마 초기화 스크립트는 같은 테마 엔진에서 만듭니다.

설치 흐름

@neumorphism-ui — 네임스페이스는 하나의 URL 템플릿으로 연결됩니다. shadcn은 각 항목에 선언된 레지스트리 의존성을 함께 설치합니다. 컴포넌트를 추가하기 전에 공통 기본 테마를 한 번 설치하세요.

https://neumorphism-ui.andongmin.com/r/{name}.json

npx shadcn@latest add @neumorphism-ui/button

전체 독립 설치 검사는 로컬 또는 수동 전체 검증 워크플로에서 실행합니다. 템플릿은 새 Next.js 프로젝트에서, 나머지 파일 포함 항목은 Next.js와 Vite에서 빌드합니다. 기본 CI는 대표 소비자 프로젝트를 검사합니다.

디렉터리 메타데이터

registry/directory-entry.json — 네임스페이스, 홈페이지, 엔드포인트 템플릿, 설명과 인라인 로고를 저장합니다. 이 파일이 있다고 디렉터리 제출이나 승인이 완료된 것은 아닙니다.

책임 범위

• 애플리케이션의 인증, 권한, 영구 저장, 라우팅과 업무 데이터는 레지스트리가 관리하지 않습니다.
• 컴포넌트 설치는 애플리케이션 소유 CSS, 수정한 소스, 별칭과 경로를 덮어쓰지 않아야 합니다.
• 폐기한 경로는 호환용 별칭으로 남기지 않고 제거합니다.

컴포넌트 보기 →