feat(*): add launcher scripts for Windows, PowerShell, and macOS/Linux

Author: Nat1anWasTaken

start.bat

@@ -0,0 +1,54 @@
+@echo off
+setlocal ENABLEDELAYEDEXPANSION
+
+REM ------------------------------------------------------------
+REM  Lava • Launcher (Windows CMD)
+REM ------------------------------------------------------------
+REM  - Creates a local `plugins/` directory
+REM  - Checks for Docker availability
+REM  - Starts services via: docker compose up -d
+REM ------------------------------------------------------------
+
+cd /d "%~dp0"
+
+echo ^>^> Lava Launcher
+echo     Preparing your environment...
+echo.
+
+echo 1^) Ensure plugins directory
+mkdir "plugins" 2>nul
+echo   [OK] Created/verified: %~dp0plugins
+echo.
+
+echo 2^) Check Docker availability
+where docker >nul 2>&1
+if errorlevel 1 (
+  echo   [X] Docker not found on PATH.
+  echo       Install Docker: https://docs.docker.com/get-docker/
+  exit /b 1
+)
+for /f "usebackq tokens=*" %%v in (`docker --version 2^>nul`) do set DOCKER_VER=%%v
+if defined DOCKER_VER (
+  echo   [OK] Docker detected: !DOCKER_VER!
+) else (
+  echo   [OK] Docker detected.
+)
+echo.
+
+echo 3^) Start services
+echo     $ docker compose up -d
+docker compose up -d
+if errorlevel 1 (
+  echo.
+  echo   [X] Failed to start services with 'docker compose'.
+  echo       Ensure Docker Desktop is running and try again.
+  exit /b 1
+)
+
+echo.
+echo [OK] Services are starting in the background.
+echo     Helpful commands:
+echo       • View status:     docker compose ps
+echo       • Follow logs:     docker compose logs -f
+echo       • Stop services:   docker compose down
+exit /b 0

start.ps1

@@ -0,0 +1,54 @@
+# ------------------------------------------------------------
+#  Lava • Launcher (PowerShell)
+# ------------------------------------------------------------
+#  - Creates a local `plugins/` directory
+#  - Checks for Docker availability
+#  - Starts services via: docker compose up -d
+# ------------------------------------------------------------
+
+$ErrorActionPreference = 'Stop'
+
+if (-not $PSScriptRoot) {
+  $PSScriptRoot = Split-Path -Parent $MyInvocation.MyCommand.Path
+}
+Set-Location $PSScriptRoot
+
+Write-Host "▶ Lava Launcher" -ForegroundColor Cyan
+Write-Host "Preparing your environment…" -ForegroundColor DarkGray
+Write-Host
+
+Write-Host "1) Ensure plugins directory" -ForegroundColor White
+New-Item -ItemType Directory -Path (Join-Path $PSScriptRoot 'plugins') -Force | Out-Null
+Write-Host ("  ✓ Created/verified: {0}" -f (Join-Path $PSScriptRoot 'plugins')) -ForegroundColor Green
+Write-Host
+
+Write-Host "2) Check Docker availability" -ForegroundColor White
+$docker = Get-Command docker -ErrorAction SilentlyContinue
+if (-not $docker) {
+  Write-Host "  ✖ Docker not found on PATH." -ForegroundColor Red
+  Write-Host "  Install Docker: https://docs.docker.com/get-docker/" -ForegroundColor Yellow
+  exit 1
+}
+try {
+  $ver = (docker --version) 2>$null
+} catch { $ver = $null }
+if ($ver) { Write-Host "  ✓ Docker detected: $ver" -ForegroundColor Green } else { Write-Host "  ✓ Docker detected" -ForegroundColor Green }
+Write-Host
+
+Write-Host "3) Start services" -ForegroundColor White
+Write-Host "  $ docker compose up -d" -ForegroundColor DarkGray
+try {
+  docker compose up -d
+} catch {
+  Write-Host "`n  ✖ Failed to start services with 'docker compose'." -ForegroundColor Red
+  Write-Host "  Ensure Docker Desktop is running and try again." -ForegroundColor Yellow
+  exit 1
+}
+
+Write-Host
+Write-Host "✓ Services are starting in the background." -ForegroundColor Green
+Write-Host "Helpful commands:" -ForegroundColor DarkGray
+Write-Host "  • View status:     docker compose ps" -ForegroundColor Gray
+Write-Host "  • Follow logs:     docker compose logs -f" -ForegroundColor Gray
+Write-Host "  • Stop services:   docker compose down" -ForegroundColor Gray
+exit 0

start.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+# ------------------------------------------------------------
+#  Lava • Launcher (macOS/Linux)
+# ------------------------------------------------------------
+#  - Creates a local `plugins/` directory
+#  - Checks for Docker availability
+#  - Starts services via: docker compose up -d
+# ------------------------------------------------------------
+
+bold="\033[1m"; dim="\033[2m"; red="\033[31m"; green="\033[32m"; yellow="\033[33m"; cyan="\033[36m"; reset="\033[0m"
+
+script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$script_dir"
+
+echo -e "${bold}${cyan}▶ Lava Launcher${reset}"
+echo -e "${dim}Preparing your environment…${reset}\n"
+
+echo -e "${bold}1) Ensure plugins directory${reset}"
+mkdir -p "$script_dir/plugins"
+echo -e "${green}✓${reset} Created/verified: ${bold}$script_dir/plugins${reset}\n"
+
+echo -e "${bold}2) Check Docker availability${reset}"
+if ! command -v docker >/dev/null 2>&1; then
+  echo -e "${red}✖ Docker not found on PATH.${reset}"
+  echo -e "Install Docker: ${yellow}https://docs.docker.com/get-docker/${reset}"
+  exit 1
+fi
+echo -e "${green}✓${reset} Docker detected: $(docker --version | head -n1)\n"
+
+echo -e "${bold}3) Start services${reset}"
+echo -e "${dim}$ docker compose up -d${reset}"
+if ! docker compose up -d; then
+  echo -e "\n${red}✖ Failed to start services with 'docker compose'.${reset}"
+  echo -e "Ensure Docker Desktop is running and try again."
+  exit 1
+fi
+
+echo -e "\n${green}✓${reset} Services are starting in the background."
+echo -e "${dim}Helpful commands:${reset}"
+echo -e "  • View status:     ${bold}docker compose ps${reset}"
+echo -e "  • Follow logs:     ${bold}docker compose logs -f${reset}"
+echo -e "  • Stop services:   ${bold}docker compose down${reset}"
+
+exit 0