liushacom-cli

Liusha CLI

⛅️ Deploy websites with a single command - no configuration needed!

🚀 One-Line Deployment

Deploy any website instantly without installation:

npx liushacom-cli@latest deploy ./dist test.liusha.dev

Your site goes live at https://test.liusha.dev in seconds!

Installation (Optional)

For frequent use, install globally:

npm install -g liushacom-cli

Quick Start

Option 1: Instant Deploy (No Setup Required)

# Deploy immediately - perfect for testing and demos!
npx liushacom-cli@latest deploy ./dist my-awesome-site.liusha.dev

# Deploy a Single Page App
npx liushacom-cli@latest deploy ./build my-react-app.liusha.dev --spa

Option 2: Full Account Setup (For Production)

• Sign up for an account:

  liusha signup
  

• Sign in:

  liusha signin
  

• Deploy with full features:

  liusha deploy ./my-website/dist my-awesome-site.liusha.dev
  

Why Liusha CLI?

• 🚀 Zero Configuration: Deploy in one command
• ⚡ Lightning Fast: Sites live in seconds
• 🌐 Custom Domains: Use your own domain
• 📱 SPA Support: Perfect for React, Vue, Angular
• 🔑 CI/CD Ready: API keys for automation
• 💰 Flexible Plans: Start free, scale as needed

Commands Reference

Account Management

signup [-n <name>] [-e <email>] [-p <password>]

Create a new account on liusha.com

# Interactive mode
liusha signup

# Non-interactive mode
liusha signup -n "John Doe" -e "[e-mail]" -p "mypassword"

signin [-e <email>] [-p <password>]

Sign in to your existing account

# Interactive mode
liusha signin

# Non-interactive mode
liusha signin -e "[e-mail]" -p "mypassword"

signout

Sign out from your current session

liusha signout

whoami

Display current user information

liusha whoami

forgot [-e <email>]

Request a password reset email

# Interactive mode
liusha forgot

# Direct mode
liusha forgot -e "[e-mail]"

reset [-p <password>] [-t <token>]

Reset your password using the token from email

# Interactive mode
liusha reset

# Direct mode
liusha reset -p "newpassword" -t "reset-token-from-email"

Project Deployment

deploy <dir> <domain> [--spa]

Deploy a website to liusha.com

# Deploy a static website
liusha deploy ./dist my-website.liusha.dev

# Deploy a Single Page Application (SPA)
liusha deploy ./build my-spa-app.liusha.dev --spa

# One-line deploy without installation
npx liushacom-cli@latest deploy ./dist test.liusha.dev

Options:

• --spa: Deploy as Single Page Application (all routes fallback to index.html)

projects

List all your deployed projects

liusha projects

delete <domain>

Delete a deployed project

liusha delete my-website.liusha.dev

Domain Management

domain <domain> <custom_domain>

Add a custom domain to your project

liusha domain my-website.liusha.dev example.com

domain_delete <domain> <custom_domain>

Remove a custom domain from your project

liusha domain_delete my-website.liusha.dev example.com

API Key Management

create_key <name>

Create a new API key for programmatic access

liusha create_key "CI/CD Pipeline"

apikeys

List all your API keys

liusha apikeys

delete_key <id>

Delete an API key by its ID

liusha delete_key abc123def456

Using API Keys:

export LIUSHA_API_KEY=your_api_key_here
liusha deploy ./dist my-website.liusha.dev

Subscription Management

plans

View available subscription plans

liusha plans

upgrade <plan> [--annual]

Upgrade to a paid plan

# Monthly billing
liusha upgrade pro

# Annual billing (save 2 months!)
liusha upgrade pro --annual

info

View your current subscription information

liusha info

cancel

Cancel your current subscription

liusha cancel

restore

Restore a cancelled subscription before it ends

liusha restore

portal

Open Stripe billing portal to manage payment methods

liusha portal

Real-World Examples

Deploy a React App

# Build your React app
npm run build

# Deploy with one command (no installation needed!)
npx liushacom-cli@latest deploy ./build my-react-app.liusha.dev --spa

Deploy a Static Site

# Deploy static files instantly
npx liushacom-cli@latest deploy ./public my-static-site.liusha.dev

Set up CI/CD with GitHub Actions

# .github/workflows/deploy.yml
name: Deploy to Liusha
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Build
        run: npm install && npm run build
      - name: Deploy
        run: npx liushacom-cli@latest deploy ./dist ${{ github.repository }}.liusha.dev
        env:
          LIUSHA_API_KEY: ${{ secrets.LIUSHA_API_KEY }}

Custom Domain Setup

# Deploy your site
npx liushacom-cli@latest deploy ./dist my-awesome-site.liusha.dev

# Add custom domain (requires account)
liusha signin
liusha domain my-awesome-site.liusha.dev yourdomain.com

Common Use Cases

Scenario	Command	Perfect For
Quick Demo	npx liushacom-cli@latest deploy ./dist demo.liusha.dev	Showing work to clients
Testing Build	npx liushacom-cli@latest deploy ./build test.liusha.dev	Verifying deployments
Production Site	liusha deploy ./dist mysite.liusha.dev	Live websites
SPA Deployment	npx liushacom-cli@latest deploy ./dist spa.liusha.dev --spa	React/Vue/Angular apps

Subscription Plans

Run liusha plans to see current pricing and features.

Support

• 📧 Email: [e-mail]
• 🌐 Website: https://liusha.com
• 📖 Documentation: https://docs.liusha.com

Pro Tips

• No Installation Needed: Use npx liushacom-cli@latest for instant deployment
• Anonymous Deployment: Deploy without signing up for quick tests
• Environment Variables: Use LIUSHA_API_KEY for CI/CD automation
• SPA Routing: Use --spa flag for client-side routing apps
• Domain Propagation: Custom domains may take a few minutes to go live

Troubleshooting

Command not found:

# Use npx instead of installing globally
npx liushacom-cli@latest deploy ./dist test.liusha.dev

Deployment failures:

• Check internet connection
• Verify directory exists and contains files
• Try a different domain name
• Ensure directory is not empty

Custom domain issues:

• Sign in first: liusha signin
• Verify DNS configuration points to Liusha
• Allow up to 24 hours for propagation