Bucket Sites

Turn any folder into a deployable static website.

Right-click any folder in BucketDrive and convert it into a live website. Sites are hosted directly from your S3 bucket with support for SPA routing, custom domains, and multi-platform deployment.

How It Works

Right-click a folder containing HTML files
Select "Create Site" from the context menu
A site.json config file is created in the folder
Preview your site instantly in the built-in iframe viewer
Deploy to Vercel, Cloudflare, or Storj Linkshare

Site Configuration

Sites are configured via a site.json file at the folder root:

{
  "name": "My Portfolio",
  "domains": ["portfolio.example.com"],
  "root": ".",
  "spa": false,
  "cache": {
    "html": "no-cache",
    "assets": "max-age=31536000"
  },
  "headers": {},
  "redirects": [],
  "deploymentTargets": []
}

Field	Description
`name`	Display name for the site
`domains`	Custom domain mappings
`root`	Root directory relative to the folder
`spa`	Enable SPA mode (routes all paths to index.html)
`cache`	Cache-Control headers for HTML and assets
`headers`	Custom response headers by path pattern
`redirects`	URL redirect rules
`deploymentTargets`	Deployment platform configs

Routing

The site router resolves paths in order:

Exact file match (/about → /about)
HTML suffix (/about → /about.html)
Index file (/about → /about/index.html)
SPA fallback (if enabled, all paths → /index.html)
404 page (/404.html)

Deployment Targets

Platform	Status
Vercel	Supported — auto-deploy from bucket
Cloudflare Pages	Supported
Storj Linkshare	Supported — native S3 hosting
Self-hosted	Supported — any static server

View Modes

The site panel supports three modes:

View — Live iframe preview with navigation
Edit — Code editor for site files
Settings — Edit site.json configuration

Detection

BucketDrive automatically detects site-capable folders by looking for:

index.html at the folder root
An existing site.json config
Common web project structures

Detected sites show a globe icon and teal color badge in the file browser.