Overview

This DDEV add-on installs shared host commands used by Cortier projects.

Commands

• ddev api: Connect to or run a command in an API surface.
• ddev app: Connect to or run a command in an app surface.
• ddev angular: Connect to or run a command in the legacy Angular surface.
• ddev admin: Connect to or run a command in an admin surface.
• ddev shop: Connect to or run a command in a shop surface.
• ddev launch: Open the current project’s local URL.
• ddev name: Print the DDEV project name without its final suffix.
• ddev path: Print the configured absolute path for a Cortier repository.
• ddev surface: Manage and use API, app, admin, and shop surface connections.
• ddev url: Print URLs from .ddev/config.host.local.yaml.

Requirements

The target project must contain .ddev/config.host.local.yaml. The surface command also requires jq when it reads DDEV metadata.

Configure repository paths in global Git configuration. For example:

git config --global cortier.paths.rules /absolute/path/to/rules
ddev path rules

Add --json-output to return the repository name and resolved path as JSON. Configured paths must identify the root of a standalone Git checkout, not a nested directory or submodule, and its origin must identify the matching cortier/<repository> repository.

API projects can connect to either one app or one legacy Angular frontend, plus one admin and one shop. Each frontend can connect to one API; app and Angular connections replace one another, and frontend-to-frontend connections are rejected. Connections are validated by project-name suffix, DDEV type, and reciprocal connection file.

Installation

Install the latest release:

ddev add-on get cortier/ddev-commands

Install the add-on from a local checkout:

ddev add-on get /path/to/ddev-commands

Run the installation command again to update the installed commands.