Itera

Technical setup (overview)

Legacy itera.yml file

For new projects, configure the Dev server command in Itera project setup or project settings. This is the default path and does not require a pull request that adds itera.yaml or itera.yml to your repo.

The dev server command is the command Itera runs during prototyping, for example:

npm run dev -- --host 0.0.0.0 --port 3000

The app must be reachable at 0.0.0.0:3000. Keep port 3000; custom dev server ports are not supported by the project-level setup.

Legacy compatibility

Existing projects can continue using itera.yaml or itera.yml when no project dev server command has been saved. Treat the file as a legacy or advanced compatibility path, not the setup path for new projects.

Legacy config files can still cover:

  • Project metadata
  • Dev server startup behavior for existing projects
  • Behavior in monorepos
  • Strict-mode enforcement options

For the full legacy field reference, supported keys, command resolution rules, and example files for monorepos and single-package apps, see:

Was this page helpful?