code-checkout-vscode 🔐

Add professional licensing and paywalls to your VSCode extensions in minutes!

• 🔒 Secure license validation with offline support
• 🎯 Simple command tagging for paid vs. free features
• 🛡️ Code obfuscation to protect your intellectual property
• 🌐 Seamless integration with VSCode's extension ecosystem
• ⚡ Zero-config initialization
• 🔄 Automatic license validation with offline grace period

code-checkout-vscode is more than just an npm package - it's a complete platform for managing your software licensing:

• 💼 Create a free account to get started
• 🖥️ Web Dashboard - Manage licenses, track usage, and view analytics
• 🛠️ CLI Tools - Powerful command-line interface for automation
• 📊 Analytics - Track user engagement with your commands

Visit codecheckout.dev to learn more about the full platform capabilities.

The code-checkout CLI is the recommended method to implement code-checkout into your VSCode extension. There are two ways to use code-checkout:

• Managed workflow - Use this workflow to make your commands paid features
• Custom workflow - Use the license and checkout functions directly in your code for more control over paywalls

1. Install the CLI

npm install -g @riff-tech/code-checkout-vscode-cli

You can use the CLI with code-checkout --help.

2. Initialize your VSCode extension project

code-checkout init

This will walk you through creating a Publisher & Software, setting up a Pricing Model, linking your Stripe account, and bootstrapping your project to support licensing.

3. Install the package

npm install @riff-tech/code-checkout-vscode

Add the higher-order function and tag your commands as "paid":

import {
  tagCommand,
  injectCheckoutCommands,
  TagOptions,
} from "@riff-tech/code-checkout-vscode";

// 1. Inject code-checkout commands to handle licensing
export const activate = injectCheckoutCommands(
  (context: vscode.ExtensionContext) => {
    // Your original command
    const originalCommand = () => {
      vscode.window.showInformationMessage("Hello World");
    };

    // 2. Specify the tag options
    const tagOptions: TagOptions = {
      type: "paid",
      activationMessage: "This feature is only available in the paid version",
      activationCtaTitle: "Purchase License",
      reactivationMessage: "This feature is only available in the paid version",
      reactivationCtaTitle: "Purchase License",
    };

    // 3. Tag the command
    const paidCommand = tagCommand(context, tagOptions, originalCommand);

    // Register the command as usual
    const disposable = vscode.commands.registerCommand(
      "my-extension.paidCommand",
      paidCommand,
    );

    // Add the disposable to the context
    context.subscriptions.push(disposable);
  },
);

You can use the getLicense function to check license status directly:

import { getLicense } from "@riff-tech/code-checkout-vscode";

// Get license data
const licenseData = await getLicense(context);

if (licenseData?.isValid) {
  // License is valid
  vscode.window.showInformationMessage(
    `License valid until ${licenseData.expiresOn}`,
  );
} else {
  // No valid license
  vscode.window.showWarningMessage("No valid license found");
}

// Force online validation
const validatedLicense = await getLicense(context, true);

// Check expiration
if (validatedLicense?.isExpired) {
  vscode.window.showErrorMessage("Your license has expired");
}

The getLicense function returns a LicenseData object containing:

• isValid: Whether the license is currently valid
• licenseKey: The active license key if one exists
• isExpired: Whether the license has expired
• isOnlineValidationRequired: If online validation is needed
• lastValidated: When the license was last validated
• machineId: Unique identifier for the current machine

You can use the getCheckoutUrl function to get the checkout URL for your software:

import {
  getCheckoutUrl,
  CheckoutUrlOptions,
} from "@riff-tech/code-checkout-vscode";

// 1. Optional - set custom success and cancel URLs
const checkoutUrlOptions: CheckoutUrlOptions = {
  customSuccessUrl: "https://example.com/success", // defaults to codecheckout.dev/activate
  customCancelUrl: "https://example.com/cancel", // defaults to redirect back to IDE
};

// 2. Generate the checkout URL
const checkoutUrl = await getCheckoutUrl(context, checkoutUrlOptions);

// 3. Open the checkout URL in the default browser
await vscode.env.openExternal(vscode.Uri.parse(url));

When using custom URLs, the following query parameters will be appended:

• key= - the license key (only for success URL)
• ideName= - the app scheme of the IDE (vscode, cursor, etc)
• id= - your extension ID

Example:

https://example.com/success?key=1234567890&ideName=vscode&id=publisher.my-extension

• Code obfuscation is provided but not encryption
• Obfuscation can be disabled by removing the code-checkout-build postcompile script
• We recommend implementing additional security measures for highly sensitive code

MIT © Riff Tech, LLC

• 🐛 Found a bug? Open an issue
• 💡 Have a feature request? Let us know
• 📧 Need help? Contact support

Made with ❤️ for the VSCode developer community