🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Static App
πŸ¦€ ClawHub

Static App

by @akellacom

Deploy static websites to Static.app hosting. Use when the user wants to deploy, upload, or host a static site on Static.app. Triggers on phrases like "deploy to static.app", "upload to static", "host on static.app", "static.app deploy", or when working with the Static.app hosting service.

Versionv1.0.4
Downloads1,713
Installs1
Stars⭐ 2
#devops#legal#automation
TERMINAL
clawhub install static-app

πŸ“– About This Skill

name: Static Website Hosting - Static.app description: Deploy static websites to Static.app hosting. Use when the user wants to deploy, upload, or host a static site on Static.app. Triggers on phrases like "deploy to static.app", "upload to static", "host on static.app", "static.app deploy", or when working with the Static.app hosting service.

Static.app Deployment Skill

Deploy static websites and applications to Static.app hosting directly from OpenClaw.

Workspace Structure

All Static.app operations in your workspace use a dedicated folder structure:

workspace/
└── staticapp/              # Main folder for all Static.app operations
    β”œβ”€β”€ new-site/           # New sites created locally
    └── {pid}/              # Downloaded existing sites (by PID)

  • New sites: Created in staticapp/ subfolders before deployment
  • Downloaded sites: Extracted to staticapp/{pid}/ for editing

    • How Static.app Handles Files

    Static.app automatically creates clean URLs from your filenames:

    | File | URL | |------|-----| | index.html | / (homepage) | | about.html | /about | | portfolio.html | /portfolio | | contact.html | /contact |

    No subdirectories needed! Just create .html files in the root folder.

    Project Structure

    Simple Multi-Page Site

    my-site/
β”œβ”€β”€ index.html          # Homepage β†’ /
β”œβ”€β”€ about.html          # About page β†’ /about
β”œβ”€β”€ portfolio.html      # Portfolio β†’ /portfolio
β”œβ”€β”€ contact.html        # Contact β†’ /contact
β”œβ”€β”€ style.css           # Stylesheet
β”œβ”€β”€ js/                 # JavaScript files
β”‚   β”œβ”€β”€ main.js
β”‚   └── utils.js
└── images/             # Images folder
    β”œβ”€β”€ logo.png
    └── photo.jpg

    JavaScript App (React, Vue, etc.)

    For JS apps, build first, then deploy the dist (or build) folder:

    # Build your app
npm run build
    Deploy the dist folder
    
node scripts/deploy.js ./dist

    Prerequisites

    1. Get API Key: Go to https://static.app/account/api and create an API key (starts with sk_) 2. Set Environment Variable: Store the API key in STATIC_APP_API_KEY env var

    Usage

    Deploy Multi-Page Site

    # Create your pages
echo '
    Home
    ' > index.html
echo '
    About
    ' > about.html
echo '
    Portfolio
    ' > portfolio.html
    Deploy
    
node scripts/deploy.js

    Deploy Specific Directory

    node scripts/deploy.js ./my-site

    Update Existing Site

    node scripts/deploy.js . --pid olhdscieyr

    List All Sites

    node scripts/list.js

    List Site Files

    node scripts/files.js YOUR_PID

    Options:

  • --raw β€” Output raw JSON
  • -k β€” Specify API key

    • Delete Site

    node scripts/delete.js YOUR_PID

    Options:

  • -f, --force β€” Skip confirmation prompt
  • -k β€” Specify API key

    • Download Site

    Download an existing site to your workspace for editing:

    node scripts/download.js YOUR_PID

    This will: 1. Fetch the download URL from Static.app API 2. Download the site archive 3. Extract it to staticapp/{pid}/

    Options:

  • -p, --pid β€” Site PID to download
  • -o, --output β€” Custom output directory (default: ./staticapp/{pid})
  • -k β€” Specify API key
  • --raw β€” Output raw JSON response

    • Example: 

    # Download site to default location
node scripts/download.js abc123
    Download to custom folder
    
node scripts/download.js abc123 -o ./my-site

    Script Options

    node scripts/deploy.js [SOURCE_DIR] [OPTIONS]
    Arguments:
  SOURCE_DIR          Directory to deploy (default: current directory)
    Options:
  -k, --api-key       API key (or set STATIC_APP_API_KEY env var)
  -p, --pid           Project PID to update existing site
  -e, --exclude       Comma-separated exclude patterns
  --keep-zip          Keep zip archive after deployment

    Default Exclusions

    The following are automatically excluded from deployment:

  • node_modules
  • .git, .github
  • *.md
  • package*.json
  • .env
  • .openclaw

    • Important Notes

    βœ… What Works

  • Static HTML sites β€” Any number of .html pages
  • CSS & JavaScript β€” Frontend frameworks, vanilla JS
  • Images & Assets β€” Place in images/ folder or root
  • JavaScript files β€” Place in js/ folder or root
  • Built JS Apps β€” Deploy dist/ or build/ folder after npm run build

    • ❌ What Doesn't Work

  • Node.js Server Apps β€” No server-side rendering, no Express.js, no API routes
  • PHP, Python, Ruby β€” Static.app only serves static files
  • Databases β€” Use client-side storage or external APIs

    • JavaScript Apps Workflow

    # 1. Build your React/Vue/Angular app
npm run build
    2. Deploy the build output
    
node scripts/deploy.js ./dist --pid YOUR_PID

    API Reference

    Deploy Site

  • Endpoint: POST https://api.static.app/v1/sites/zip
  • Auth: Bearer token (API key)
  • Body: Multipart form with archive (zip file) and optional pid

    • List Sites

  • Endpoint: GET https://api.static.app/v1/sites
  • Auth: Bearer token (API key)
  • Headers: Accept: application/json

    • List Site Files

  • Endpoint: GET https://api.static.app/v1/sites/files/{pid}
  • Auth: Bearer token (API key)
  • Headers: Accept: application/json

    • Delete Site

  • Endpoint: DELETE https://api.static.app/v1/sites/{pid}
  • Auth: Bearer token (API key)
  • Headers: Accept: application/json

    • Download Site

  • Endpoint: GET https://api.static.app/v1/sites/download/{pid}
  • Auth: Bearer token (API key)
  • Headers: Accept: application/json
  • Response: Returns download URL for the site archive

    • Dependencies

  • archiver β€” Zip archive creation
  • form-data β€” Multipart form encoding
  • node-fetch β€” HTTP requests
  • adm-zip β€” Zip extraction

    • Install with: cd scripts && npm install

    Response

    On success, the script outputs: 

    βœ… Deployment successful!
🌐 Site URL: https://xyz.static.app
πŸ“‹ PID: abc123
    STATIC_APP_URL=https://xyz.static.app
STATIC_APP_PID=abc123

    Workflow

    1. Check for STATIC_APP_API_KEY env var or --api-key 2. Create zip archive from source directory (with exclusions) 3. Upload to Static.app API 4. Parse response and output URLs 5. Clean up temporary zip file

    Error Handling

  • Missing API key β†’ Clear error with instructions
  • Network issues β†’ HTTP error details
  • Invalid PID β†’ API error message

    • πŸ’‘ Examples

    Deploy Multi-Page Site

    # Create your pages
echo '
    Home
    ' > index.html
echo '
    About
    ' > about.html
echo '
    Portfolio
    ' > portfolio.html
    Deploy
    
node scripts/deploy.js

    Deploy Specific Directory

    node scripts/deploy.js ./my-site

    Update Existing Site

    node scripts/deploy.js . --pid olhdscieyr

    List All Sites

    node scripts/list.js

    List Site Files

    node scripts/files.js YOUR_PID

    Options:

  • --raw β€” Output raw JSON
  • -k β€” Specify API key

    • Delete Site

    node scripts/delete.js YOUR_PID

    Options:

  • -f, --force β€” Skip confirmation prompt
  • -k β€” Specify API key

    • Download Site

    Download an existing site to your workspace for editing:

    node scripts/download.js YOUR_PID

    This will: 1. Fetch the download URL from Static.app API 2. Download the site archive 3. Extract it to staticapp/{pid}/

    Options:

  • -p, --pid β€” Site PID to download
  • -o, --output β€” Custom output directory (default: ./staticapp/{pid})
  • -k β€” Specify API key
  • --raw β€” Output raw JSON response

    • Example: 

    # Download site to default location
node scripts/download.js abc123
    Download to custom folder
    
node scripts/download.js abc123 -o ./my-site

    βš™οΈ Configuration

    1. Get API Key: Go to https://static.app/account/api and create an API key (starts with sk_) 2. Set Environment Variable: Store the API key in STATIC_APP_API_KEY env var