What is the root of the project?

Understand the project root (base directory) so Discloud can detect configs, dependencies and your main file correctly.

🧾 Overview

The project root ("root directory") is the top-level folder of your application, the place you compress and upload to Discloud. It contains the configuration file (discloud.config), dependency manifest (e.g. package.json, requirements.txt, Cargo.toml, Gemfile), optional .env, and the folders with your source code (e.g. src/).

If the structure is wrong (for example, you zip a folder that contains another single folder that actually holds the files), Discloud may fail to detect the main file or dependencies.

---

🖼️ Visual Example

The green zone represents the root you should compress. Yellow shows a nested folder containing code files. Everything inside green is included once you zip that directory.

---

🚫 Common Mistakes

Mistake	Result	Fix
Zipping parent of actual root	Missing config / main file	Zip the folder containing discloud.config directly
Including node_modules	Large upload, possible size issues	Remove; let Discloud install
Hardcoding tokens in code	Security exposure	Use .env and environment variables
Multiple entry files ambiguous	Startup failure	Define MAIN in discloud.config explicitly