Command Line Interface

StaticForge is primarily a CLI tool. This section details the complete command reference.

Contents

• Site Management - Rendering and deploying (site:*).
• Content Creation - Scaffolding new content (make:*).
• Auditing - Verifying site health (audit:*).
• System Commands - Utilities and debugging (feature:*).
• Dev Server and Live Reload - Local preview with site:devserver and --watch.

Related Commands

• site:init creates a new project, including a starter content/404.md.
• site:devserver serves public/ locally. Missing URLs get public/404.html with a real 404 status when that file exists. Options: --port/-p (default 8000), --host (default localhost), --watch (rebuild on changes and reload the browser), --allow-remote and --include-drafts (both only apply with --watch). See Dev Server and Live Reload.
• site:upload deploys over SFTP. Options: --url=<url> (override the site URL and rebuild), --input=<dir>, --test or --dry-run (list what would be uploaded and deleted without changing anything), --no-delete (never delete remote files), --force-delete (delete stale files even past the delete guard limit). If both delete flags are given, --no-delete wins. See Deploy Safety.
• make:htaccess prints an Apache .htaccess (add --write to save it to htaccess.txt, or --output=<file> to choose the name). It includes ErrorDocument 404 /404.html.
• audit:config warns if a 404 page exists but SITE_BASE_URL is not a full URL.
• audit:live checks that unknown URLs on the deployed site return 404 rather than a redirect or 200.

See 404 Pages for how these fit together.