Consolidate build system with unified build.sh script

- Add build.sh: single script for all platform builds
- All outputs now go to unified dist/ directory
- Remove redundant build scripts and Windows distribution folders
- Update documentation to reflect simplified build process
- Clean up .gitignore to exclude temporary scripts
- Maintain single source of truth for distribution binaries

Author: pedgarcia

.gitignore

@@ -10,8 +10,13 @@ build-cross-windows/
 build-windows/
 build-linux/
 build-package/
+
+# Distribution output directory (all platforms)
 dist/
+
+# Legacy distribution directories (to be removed)
 windows-release/
+windows-release-led-fixed/
 
 # Qt generated files
 *.pro.user
@@ -65,6 +70,15 @@ Desktop.ini
 *.tmp
 *.temp
 
+# Temporary build scripts (to be removed after consolidation)
+cleanup-and-finalize-windows.sh
+create-fixed-release.sh
+create-windows-release-with-fixes.sh
+manual-rebuild.sh
+rebuild-windows-fixed.sh
+rebuild-windows-step-by-step.sh
+test-windows-fixes.sh
+
 # Test and development files
 *.log
 test_*.json

BUILD_INSTRUCTIONS.md

@@ -3,6 +3,7 @@
 This document provides comprehensive instructions for building Fujisan on all supported platforms.
 
 ## Table of Contents
+- [Quick Start - Unified Build Script](#quick-start---unified-build-script)
 - [Prerequisites](#prerequisites)
 - [macOS Builds](#macos-builds)
   - [Native Single-Architecture Build](#native-single-architecture-build)
@@ -13,6 +14,30 @@ This document provides comprehensive instructions for building Fujisan on all su
 - [Linux Build](#linux-build)
 - [Build Scripts Reference](#build-scripts-reference)
 
+## Quick Start - Unified Build Script
+
+The easiest way to build Fujisan for any platform:
+
+```bash
+# Build for specific platform
+./build.sh macos          # Both Intel and ARM64 DMGs
+./build.sh windows        # Windows ZIP package
+./build.sh linux          # Linux DEB and tarball
+./build.sh all            # All platforms
+
+# Options
+./build.sh macos --clean  # Clean build
+./build.sh all --version v1.2.0  # Specify version
+
+# All outputs go to dist/
+ls dist/
+# Fujisan-1.2.0-arm64.dmg
+# Fujisan-1.2.0-x86_64.dmg  
+# Fujisan-1.2.0-windows.zip
+# fujisan-1.2.0-linux-x64.tar.gz
+# fujisan_1.2.0_amd64.deb
+```
+
 ## Prerequisites
 
 ### All Platforms

CLAUDE.md

@@ -8,6 +8,25 @@ Fujisan is a modern Qt5-based frontend for the Atari800 emulator that provides a
 
 ## Build System and Common Commands
 
+### Unified Build Script (Recommended)
+```bash
+# Build for any platform using the unified script
+./build.sh [platform] [options]
+
+# Examples:
+./build.sh macos          # Build both Intel and ARM64 DMGs
+./build.sh windows        # Cross-compile for Windows
+./build.sh linux          # Build Linux packages with Docker/Podman
+./build.sh all --clean    # Build all platforms with clean
+
+# All outputs go to dist/ directory:
+# - Fujisan-{version}-arm64.dmg   (macOS Apple Silicon)
+# - Fujisan-{version}-x86_64.dmg  (macOS Intel)  
+# - Fujisan-{version}-windows.zip (Windows)
+# - fujisan-{version}-linux-x64.tar.gz (Linux)
+# - fujisan_{version}_amd64.deb   (Debian/Ubuntu)
+```
+
 ### Prerequisites Setup
 ```bash
 # Set required environment variable (needed for all build operations)
@@ -20,7 +39,7 @@ brew install qt@5 cmake autoconf automake
 sudo apt install qtbase5-dev cmake build-essential autoconf automake
 ```
 
-### Build Process
+### Manual Build Process
 ```bash
 # 1. Apply Fujisan patches to atari800 source
 cd fujisan/patches
@@ -51,7 +70,7 @@ Fujisan uses Git format-patch files for reliable patching:
 - Use `apply-patches.sh` which auto-detects Git repos and uses appropriate commands
 - Patches add essential libatari800 API functions for disk management and activity monitoring
 
-### macOS Universal Binary Build
+### macOS Platform-Specific Builds (Recommended)
 ```bash
 # Prerequisites: Install Qt5 for both architectures
 # ARM64 (Apple Silicon):
@@ -60,17 +79,21 @@ brew install qt@5
 # x86_64 (Intel) - requires Rosetta:
 arch -x86_64 /usr/local/bin/brew install qt@5
 
-# Build universal binary with universal Qt frameworks
-./scripts/build-universal-macos-complete.sh
+# Build separate DMGs for each platform (recommended approach)
+./scripts/build-macos-separate-dmgs.sh
 
 # Options:
 #   --clean       Clean build directories before starting
 #   --skip-arm64  Skip ARM64 build (use existing)
 #   --skip-x86_64 Skip x86_64 build (use existing)
-#   --sign        Sign the application (requires certificates)
+#   --skip-dmg    Skip DMG creation
 
-# Output: dist/Fujisan-{version}-universal.dmg
-# The DMG contains a universal app bundle that runs natively on both Intel and Apple Silicon Macs
+# Output: 
+#   dist/Fujisan-{version}-arm64.dmg  - For Apple Silicon Macs
+#   dist/Fujisan-{version}-x86_64.dmg - For Intel Macs
+
+# Note: Universal binaries with Qt are problematic due to framework
+# architecture incompatibilities. Platform-specific builds are more reliable.
 ```
 
 ### Windows Cross-Compilation (from macOS/Linux)
@@ -191,11 +214,10 @@ Fujisan includes comprehensive FujiNet-PC network connectivity:
 ### Platform-Specific Build Folders
 - **macOS**: 
   - `build/` - Native single-architecture build
-  - `build-arm64/` - ARM64 build for universal binary
-  - `build-x86_64/` - x86_64 build for universal binary
-  - `build-universal/` - Universal binary with both architectures
-  - `dist/` - Final DMG distribution files
-- **Windows**: `build-windows/` (cross-compiled release package with all DLLs)
+  - `build-arm64/` - ARM64 build for platform-specific DMG
+  - `build-x86_64/` - x86_64 build for platform-specific DMG
+  - `dist/` - Final distribution files for all platforms
+- **Windows**: `build-windows/` (temporary - gets zipped to dist/)
 - **Linux**: `build/` (native build)
 
 ### Windows Release Package Structure
@@ -216,9 +238,17 @@ build-windows/
 - `build/` - Native build directory
 - `build-arm64/` - macOS ARM64 build directory
 - `build-x86_64/` - macOS x86_64 build directory
-- `build-universal/` - macOS universal binary directory
 - `build-cross-windows/` - Windows cross-compilation temp directory
-- `build-windows/` - Windows release package
-- `dist/` - Distribution files (DMGs, etc.)
+- `build-windows/` - Windows release package (temporary)
+- `dist/` - All distribution files (DMGs, ZIPs, DEBs, tarballs)
 - `*.exe`, `*.dll` - Binary files
-- `*.dmg` - macOS disk images 
+
+## Distribution and Release Guidelines
+
+### Unified Distribution Management
+- **Single Distribution Directory**: All platform releases go to `dist/`
+- **Consistent Naming**: 
+  - macOS: `Fujisan-{version}-{arch}.dmg`
+  - Windows: `Fujisan-{version}-windows.zip`
+  - Linux: `fujisan-{version}-linux-x64.tar.gz`, `fujisan_{version}_amd64.deb`
+- **Build Script**: Use `./build.sh` for all platforms to maintain consistency