A static export is a deterministic public site. It contains no live catalog server and no write path.
If the index is stale, rebuild it:
nicos-catalog reindexSelect the public visibility boundary and output directory:
nicos-catalog export explorer \
--out ./public-catalog \
--visibility public \
--allow-hosts example.comServe the output with any static file server. The server must provide the
application fallback to index.html for client routes.
Use the hosting guide for the synthetic demo, Cloudflare Pages, and post-deploy checks.
The export contains these files:
index.html
_headers
assets/<content-hash>.js
assets/<content-hash>.css
data/manifest.json
data/entities.json
data/graph.json
data/health.json
data/search.json
data/manifest.json binds each data file to a SHA-256 digest. The browser
checks each digest before it uses the file.
The manifest has no time, local path, host name, user name, machine ID, or operator identity. Equal inputs and equal application assets produce equal output bytes.
_headers applies a restrictive security policy when Cloudflare Pages serves
the export. Cloudflare parses this control file and does not serve it as a
static asset. Another static host must apply equivalent response headers.
CAUTION: Select a new output directory or a prior Explorer output directory. The command refuses an unknown non-empty directory.
The command also refuses these targets:
- a filesystem root;
- a path that contains a symlink;
- a path inside the corpus, settings, cache, or sidecar directory;
- a prior output with an invalid ownership manifest.
The command builds a unique sibling temporary directory. It replaces a prior complete output only after the new output passes all checks.
An export on disk is not deployed. An uploaded export is not launched or adopted. Record each state from direct evidence.