First working version of desktop emulator with game launcher support. Includes local stubs and launcher logic.

emulator/README.md

@@ -0,0 +1,25 @@
+# Emulator for basic1 Game Logic
+
+This folder contains a desktop emulator for the basic1 game, using the same game logic and rendering libraries as the embedded version. The emulator uses SFML for graphics and input, allowing you to test and develop the game on your computer.
+
+## Features
+- Uses the same game logic and rendering code as the embedded firmware
+- Emulates touch with mouse clicks
+- Emulates hardware buttons with keyboard keys
+- Runs as a native desktop application (no Pico SDK required)
+
+## Build Instructions
+1. Install SFML (https://www.sfml-dev.org/)
+2. Run `cmake . && make` in this directory
+3. Run `./basic1_emulator`
+
+## Input Mapping
+- Mouse click: Emulates touch
+- Arrow keys, space, enter: Emulate hardware buttons
+
+## Extending
+- Add new features or overlays for debugging
+- Update input mapping as needed
+
+---
+This emulator is independent from the embedded build system.