GeaStack Linux

Native Linux desktop target support for GeaStack.

This repo contains the targets that let Gea applications run as native Linux desktop apps. Apps render through the shared gea framework raster pipeline (RGB565 canvas → dirty-rect SDL2 texture upload) into a resizable desktop window, with mouse, touchscreen (multi-touch), keyboard, and scroll-wheel input mapped onto the framework input pipelines, plus persistent localStorage (file-backed) and HTTP(S) fetch (libcurl). The current focus is Raspberry Pi OS on the Raspberry Pi 5; other distros can be added as sibling targets.

What Is Here

Path	Purpose
targets/raspberry-pi-os	Raspberry Pi OS (Bookworm+ desktop, labwc/Wayland) SDL2 target: platform sources, build script, and target docs.

Quick Start

Build and run an app:

targets/raspberry-pi-os/build-raspberry-pi-os.sh bouncing-balls-jsx
./targets/raspberry-pi-os/dist/bouncing-balls-jsx/bouncing-balls-jsx

Click and drag with the mouse (it acts as the touch finger); the wheel scrolls; the keyboard types into focused inputs; F11 toggles fullscreen; Esc or closing the window quits. See targets/raspberry-pi-os/README.md for window size/scale/DPR/storage knobs and target architecture.

Dependencies

• build-essential, libsdl2-dev, libcurl4-openssl-dev, nodejs, npm (Debian/Raspberry Pi OS packages).
• The rest of the stack from npm: npm install brings in @geastack/core and @geastack/compiler, which carry the codegen toolchain (vite + the @geajs packages).

How This Fits The Stack

Linux targets consume compiled Gea apps and present the framework's software raster through a desktop window system. This repo is the Linux platform adapter layer. It owns the SDL2 display/input glue, the Linux storage/network backends, and Linux-specific target build scripts.

Maintenance Notes

• Framework sources and include roots come from the shared manifest core/gea_sources.sh — never hardcode framework source lists in target build scripts.
• Keep the target platform files thin: platform glue implementing the gea::platform::* / StorageService / fetch-seam surfaces. Behavior belongs in the shared framework packages.
• This target excludes core's runtime.cpp and runs its own frame loop, so the per-frame plumbing runtime.cpp normally does (key/rotary input drains, Storage.load()/flushPending()) is replicated in rpios_main.cpp — if runtime.cpp grows new per-frame duties, mirror them there.
• When adding target behavior, update the target README in the same change.

License

Apache-2.0 (see LICENSE). You can ship closed-source products built on it. The only GeaStack code under a different license is the embedded board support (targets and @geastack/chips, GPL-3.0-only): shipping closed-source firmware through those needs a commercial license. Contact contact@geastack.com for commercial terms, support and hosted builds.