Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GeaStack tutorials

Step-by-step courses that build GeaStack applications — from a first "hello" to a native HTTP server and a custom ESP32-S3 board.

Every tutorial is a named folder whose numbered subfolders are its progressive steps, and each step is a complete project snapshot. You can run any step as it stands, or diff one against the next to see exactly what changed.

Learning paths

Compile Node and server applications into native executables.

  1. Build a native Hono todo API — start with Hello World, introduce types and modules, build a Hono API, then add MongoDB persistence.

Build, flash and update a Gea app on hardware.

  1. Build an ESP32-S3 AMOLED app — create a touchscreen counter, extract its state into a store, install the next build over Bluetooth, and make a network request.
  2. Compose a custom board target — install each runtime and toolchain package explicitly, then use the CLI to assemble an app-local ESP32-S3 target from chips and GPIO assignments.

What you need

Node.js 22 or newer and npm. The embedded path also needs an ESP32-S3 board. npx gea doctor checks the toolchains for whichever target you pick and names anything that is missing.

Each tutorial installs the compiler into its own project snapshot, so the compiler version is recorded in that step's package.json and everyone working through it builds with the same one.

License

MIT (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.

About

GeaStack and geatsc tutorials: ESP32 apps, custom boards, native HTTP services.

Topics

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages