Static Files

Files in static/ are copied to the output root as-is. No template rendering, no fingerprinting, no transformation.

static/
  favicon.ico          -> _site/favicon.ico
  robots.txt           -> _site/robots.txt
  images/
    logo.png           -> _site/images/logo.png
  downloads/
    whitepaper.pdf     -> _site/downloads/whitepaper.pdf

Use static/ for files that must appear at exact paths: favicons, robots.txt, verification files, and downloadable assets.

Custom Directory

Override the default static directory in your config:

structure:
  static: "./docs/static/"

The path is relative to the project root.

Build vs Dev Mode

alloy build: static files are copied to _site/.

alloy dev and alloy serve: static files are copied to _site/ during the initial build. The file watcher monitors the static directory and recopies modified files.