Private registry

Lovable workspace 안에 private npm registry를 설정하여 패키지를 공개하지 않고 게시·설치하세요.

Private registry는 Lovable 내부에 비공개로 호스팅되는 전용 npm registry를 workspace에 제공합니다. npm 패키지를 공개하지 않고 직접 게시할 수 있으며 workspace의 모든 프로젝트가 해당 패키지를 설치할 수 있습니다.

Private registry 설정은 workspace owner와 admin만 할 수 있습니다. editor는 registry에 게시된 패키지를 조회할 수 있습니다.

Private registry를 사용하는 이유

내부 팀은 디자인 시스템, 유틸리티 라이브러리, 공개해서는 안 되는 독점 API 클라이언트 같은 공유 코드를 위해 private npm 패키지를 유지하는 경우가 많습니다. Lovable의 private registry를 사용하면 다음을 할 수 있습니다.

• 우회 방법 없이 Lovable 프로젝트에 내부 패키지 설치
• 독점 코드를 비공개로 안전하게 유지
• 버전이 매겨진 내부 라이브러리를 workspace 프로젝트 전반에서 일관되게 재사용

일반적인 활용 사례

• 내부 UI 컴포넌트 라이브러리: 조직의 디자인 시스템을 private 패키지로 설치해 Lovable 프로젝트에서 사용
• 공유 유틸리티: 내부 검증·포맷·데이터 페칭 패키지를 여러 프로젝트에서 사용
• 독점 통합: 공개할 수 없는 내부 SDK 또는 API 클라이언트 설치

사전 요건

• Lovable Enterprise plan
• Workspace owner 또는 admin 역할

Private registry 설정하기

Private registry 설정은 두 부분으로 구성됩니다.

1. Lovable workspace settings에서 registry를 활성화하고 service account key를 생성합니다.
2. .npmrc 파일을 추가하고 service account key를 npm-key.json 파일로 추가한 뒤 service account key로 private registry에 인증을 실행해 코드 프로젝트를 구성합니다.

Part 1: registry 활성화

Part 2: 코드 프로젝트 구성

게시된 패키지 조회

패키지가 private registry에 게시되면 Settings → Build & deploy → Private registry에서 조회할 수 있습니다. 각 패키지마다 이름, 최신 게시 버전, 마지막 업데이트 시점을 확인할 수 있습니다.

private 패키지 사용하기

Lovable 프로젝트에 private 패키지를 설치하려면 공개 npm 패키지와 마찬가지로 패키지 이름을 Lovable에게 프롬프트하세요. 예를 들면 다음과 같습니다.

Install @my-org/ui-components and use it to replace the current button component.

Lovable이 구성된 private registry에서 패키지를 자동으로 해석합니다.

제한 사항

• workspace당 private registry는 하나만 구성할 수 있습니다.
• registry는 workspace owner와 admin만 구성할 수 있습니다. editor와 viewer는 registry 설정에 접근할 수 없습니다.

FAQ