Skill1.4k repo starsupdated 27d ago

static-deploy

Static-deploy provides Caddy and nginx configuration patterns for serving static HTML sites without server-side runtimes. Use this skill when deploying projects with an index.html file or Staticfile at the root, including built single-page applications, static site generator output, or plain HTML directories.

View source Repository: nixopus

Install in Claude Code

Copy

git clone --depth 1 https://github.com/nixopus/nixopus /tmp/static-deploy && cp -r /tmp/static-deploy/api/skills/static-deploy ~/.claude/skills/static-deploy

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# 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"]
```