Start Aurora Native runtime foundation

2026-08-22 02:55:04 -05:00
parent 8b23e5f590
commit 854ae3a2ad
7 changed files with 138 additions and 0 deletions
@@ -0,0 +1,26 @@
+# Aurora Native Runtime
+
+Aurora Native is a per-platform PHP development engine that does not require Docker. The existing container engine remains supported while native runtime bundles are developed and verified.
+
+## Runtime targets
+
+- Linux: x64 and arm64
+- macOS: Intel and Apple silicon
+- Windows: x64, with arm64 evaluated after the first stable runtime
+
+Each signed runtime bundle contains a `runtime.json` manifest plus versioned executables for PHP, web servers, databases, Node.js, and application tooling. Bundles install below Aurora's user-data directory and never modify system PHP or database installations.
+
+## Isolation model
+
+Every project receives reserved loopback ports, generated service configuration, isolated database data, logs, PID files, and environment variables below `.aurora/native`. A shared Aurora router owns friendly HTTPS project hostnames. Project files remain directly accessible on the host.
+
+## Delivery sequence
+
+1. Runtime manifest, platform detection, checksum verification, and engine abstraction.
+2. Native process supervisor and loopback port allocator.
+3. Linux x64 bundle with PHP 8.4, nginx, and MariaDB 11.8.
+4. WordPress provisioning, lifecycle, logs, database import/export, and Adminer.
+5. macOS arm64/x64 and Windows x64 bundles.
+6. Additional PHP/database versions, Apache, Drupal, Node.js, and developer services.
+
+Native project creation must stay disabled until the platform bundle passes executable, service-health, database, routing, and cleanup checks. Existing projects default to the container engine for backward compatibility.