try-module.cloud

A CLI tool for publishing npm packages to try-module.cloud for preview, testing, and sharing.

Overview

try-module.cloud allows you to easily share and preview npm packages without publishing them to the npm registry. It's ideal for testing packages in pull requests, sharing modules with teammates, or previewing changes before official releases.

Installation

1# Install globally
2npm install -g try-module.cloud
3
4# Or use with npx
5npx try-module.cloud publish [options]

Usage

Authentication

Before publishing packages, you need to authenticate with your organization's API key using the auth command:

1# Store your API key for an organization
2try-module.cloud auth myorg your_api_key_here
3
4# List stored organizations
5try-module.cloud auth --list
6
7# View stored key for an organization (masked)
8try-module.cloud auth myorg
9
10# Remove stored API key
11try-module.cloud auth myorg --remove

Publishing Packages

Once authenticated, you can publish packages using the publish command:

1# Publish using stored credentials
2try-module.cloud publish --organization myorg [path]

Commands

• auth <organization> <api-key>: Store API key for an organization
• auth --list: List all stored organizations
• auth <organization>: View stored API key (masked)
• auth <organization> --remove: Remove stored API key
• publish --organization <org> [path]: Publish package to try-module.cloud

Options

• --organization: Your organization name (required for publishing)
• --list, -l: List stored organizations (auth command)
• --remove, -r: Remove stored API key (auth command)
• path: Path to your package directory (defaults to current directory)

Environment Variables (Optional)

• TRY_MODULE_SECRET: Your API key for publishing (overrides stored credentials)

Examples

1# Store API key once
2try-module.cloud auth myorg your_secret_key
3
4# Publish using stored credentials
5try-module.cloud publish --organization myorg ./my-package
6
7# Override with environment variable (backward compatibility)
8TRY_MODULE_SECRET=your_secret try-module.cloud publish --organization myorg ./my-package
9
10# List all stored organizations
11try-module.cloud auth --list
12
13# Remove stored credentials
14try-module.cloud auth myorg --remove

After successful publishing, the CLI will display a URL that can be used to install your package.

GitHub Actions Integration

You can automatically publish your package on pull requests using the provided GitHub Action.

1name: Publish to try-module.cloud
2
3on:
4  pull_request:
5
6permissions:
7  pull-requests: write
8  contents: read
9
10jobs:
11  publish:
12    runs-on: ubuntu-latest
13    steps:
14      - name: Checkout code
15        uses: actions/checkout@v4
16
17      - name: Publish to try-module.cloud
18        uses: TorstenDittmann/try-module-action@main
19        with:
20          organization: your-organization
21          directory: ./path-to-package
22          secret: ${{ secrets.TRY_MODULE_SECRET }}
23          github-token: ${{ secrets.GITHUB_TOKEN }}

Using Published Packages

After publishing, you'll receive a URL that can be used to install your package:

1# With npm
2npm install https://try-module.cloud/your-organization/package-name@commit-hash
3
4# With yarn
5yarn add https://try-module.cloud/your-organization/package-name@commit-hash
6
7# With pnpm
8pnpm add https://try-module.cloud/your-organization/package-name@commit-hash

How It Works

The tool:

1. Detects your package manager (npm, yarn, pnpm)
2. Packs your module using npm pack
3. Uploads the package to try-module.cloud using your API key
4. Returns a URL that can be used to install the package

For versioning, the tool automatically detects the environment and uses the appropriate commit hash:

• In GitHub Actions: Uses the commit SHA of the branch being built
• In GitLab CI: Uses the commit short SHA
• In a Git repository: Uses the current commit's short SHA
• Fallback: Uses the current timestamp if no commit information is available

License

ISC - Created by Torsten Dittmann