Skip to main content

Introduction

glpkg is a collection of CLI tools for managing NPM packages with GitLab Package Registry.

What is glpkg?

glpkg provides a seamless workflow for publishing and installing private NPM packages hosted on GitLab Package Registry. It handles authentication, registry configuration, and package management automatically.

Packages

PackageDescription
@glpkg/installerInstall packages from GitLab NPM registry
@glpkg/publisherPublish packages to GitLab NPM registry
@glpkg/configManage GitLab tokens and configuration

Features

  • Simple Authentication - Store and manage GitLab tokens securely
  • Automatic .npmrc Setup - Configure registry settings automatically
  • Version Management - Support for latest, dev, and beta releases
  • CI/CD Ready - Works seamlessly in automated pipelines

Quick Start

# Install the tools globally
npm install -g @glpkg/installer @glpkg/publisher @glpkg/config

# Configure your GitLab token
gitlab-config set-token YOUR_GITLAB_TOKEN

# Install a package from GitLab registry
gitlab-install add @your-org/package

# Publish a package to GitLab registry
gitlab-publish

Next Steps