mid coding commit

image-recipe/README.md

@@ -1,23 +1,46 @@
-# StartOS Image Recipes
+# Archipelago OS Image Recipes
 
-Code and `debos` recipes that are used to create the StartOS live and installer
-images.
+Build scripts and profiles for creating bootable Alpine Linux OS images for Archipelago Bitcoin Node OS.
 
-If you want to build a local image in the exact same environment used to build
-official StartOS images, you can use the `run-local-build.sh` helper script:
+## Quick Start
+
+### On macOS
 
 ```bash
-# Prerequisites
-sudo apt-get install -y debspawn
-sudo mkdir -p /etc/debspawn/ && echo "AllowUnsafePermissions=true" | sudo tee /etc/debspawn/global.toml
-
-# Get dpkg
-mkdir -p overlays/startos/root
-wget -O overlays/startos/root/startos_0.3.x-1_amd64.deb <dpkg_url>
-
-# Build image
-./run-local-build.sh
+./build-macos.sh
 ```
 
-In order for the build to work properly, you will need debspawn >= 0.5.1, the
-build may fail with prior versions.
+### On Linux
+
+```bash
+./build-linux.sh
+```
+
+See [Building OS Images](../../docs/building-os-images.md) for detailed instructions.
+
+## What's Included
+
+- **Alpine Linux Base**: Minimal, secure Linux distribution
+- **Podman**: Container runtime for apps
+- **Archipelago Backend**: Rust-based API server
+- **Archipelago Frontend**: Vue.js web interface
+- **Systemd Services**: Automatic service management
+- **Network Configuration**: Ready for network setup
+
+## Build Output
+
+- `archipelago-{version}-x86_64.iso` - Bootable ISO image
+- `archipelago-{version}-x86_64.img` - Disk image for flashing
+
+## Supported Platforms
+
+- **x86_64**: Dell Optiplex, HP ProDesk 400 G4 DM, and other x86_64 desktops
+- **Build Systems**: macOS (via Docker) and Linux (native or Docker)
+
+## Legacy StartOS Build
+
+The original StartOS build scripts are still available:
+- `build.sh` - StartOS Debian-based image builder
+- `run-local-build.sh` - StartOS build helper
+
+See [Building OS Images](../../docs/building-os-images.md) for Archipelago-specific builds.