npm — Developer Guide

Setup

Configure Registry

# Set as default registry
npm set registry https://npm.registry.hochguertel.work

# Or per-project in .npmrc
echo "registry=https://npm.registry.hochguertel.work" > .npmrc

Login

npm login --registry https://npm.registry.hochguertel.work
# Opens browser → Authelia login → token saved to ~/.npmrc

Verify

npm whoami --registry https://npm.registry.hochguertel.work

Publishing Packages

# Publish a package
npm publish --registry https://npm.registry.hochguertel.work

# Publish a scoped package
npm publish --scope=@copilot-webui --registry https://npm.registry.hochguertel.work

Installing Packages

# Public packages are proxied through Verdaccio
npm install lodash

# Private packages are served directly
npm install @copilot-webui/my-package

Using in CI/CD

Create a .npmrc in your project:

registry=https://npm.registry.hochguertel.work
//npm.registry.hochguertel.work/:_authToken=${NPM_TOKEN}

Set NPM_TOKEN as a CI environment variable.