# Static Deploy

> Deploy static file sites — Caddy/nginx serving, Staticfile config, and Dockerfile patterns. Use when deploying a static HTML site with no server-side runtime, or when index.html or a Staticfile is detected at the project root.

- Skill: `nixopus/static-deploy` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nixopus/static-deploy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nixopus/static-deploy/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: nixopus (https://skillmd.com/u/nixopus)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nixopus/static-deploy

---


# Static Files Deployment

## Detection

Project is static if:

1. `index.html` exists in the root
2. Or `Staticfile` exists at the project root (explicit configuration)

## Configuration

### Root Directory

1. `Staticfile` contents: `root: <dir>`
2. Default: current directory (`.`)

### Staticfile

Create a `Staticfile` at the project root:

```
root: dist
```

### Custom Caddyfile

Place a `Caddyfile` at the project root to override the default Caddy configuration.

## Typical Layouts

| Layout | Root to serve |
|---|---|
| Built SPA (Vite, etc.) | `dist` |
| Jekyll / Hugo output | `_site` or `public` |
| Plain HTML | `.` (current dir) |
| Nested | Configure via Staticfile |

## Dockerfile Patterns

### Nginx

```dockerfile
FROM nginx:alpine
COPY . /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]
```

### Caddy

```dockerfile
FROM caddy:alpine
COPY . /srv
EXPOSE 80
CMD ["caddy", "run", "--config", "/etc/caddy/Caddyfile"]
```

### With custom Caddyfile

```dockerfile
FROM caddy:alpine
COPY Caddyfile /etc/caddy/Caddyfile
COPY dist /srv
EXPOSE 80
CMD ["caddy", "run", "--config", "/etc/caddy/Caddyfile"]
```