Core Commands — Aquilia Documentation
Comprehensive guide and documentation for Core Commands in the Aquilia framework. View API reference, examples, and implementation patterns.
CLI / Core Commands Core Commands Core lifecycle commands handle workspace bootstrap, module configurations, manifest validations, asset compilation, and server execution. aq init workspace Creates a new workspace structure. Generates the base workspace.py, the entrypoint module, and configuration folders. # Initialize standard API project aq init workspace billing-api --template=api # Initialize minimal workspace without examples aq init workspace core-service --minimal --yes Options Option Description ))} aq add module Generates a new self-contained module directory inside modules/, creating a default manifest.py, controller, models, and tests files. # Standard module scaffold aq add module auth # Custom route prefix and module dependency declarations aq add module payments --depends-on=users --depends-on=auth --route-prefix=/v2/pay Options Option Description ))} aq validate Parses workspace manifests statically, checking that dependency graphs are clear of cycles and routes do not overlap. # Validate entire workspace aq validate # Run validation and output details in JSON format aq validate --strict --json aq compile Compiles modular controllers, routers, contracts, and translations into a compiled directory of static `.surp` files. This is recommended before deploying to production. # Run compilation aq compile # Watch the workspace for edits and automatically recompile files aq compile --watch --output=dist/ aq run Starts the development server. By default, it auto-detects ports from workspace.py, enabling hot reloading. # Start server on local defaults aq run # Bind custom host/port and disable pre-flight checks aq run --port=8080 --host=0.0.0.0 --skip-checks Options Option Description ))} aq serve Starts the production ASGI server. Recommended to wrap in Gunicorn using Uvicorn worker threads to manage concurrency. # Simple serve aq serve # Production gunicorn setup with 4 workers and custom bindings aq serve --use-gunicorn --workers=4 --bind=127.0.0.1:9000 --timeout=60 aq manifest update Synchronizes a module manifest by searching the folder structure for untracked controller classes or model definitions. # Sync payments module manifest aq manifest update payments # Perform dry-run sync check (useful in CI scripts) aq manifest update orders --check aq doctor Performs deep diagnostics on your active workspace setup. It validates imports, database adapters, cache connections, and environment files, reporting details in clean stdout or JSON format. # Run diagnostic check aq doctor # Export diagnostic logs as JSON aq doctor --json )
Go to Homepage