ToolsCommandsThe jadpo command
jadpo new
On this page
Start a project.
Write a new project into a folder that doesn't exist yet or is empty: app.jadpo on this jadpo's release line, config.jadpo, the domains/, database/ and tests/ folders, and one small domain with a route, the action it runs, its line in policy.jadpo, its API record and a route test. It passes jadpo check, jadpo fmt --check and jadpo test as written. Beside them: an AGENTS.md saying what Jadpo is and where its docs are, a .gitignore keeping build/ out of git, and a .gitattributes keeping record diffs readable. A folder that holds anything is refused, and nothing in it is changed.
jadpo new <name>Arguments
name: The project's folder, made if it doesn't exist
On every command
--json: Print data for tools instead of text--full: Show everything a report shortens--help: Show every flag, with examples--color <when>: Choose when to use colour
jadpo new --json writes one JSON document to standard output instead of text, with the same exit code. The document has schemaVersion, command ("new"), ok, data (what the command produced, null when it failed) and diagnostics (each error with its rule, reason, next and help). A command that needs a terminal refuses --json and names the flags that do the same job.
Examples
# Start a project in a new folderjadpo new my-app# Start one in the empty folder you're injadpo new .
Errors
cli.new_arguments: Ajadpo newcommand names no project, or more than onetoolchain.scaffold_destination_exists: You ranjadpo neworjadpo package newwith the name of a file that already existstoolchain.scaffold_destination_not_empty: You ranjadpo neworjadpo package newon a folder that already has files in it, hidden files includedtoolchain.scaffold_name_invalid: You ranjadpo newwith a path that doesn't end in a folder's name, such as..or/toolchain.scaffold_read_failed: You ranjadpo neworjadpo package newon a path Jadpo can't look into, such as a folder you can't read or a path through a filetoolchain.scaffold_write_failed: You ranjadpo neworjadpo package new, and writing its files failed, usually because the folder they go in can't be written
Markdown for agents: /docs/jadpo-new.md.Built from Jadpo main at aee2e8f.