# Shared static area

This directory is served at `https://static.{domain}/`.

Packages that need to ship shared static files (logos,
reference YAML, vendor docs, etc.) should contribute
them via a `directories:` entry in their own
`service.yml`, targeting a namespaced subdirectory:

```yaml
directories:
  data/caddy-static/static/{pkg-slug}:
    description: Shared static assets for {pkg-slug}
    source: caddy-static-files
```

Then ship the files under `services/{your-service}/caddy-static-files/`
in the package source. The installer copies them into
`data/caddy-static/static/{pkg-slug}/` at install time,
and Caddy picks them up on the next request (no restart
needed).

Use your package slug as the subdirectory name so files
from different packages never collide.

This area is **public and unauthenticated** — never put
secrets, session-only data, or anything user-specific
here.