Preview Service CLI

Deploy your React, Vue, and Next.js apps to user-spa.com with a single command.

Installation

npm install
npm link  # Optional: makes 'preview-cli' available globally

Configuration

The CLI uses the production API by default (https://aiswforge.com/api/spa-deploy).

For local development:

cp .env.example .env
# Edit .env and set DEPLOY_API=http://localhost:4005

Usage

Deploy a built app

# Deploy a directory
preview-cli deploy ./build

# Deploy with custom project/user IDs
preview-cli deploy ./build -p my-project -u user123

# Deploy a zip file
preview-cli deploy ./app.zip

List deployments

preview-cli list

Delete a deployment

preview-cli delete happy-panda-x7k9

Use custom API endpoint

# Via command line option
preview-cli deploy ./build --api http://localhost:4005

# Via environment variable
DEPLOY_API=http://localhost:4005 preview-cli deploy ./build

Example Workflow

1. Build your React app:

npm run build

2. Deploy it:

preview-cli deploy ./build

3. Get your URL:

✔ Deployment successful!

Deployment Details:
ID: happy-panda-x7k9
URL: https://happy-panda-x7k9.user-spa.com
Files: 15
Size: 1.52 MB
Framework: react

Supported Frameworks

• ✅ React (with BrowserRouter or HashRouter)
• ✅ Vue.js
• ✅ Next.js (static export)
• ✅ Any static HTML/JS/CSS

Important Notes

1. Build with relative paths: Add "homepage": "." to your package.json
2. Client-side routing: The service handles SPA routing automatically
3. HTTPS only: All deployments are served over HTTPS
4. Unique subdomains: Each deployment gets a memorable subdomain