@openworkers/adapter-static

Static site adapter for OpenWorkers. Converts any static site into a deployable worker with optimized asset serving.

Installation

bun add -g @openworkers/adapter-static

Quick Start

# Auto-detect input folder and generate worker
adapter-static

# Specify input and output directories
adapter-static ./build -o ./dist

# Custom 404 page
adapter-static --fallback /404.html

CLI Options

| Option | Flag | Default | Description | | --------- | ---------------- | ------------------ | --------------------------------------------------- | | Input | positional | auto-detect | Source directory (dist, build, out, public) | | Output | -o, --out | dist-openworkers | Output directory | | Mode | -m, --mode | auto-detect | Routing mode: directory or flat | | Fallback | -f, --fallback | none | Fallback file for unmatched routes | | Immutable | --immutable | auto-detect | Comma-separated immutable path patterns |

Programmatic Usage

import { adapt } from '@openworkers/adapter-static';

await adapt({
  input: 'build',
  out: 'dist',
  mode: 'flat',
  fallback: '/404.html'
});

Output Structure

dist/
├── _worker.js     # Worker serving files via ASSETS binding
├── _routes.json   # Route manifest for edge routing
└── assets/        # Static files

Routing Modes

The adapter auto-detects the routing mode based on your file structure.

| Mode | URL | File | | ------------- | -------- | ------------------- | | Directory | /about | /about/index.html | | Flat | /about | /about.html |

Directory mode is used by most static generators. Flat mode is common with SvelteKit static adapter.

Immutable Assets

Assets with hashed filenames are served with long cache headers (max-age=31536000, immutable).

Auto-detected patterns:

• /_app/immutable/* — SvelteKit
• /assets/* — Vite
• /_next/static/* — Next.js
• /_astro/* — Astro

Deploy to OpenWorkers

Quick deploy (existing worker):

ow workers upload my-site ./dist

Full setup:

# 1. Create storage for assets
ow storage create my-site-assets --provider platform

# 2. Create environment
ow env create my-site-env

# 3. Bind storage to environment as ASSETS
ow env bind my-site-env ASSETS my-site-assets -t assets

# 4. Create worker
ow workers create my-site

# 5. Link environment to worker
ow workers link my-site my-site-env

# 6. Build and upload
adapter-static ./build -o ./dist
ow workers upload my-site ./dist

Your site is live at https://my-site.workers.rocks

License

MIT