Documentation

Introduction

SOURCE is a premium registry for software packages. We act as a layer between package managers (npm, pip, cargo) and developers, providing monetization and access control.

When you run npm install @source/package-name, our registry validates your access token and streams the package if authorized.

Quick Start

npm config set @source:registry https://registry.source.software

npm config set //registry.source.software/:_authToken YOUR_TOKEN

npm install @source/secure-auth

CLI Tool

The SOURCE CLI makes it easy to manage your packages and configure npm automatically.

Installation

npm install -g @source/cli

Commands

Example Workflow

# Login and configure npm
source login
source configure-npm --global

# Publish a package
cd my-package
source publish --changelog "Initial release"

Authentication

After purchasing a package subscription, you'll receive an auth token. This token is unique to your account and grants access to all packages you've purchased.

Your token can be found in your Dashboard after purchasing a package.

npm Configuration

Configure npm to use SOURCE for @source and @expert scoped packages.

Global Configuration

# Set registry for @source scope
npm config set @source:registry https://registry.source.software

# Set registry for @expert scope
npm config set @expert:registry https://registry.source.software

# Add auth token
npm config set //registry.source.software/:_authToken YOUR_TOKEN

Project-level (.npmrc)

@source:registry=https://registry.source.software
@expert:registry=https://registry.source.software
//registry.source.software/:_authToken=${SOURCE_TOKEN}

pip Configuration

Python package support is coming soon. Configure pip.conf:

# pip.conf
[global]
extra-index-url = https://YOUR_TOKEN@pip.source.software/simple/

cargo Configuration

Rust/Cargo support is coming soon. Add to .cargo/config.toml:

[registries.source]
index = "sparse+https://cargo.source.software/"
token = "source_YOUR_TOKEN"

Create a Package

1. Sign in with GitHub at /login
2. Go to your Creator Dashboard
3. Fill in the package details:
   • Name: lowercase, hyphens allowed
   • Scope: @source or @expert
   • Pricing Model: subscription, PPV, or AI license
   • Price: monthly amount in USD
4. Click "Create Package"

Upload Versions

After creating a package, upload your code as a tarball (.tgz):

1. Navigate to your package in the Creator Dashboard
2. Enter the version number (semver format, e.g., 1.0.0)
3. Drag and drop or select your .tgz file
4. Add optional changelog notes
5. Click "Publish Version"

# In your package directory
npm pack
# This creates package-name-1.0.0.tgz

Pricing Models

REST API

The registry follows the npm registry protocol. For complete API documentation including all endpoints, authentication, and code examples, see our full API reference.

curl -H "Authorization: Bearer source_YOUR_TOKEN" \
  https://registry.source.software/@source/package-name

Webhooks

Webhook support for package events (new versions, purchases) is planned for a future release.

Rate Limits