bv lib install themes   # Installs Bootswatch themes and switcher components
bv lib install icons    # Installs Bootstrap Icons fonts and stylesheets
bv lib install ui       # Installs the complete BlaiseUI component suite
bv lib install mobile   # Installs Ionic mobile components and Pascal controllers
bv lib install charts   # Installs Chart.js data visualization suite

# === Development & Frontend Build ===
bv dev                     # Builds project in development mode & launches dev server with HMR on http://localhost:8080
bv build                   # Compiles frontend in development/debug mode (Lazarus & watchers)
bv build --release         # Builds optimized production bundle with hashes in dist/
bv preview                 # Local HTTP preview of production build (port 5000)
bv clean                   # Cleans generated files (generated/ and dist/)

# === Scaffolding & Generators ===
bv create <app-name>       # Scaffolds a project with 4-tier testing hierarchy & domain services
bv new c <Name>            # Scaffolds a component (.bv) & test in tests/components/ (alias: bv g c)
bv new v <Name>            # Scaffolds a route view (.bv) & test in tests/views/ (alias: bv g v)
bv new s <Name>            # Scaffolds a domain service & test in tests/services/ (alias: bv g s)
bv new t <Name>            # Scaffolds a Pascal test file (smart detection: c, v, services) (alias: bv g t)
bv remove <c|v|s|t|m|d> [Name] # Safely deletes a component, view, service, test, or platform (m/d)
bv list <c|v|s|t|lib>      # Lists project components, views, services, tests, or installed libs
bv rename <c|v|s|p>        # Smart rename for services, components, views, or project name

# === Package Repositories & Ecosystem ===
bv repo list               # Lists registered package repositories (default: official ecosystem)
bv repo add <name> <url>   # Registers an external ecosystem or repository
bv repo remove <name>      # Removes a registered repository
bv repo default <name>     # Sets the default repository
bv repo sync               # Synchronizes and caches ecosystem package catalog
bv repo search <term>      # Searches packages across registered ecosystems

# === Package & Theme Management ===
bv lib install [<repo>:]<pkg[@ver]> # Installs package in project /lib (e.g. bv lib install test@1.0.0 or official:test)
bv lib install <pkg> -g    # Installs package in global user cache (~/.blaisevue/packages/)
bv lib remove <name>       # Removes installed package from lib/
bv lib update [[<repo>:]name] # Updates library/libraries to latest version
bv lib outdated [--global] # Checks for available updates in installed packages
bv lib list [--global]     # Lists installed libraries (project /lib or user global cache)
bv lib search [[<repo>:]term] # Searches packages in registered repositories
bv lib pack [dir]          # Assembles & verifies release artifact (.zip with SHA-256)
bv theme [list]            # Displays active configuration and available themes in @blaise-themes
bv theme add <name>        # Adds theme to package.json for optimized tree-shaken bundling
bv theme remove <name>     # Removes theme from package.json
bv theme use <name>        # Sets active default theme in package.json & index.html
bv theme reset             # Resets theme filters (bundles all themes in compatibility mode)

# === Extensions & Developer Tools ===
bv extension list          # Lists installed and available extensions (VS Code, DevTools, custom)
bv extension install [ext] # Installs development extension (e.g. vscode, devtools, or custom)
bv extension remove [ext]  # Uninstalls development extension
bv extension pack [ext]    # Packages extension into production artifact (.vsix)

# === Project Metadata & Licensing ===
bv license [list|show|set] # Manages project licenses (MIT, Apache, LGPL, GPL, BSD, Commercial)
bv meta [show|get|set|bump]# Manages metadata & synchronizes SemVer with src/uAppVersion.pas
bv reset [--bare] [--force]# Resets demo project to a clean slate (protected against demo-app)

# === Mobile (Android & iOS via Capacitor) ===
bv mobile init [name] [id] # Scaffolds Capacitor & mobile/ native project (name & id optional)
bv mobile sync             # Syncs dist/ with native mobile assets
bv mobile remove [-y]      # Safely deletes mobile/ and capacitor.config.json (alias: bv remove mobile)
bv mobile build android    # Builds native Android Debug APK in mobile/bin/android/
bv mobile build android --release # Builds optimized Release APK (R8/ProGuard)
bv mobile emulator list    # Lists installed Android Virtual Devices (AVD)
bv mobile emulator start   # Boots Android emulator in background
bv mobile run android      # Installs and launches APK on connected USB device
bv mobile run android --emulator # Boots emulator, installs APK, and runs app
bv mobile open android     # Opens project in Android Studio

# === Desktop (Free Pascal, Lazarus IDE & WebUI) ===
bv desktop init [name]     # Scaffolds Lazarus (.lpi, .lpr) & WebUI project
bv desktop sync            # Syncs dist/ to desktop/assets/
bv desktop remove [-y]     # Safely deletes desktop/ native project (alias: bv remove desktop)
bv desktop build [target]  # Compiles Debug native binary (live console logging)
bv desktop build [target] --release # Compiles Release native binary (pure GUI - NO console)
bv desktop run [target]    # Launches desktop app in Debug mode (with console)
bv desktop run [target] --release # Launches desktop app in Release mode (clean GUI)

# === Backend & Full-Stack (Synopse mORMot 2) ===
bv create <name> --mormot  # Scaffolds full-stack app with mORMot 2 native backend (--fullstack / -m)
bv mormot init             # Scaffolds mORMot 2 backend server in server/
bv mormot build            # Compiles Debug native server with Free Pascal
bv mormot build --release  # Compiles optimized Release native server (-O3, stripped)
bv mormot run              # Starts native backend server (auto-fallback to 8091 if 8090 is busy)
bv mormot kill             # Terminates lingering server.exe instances and releases ports
bv mormot status           # Queries /api/status health endpoint (with 2s fast timeout)
bv mormot deploy           # Packages standalone production bundle in deploy/
bv mormot deploy --zip     # Packages standalone bundle into deploy.zip
bv mormot rpc              # Scaffolds type-safe Pascal RPC client proxies from mORMot 2 SOA interfaces

# === Testing ===
bv test                    # Compiles .test.pas files and runs Vitest suite

# === Framework Diagnostics & Git Auto-Updater ===
bv doctor                  # Diagnoses environment tools (Git, Lazarus & FPC, InstantFPC, Python 3, Pas2JS, Node.js)
bv self-update             # Synchronizes & recompiles BlaiseVue engine directly from GitHub via Git
bv self-update --check     # Checks for remote updates without downloading
bv channel                 # Inspects active channel (* main [stable] or develop [dev])
bv channel use <name>      # Switches between stable release (main) and development (develop)

# === Compiler Search Paths & Legacy Migration ===
bv path                         # Lists all active search paths (-Fu) categorized by type
bv path add <dir|pas2js:pkg>    # Adds directory or built-in Pas2JS package to app.cfg
bv path remove <target>         # Removes search path from app.cfg
bv path available               # Catalogs 30+ official Pas2JS packages with active indicator

# === Cockpit & Multi-Project Management ===
bv update                  # Surgically syncs project infrastructure with latest framework features
bv update --dry-run        # Previews updates without modifying any files (non-destructive safety)
bv enter                   # Enters interactive project Cockpit shell (e.g. [bv: my-app] >)
bv use <project-name>      # Jumps into registered project Cockpit shell from anywhere
bv project add             # Registers current project into global registry (~/.blaisevue/projects.json)
bv project list            # Lists registered projects (* active)
bv project current         # Shows currently active project details
bv project remove <name>   # Unregisters project from global registry
bv rename <s|c|v|p> <New>  # Smart rename for services, components, views, or project name

BlaiseVue/
├── bin/                       # BlaiseVue CLI compiler & dev server (bv.pas, bv.exe)
├── core/                      # Core runtime engine
│   ├── BlaiseVue.pas          # Core SPA instance orchestrator & Hydration
│   ├── BVCompiler.pas         # Template engine, directives, AST parser
│   ├── BVReactivity.pas       # Reactive proxy & dependency tracking
│   ├── BVRouting.pas          # SPA Router & HTML5 History API
│   ├── BVValidation.pas       # Reactive form validation engine (b-validate)
│   ├── BVI18n.pas             # Internationalization engine ($t)
│   ├── BVTheme.pas            # Theme switcher & persistence engine ($theme)
│   ├── BVWasm.pas             # WebAssembly acceleration engine ($wasm)
│   ├── BVStore.pas            # Centralized state management ($store)
│   ├── BVClient.pas           # REST ($api) & WebSocket ($ws) client helpers
├── templates/                 # Scaffolding templates
│   ├── fullstack-mormot/      # High-performance mORMot 2 server template
│   └── BVDevTools.pas         # Bridge to browser DevTools extension (v3.0)
├── packages/                  # Modular package ecosystem & developer tools
│   ├── core/                  # Official core framework packages
│   │   ├── blaise-ui/         # 25+ native UI components & styles
│   │   ├── blaise-themes/     # 9 Bootswatch themes & theme switchers
│   │   ├── blaise-icons/      # Bootstrap Icons fonts & stylesheet
│   │   ├── blaise-charts/     # Reactive Chart.js visualization & Pascal wrappers
│   │   ├── blaise-reports/    # Declarative PDF reports generation engine
│   │   ├── blaise-studio/     # Developer cockpit & visual AST inspector
│   │   └── blaise-ui-mobile/  # Mobile-first Ionic components & Pascal wrappers
│   └── tools/                 # Development extensions & tooling
│       ├── blaise-devtools/   # Browser DevTools extension (Chrome, Firefox, Edge)
│       ├── blaise-vscode/     # Official VS Code extension (.vsix packaging & snippets)
│       └── blaise-lazarus/    # Official Lazarus IDE package (.lpk, .bv multi-syntax, wizards)
├── vendor/                    # Embedded compiler & backend engines
│   ├── pas2js/                # Multi-platform pas2js transpiler & RTL
│   └── mormot2/               # High-throughput Synopse mORMot 2.4 framework
├── doc/
│   ├── Architecture/          # Core compiler pipeline & framework internals
│   ├── Documentation/         # 53 comprehensive technical manuals + API Reference
│   └── Course/                # 13-module practical course from beginner to ninja
└── demo-app/                  # Enterprise showcase application (v3.0)

# Clone official stable release channel (main):
git clone https://github.com/affonsoelias/BlaiseVue.git
cd BlaiseVue

# Or clone the active development channel (develop):
git clone -b develop https://github.com/affonsoelias/BlaiseVue.git
cd BlaiseVue

chmod +x bin/bv vendor/pas2js/pas2js-*/bin/{pas2js,compileserver,makestub,webidl2pas} 2>/dev/null || true

# Add to ~/.zshrc (if using Zsh, e.g. Manjaro/macOS) or ~/.bashrc (if using Bash):
export PATH="$HOME/BlaiseVue/bin:$PATH"

# Reload your active shell (use ~/.zshrc in Zsh or ~/.bashrc in Bash):
source ~/.zshrc   # or: source ~/.bashrc

bv doctor          # or .\bin\bv.exe doctor on Windows

cd bin
fpc -O2 bv.pas
# Move bv or bv.exe to your PATH or use directly from bin/

cd demo-app
bv dev             # or ..\bin\bv.exe dev on Windows
# Open http://localhost:8080 in your browser