W-Spaces Deployment

Deploy static websites to W-Spaces (wspaces.app). Create projects, push HTML, and deploy to a live URL — all via API.

Configuration

Get your API key

1. Register: scripts/wspaces_auth.sh --register --email you@example.com --password yourpass --name "Your Name"
2. Verify your email (check inbox)
3. Login: scripts/wspaces_auth.sh --login --email you@example.com --password yourpass
4. Copy the API key from the response

Set the API key

export WSPACES_API_KEY="wsk_live_xxxx..."

Or store in .env:

WSPACES_API_KEY=wsk_live_xxxx...

Operations

Create a project

scripts/wspaces_project.sh --create --name "My Landing Page"

Response includes project ID and slug.

Push HTML code

# From a file
scripts/wspaces_push.sh --project <project-id> --file ./index.html

# From inline HTML
scripts/wspaces_push.sh --project <project-id> --html "<html><body><h1>Hello</h1></body></html>"

Deploy to live URL

scripts/wspaces_deploy.sh --project <project-id>

Result: https://<slug>.wspaces.app

List projects

scripts/wspaces_project.sh --list

Check project details

scripts/wspaces_project.sh --get --id <project-id>

View deployments

scripts/wspaces_deploy.sh --list --project <project-id>

Common Workflows

Deploy a landing page

# 1. Create project
scripts/wspaces_project.sh --create --name "Startup Landing"
# → project ID: abc-123

# 2. Push code
scripts/wspaces_push.sh --project abc-123 --file ./index.html

# 3. Deploy
scripts/wspaces_deploy.sh --project abc-123
# → https://startup-landing-xyz.wspaces.app

Update existing site

# Push new code (creates new version)
scripts/wspaces_push.sh --project abc-123 --file ./index.html

# Redeploy
scripts/wspaces_deploy.sh --project abc-123

Full flow from scratch

Tell your agent:

• "Create a W-Spaces project called My Portfolio"
• "Push this HTML to my W-Spaces project"
• "Deploy my project to wspaces.app"

API Key Management

# Create additional API key
scripts/wspaces_auth.sh --create-key --name "CI/CD Key"

# List all keys
scripts/wspaces_auth.sh --list-keys

# Revoke a key
scripts/wspaces_auth.sh --revoke-key --id <key-id>

API Reference

See wspaces-api.md for complete API documentation.

Troubleshooting

"WSPACES_API_KEY not set"

export WSPACES_API_KEY="wsk_live_xxx..."

"Invalid API key"

• Key may be revoked — generate a new one via login
• Check for extra spaces when copying

"Please verify your email"

• Check your inbox for verification email
• Verify before logging in

"Project not found"

• Verify project ID with scripts/wspaces_project.sh --list