Project

🚀Project

Active

Let Custy detect the project source, or select an explicit source directory.

Command[tool.custy.project]

📦Category

Configuration

🚀Quick Command

project_source = "auto"

---

source discoverypath validationproject root

---

⚙️

Table

tool.custy.project

📋

Properties

1

📁

Generated Default

auto

✅

Status

Active

Properties

📋Properties

Property	Type	Description	Default	Required
project_source	Path string or auto	Use auto for runtime discovery, or set an explicit directory relative to the project root. Explicit paths must exist and must be directories.	auto	No

Examples

Automatic detection (recommended)

toml

[tool.custy.project]
project_source = "auto"

Explicit layouts

toml

[tool.custy.project]
project_source = "src"

# Other valid paths can include:

# project_source = "backend"

# project_source = "services/api"

ℹ️Automatic source selection

For Python markers, Custy prefers app/, then src/. For Node.js and generic repositories, it prefers src/, then app/. If neither directory exists, the project root is valid. Detection occurs at command runtime, so a Docusaurus, React, PHP, or other repository does not need an app/ directory just to start Custy.

⚠️Explicit paths remain strict

An explicit value is an intentional override. Custy reports a configuration error if that path is missing or is not a directory. Switch back to auto or correct the path instead of creating a placeholder app/ directory.

Continue

🚀Related Commands

Commands commonly used together with this command.

CLI Paths

Configure the version-file path separately from the source root.

Validate

Check project resources before consequential commands.