File Handling

SSI file handling options

Copy Options

SSI’s copy step has several options for controlling how files are copied and verified. Built at 2026-06-08T20:58:34.

📦 Checksum Verification

Option: options = ["checksum"]

Verify file integrity using xxHash3 checksums. Detects copy failures and tampering.

Requires: A .xxh3 checksum file alongside the path.

⚡ Skip-by-Checksum

Option: options = ["skip-by-checksum"]

Skip copying files when the target already has a matching checksum. Can be 10–20× faster for unchanged files.

Use case: CI/CD caches, large binary assets.

🗂️ Flat Copy

Option: options = ["flat"]

Copy only top-level files from the source directory — subdirectories are skipped.

Use case: Deploying only the root files from a source tree.