Documentation

Introduction

Launchpd is a command-line tool that lets you deploy static sites instantly to a live URL. No configuration files, no complex setup, no waiting—just one command and your site is live on a global CDN.

Why Launchpd?

Traditional deployment workflows are slow and complicated. Launchpd removes the friction:

  • Instant URLs: Get a live, shareable link in under 30 seconds.
  • Project-Based: Link local folders to subdomains once and deploy without re-typing names.
  • Zero Config: No complex setup; optionally use .launchpd.json for project persistence.
  • Static-Only Security: Strict validation ensures only high-performance static assets are deployed.
  • Auto-Expiration: Set temporary deployments that delete themselves automatically.
  • Version History: Rollback to any previous deployment instantly.
Instant Deploy
HTTPS Included
Auto-Expiration
Rollback Support

Quick Start

Get your first site live in two commands:

npm install -g launchpd
launchpd deploy ./my-site

That's it! You'll receive a live URL like https://sparkling-nova-82.launchpd.cloud that you can share immediately.

Installation

Install Launchpd globally using npm:

npm install -g launchpd
Requirements: Node.js 20 or higher is required.

Verify installation:

launchpd --version

Init

Link your current folder to a specific subdomain. This is persisted in a local .launchpd.json file.

launchpd init

Once initialized, you can run launchpd deploy without having to specify a folder or name again.

Deploy

The deploy command uploads your static site folder to Launchpd and returns a live URL.

Basic Usage
launchpd deploy ./my-folder

This uploads all files in ./my-folder and generates a random subdomain (if not already linked).

Deployment Messages

Add a message to your deployment to track changes:

launchpd deploy . -m "Fix layout bugs"
Custom Subdomain

Choose your own subdomain for a branded URL:

launchpd deploy ./my-folder --name my-project

Result: https://my-project.launchpd.cloud

Set Expiration

Auto-delete your deployment after a specified time:

launchpd deploy ./my-folder --expires 2h

Supported formats: 30m (minutes), 2h (hours), 7d (days).

List Deployments

View all your active deployments:

launchpd list

This displays a table of your sites with their URLs, creation dates, and expiration times.

Version History

View all versions of a specific deployment:

launchpd versions my-subdomain

Each deployment maintains a version history, allowing you to see what was deployed and when. Registered users can keep up to 10 versions per site.

Rollback

Instantly revert to a previous version of your site:

launchpd rollback my-subdomain

This rolls back to the immediately previous version. To rollback to a specific version:

launchpd rollback my-subdomain --to 2
Tip: Use launchpd versions first to see available version numbers.

Register

Create a free account to unlock more features:

launchpd register

Registration gives you more sites, longer retention, version history, and custom subdomains.

Login

Authenticate with your API key:

launchpd login

You'll be prompted to enter your API key. Your credentials are stored locally.

To logout and clear your credentials:

launchpd logout

Account Info

Check your current authentication status:

launchpd whoami

View your current usage and quota limits:

launchpd quota

Tier Limits

Launchpd offers two tiers—both completely free:

FeatureAnonymousRegistered (Free)
Active Sites310+
Storage Limit50MB100MB+
Retention7 daysPermanent
Versions per Site110
Custom Subdomains

Advanced Options

Command Reference
CommandDescription
launchpd initLink current folder to a subdomain
launchpd deploy <folder>Deploy a folder to a live URL
launchpd deploy -m <msg>Deploy with a version message
launchpd deploy --name <name>Use a custom subdomain
launchpd deploy --expires <time>Set auto-expiration (e.g., 2h, 7d)
launchpd statusShow linked subdomain and latest info
launchpd listList all your deployments
launchpd versions <subdomain>View version history
launchpd rollback <subdomain>Rollback to previous version
launchpd rollback --to <n>Rollback to specific version
launchpd registerCreate a free account
launchpd loginAuthenticate with API key
launchpd logoutClear stored credentials
launchpd whoamiShow current user
launchpd quotaShow usage and limits
Support

Need help? We're here for you: