apso dev

Start the current Apso project with the development command for its language. The CLI reads .apsorc and .env, detects the framework and database type, and forwards shutdown signals to the child process.

Usage


apso dev
apso dev --docker
apso dev --docker --build
apso dev --docker --detach

Options

Option	Description	Default
`--docker`	Use Docker Compose instead of the native development command	`false`
`--build`	Rebuild containers before starting; requires `--docker`	`false`
`-d, --detach`	Run containers in the background; requires `--docker`	`false`

Native mode

apso dev uses the project language:

Language	Command selected by the CLI
TypeScript	`npm run dev`, falling back to `npm run start:dev`
Python	Python development server from the FastAPI template
Go	Go development server from the Gin template

The database mode comes from DATABASE_TYPE in .env. TypeScript projects can use pglite for an embedded local database or postgres for an external server.

Docker mode


apso dev --docker

Docker mode requires Docker, Docker Compose, and a docker-compose.yml file in the project root.

Troubleshooting

The CLI cannot identify the language

Add language to .apsorc:


{
  "version": 2,
  "language": "typescript"
}

TypeScript cannot find a dev script

Confirm package.json includes either dev or start:dev.

PostgreSQL connection refused

Start the configured database, use Docker mode, or set DATABASE_TYPE=pglite for local TypeScript development.