Publish with Script - SimpleHost

The Publish Script

publish.sh is a self-contained bash script that handles the entire publish flow: scanning files, computing hashes, uploading, and finalizing.

Download

curl -fsSL https://simplehost.dev/publish.sh -o publish.sh && chmod +x publish.sh

Requirements

curl — for HTTP requests
jq — for JSON parsing
shasum or sha256sum — for file hashing (pre-installed on macOS and most Linux)

Usage

Publish a new site

./publish.sh ./my-directory

Update an existing site

./publish.sh ./my-directory existing-slug

With authentication (permanent sites)

export SIMPLEHOST_API_KEY="sh_live_your_key_here"
./publish.sh ./dist

Custom API base URL

export SIMPLEHOST_BASE="https://simplehost.dev"
./publish.sh ./dist

What the Script Does

Scan files

Recursively finds all files in the directory and builds a JSON manifest with relative paths, sizes, content types, and SHA-256 hashes.

Create or update

Sends the manifest to POST /api/v1/publish (new site) or PUT /api/v1/publish/:slug (update).

Upload files

Uploads each file to its presigned URL. Files that match by hash are skipped automatically.

Finalize

Calls the finalize endpoint to make the site live.

Output

📦 Scanning files...
  Found 12 file(s)
🚀 Creating site...
  Site: bright-canvas-a7k2
  Skipped (dedup): 0 file(s)
⬆️  Uploading 12 file(s)...
  [1/12] index.html
  [2/12] style.css
  ...
✅ Finalizing...

🎉 Published!
   URL:  https://bright-canvas-a7k2.simplehost.dev/
   Slug: bright-canvas-a7k2

Supported File Types

The script automatically detects content types for common file extensions:

Category	Extensions
Web	`.html`, `.css`, `.js`, `.json`, `.xml`, `.svg`
Images	`.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.avif`, `.ico`
Fonts	`.woff`, `.woff2`, `.ttf`, `.otf`
Media	`.mp4`, `.webm`, `.mp3`, `.ogg`, `.wav`
Documents	`.pdf`, `.txt`, `.md`, `.csv`
Other	`.zip` and any unrecognized extension (`application/octet-stream`)

CI/CD Integration

You can use the script in any CI/CD pipeline:

# GitHub Actions example
- name: Publish to SimpleHost
  env:
    SIMPLEHOST_API_KEY: ${{ secrets.SIMPLEHOST_API_KEY }}
  run: |
    curl -fsSL https://simplehost.dev/publish.sh -o publish.sh && chmod +x publish.sh
    ./publish.sh ./dist

​The Publish Script

​Download

​Requirements

​Usage

​Publish a new site

​Update an existing site

​With authentication (permanent sites)

​Custom API base URL

​What the Script Does

​Output

​Supported File Types

​CI/CD Integration