Troubleshooting

Common errors

Build failed: missing dependency

Error: Cannot find module 'some-package'

Fix: Make sure all dependencies are listed in package.json and committed to your repo. Cybrix runs npm install before building, but only installs packages listed in your manifest.

Build failed: wrong Node version

Error: The engine "node" is incompatible with this module.

Fix: Add a .nvmrc file to your repo with your target Node version (e.g., 22). Cybrix will use that version automatically.

Output directory not found

Error: Build output directory 'dist' not found.

Fix: Tell Cybrix which directory your build outputs to:

Deploy my project, the output goes to 'build' not 'dist'

Site deploys but shows old content

Cloudflare's edge cache may be serving a previous version. Wait 2–3 minutes for global propagation, or trigger a cache purge from your Cybrix dashboard.

File too large

Error: File size limit exceeded (50MB per file)

Fix: Binary files and large media should be hosted externally (Cloudflare R2, Cloudflare Stream, etc.) and referenced by URL. Static sites should not include large binaries in the build output.

Still stuck?

Email us at support@cybrix.cc with your project name and a copy of the error message. We usually respond within a few hours.