build

SuCoS build compiles your site and writes all output files to the public/ directory (or a custom path). Use this command to generate the files you'll deploy to your hosting provider.

Usage

SuCoS build [options]

Options

Option Short Default Description
--source <path> -s ./ Site source directory
--output <path> -o ./public Output directory
--draft -d off Include draft pages
--future -f off Include future-dated pages
--expired -e off Include expired pages
--verbose -v off Verbose logging

Examples

# Standard build (source: ./, output: ./public)
SuCoS build

# Custom source and output
SuCoS build --source ./my-site --output ./dist

# Build including drafts and future content
SuCoS build --draft --future

# Verbose build for debugging
SuCoS build --verbose

Output

After a successful build, public/ contains your complete static site:

public/
├── index.html
├── sitemap.xml
├── blog/
│   ├── index.html
│   ├── index.xml        ← RSS feed
│   └── my-post/
│       └── index.html
└── static assets...

Deploy the entire public/ directory to any static host.

Content filtering

By default, sucos build only includes pages where:

  • Draft is not true
  • Date is in the past or present
  • ExpiryDate is in the future (or not set)

Use --draft, --future, and --expired to override each rule individually.

Quick Start