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
| Package | Description |
|---|---|
| @glpkg/installer | Install packages from GitLab NPM registry |
| @glpkg/publisher | Publish packages to GitLab NPM registry |
| @glpkg/config | Manage 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
- Getting Started - Set up glpkg in your project
- @glpkg/installer - Learn how to install GitLab packages
- @glpkg/publisher - Learn how to publish packages