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.jsonfor 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.
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
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.
launchpd deploy ./my-folder
This uploads all files in ./my-folder and generates a random subdomain (if not already linked).
Add a message to your deployment to track changes:
launchpd deploy . -m "Fix layout bugs"
Choose your own subdomain for a branded URL:
launchpd deploy ./my-folder --name my-project
Result: https://my-project.launchpd.cloud
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
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:
| Feature | Anonymous | Registered (Free) |
|---|---|---|
| Active Sites | 3 | 10+ |
| Storage Limit | 50MB | 100MB+ |
| Retention | 7 days | Permanent |
| Versions per Site | 1 | 10 |
| Custom Subdomains | ❌ | ✅ |
Advanced Options
| Command | Description |
|---|---|
launchpd init | Link 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 status | Show linked subdomain and latest info |
launchpd list | List 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 register | Create a free account |
launchpd login | Authenticate with API key |
launchpd logout | Clear stored credentials |
launchpd whoami | Show current user |
launchpd quota | Show usage and limits |
Need help? We're here for you: