Introduction
Guides
npm Package Registry
pckgs.io provides a npm registry for scoped Node.js packages. It speaks the npm protocol so the standard npm client installs and publishes against it with granular access control to strictly manage who can reach each package across your team.
Supported Capabilities
pckgs.io implements the npm registry protocol that npm speaks natively:
| Capability | What You Can Do | Supported Via |
|---|---|---|
| Package Resolution | Fetch packuments and download tarballs | npm install |
| Publishing | Push new releases or deploy automatically from CI/CD | npm publish |
| Authentication | Authenticate once with an access token | .npmrc, npm login |
| Dist Tags | Point latest, next, or your own channel at a version | npm dist-tag |
| Deprecation | Mark a version or range as deprecated | npm deprecate |
| Visibility Control | Keep packages strictly private to your team or expose them publicly | Web Dashboard |
| Granular Access | Control read/write permissions per package for members and CI/CD | Web Dashboard |
| One-Click Import | Import packages from npmjs.com, GitHub Packages, or any npm-compatible registry | Web Dashboard |
Package Names Must Be Scoped
Every package in a pckgs.io npm registry is addressed as @scope/name. Publishing an unscoped
name such as utils is not supported you should publish it as @your-scope/utils instead.
@acme/utils ✔ valid
@acme/ui-kit ✔ valid
utils ✘ rejected — no scope Both segments accept lowercase letters, digits, ., -, and _, may not start with . or _,
and the full name may not exceed 214 characters.
Pricing
Every plan includes:
- Unlimited public packages
- Unlimited private packages
- Unlimited team members
- Granular access control
- Access to All Registries
| Plan | Price | Storage | Transfer |
|---|---|---|---|
| Free | $0 / month | 100 MB | 500 MB / month |
| Pro | $6.99 / month | 5 GB | 25 GB / month |
See the full Pricing page for details.
To Get Started
- Create an organization this is your space to store your packages.
- Open your organization’s Registries page and enable the npm registry. This provisions your registry at
https://npm.pckgs.io/YOUR_ORG_SLUG. - Create an access token and configure it following the Authentication guide.
- Publish your first package, or import one from npmjs.com or any npm-compatible registry.
- Install packages from your registry in any Node.js project.
Related
- npm Package Registry Authentication
- How to Publish an npm Package
- How to Install an npm Package
- How to Import an npm Package
Need help? Contact us here or at support@pckgs.io.