Stratolink

stratolink.org

An open source pico balloon network. This repository contains the payload hardware, firmware, website, and flight models. Follow the docs to build a payload, prepare a balloon, and register it on the dashboard.

Repository

hardware/    KiCad schematics, PCB layouts, component libraries, and assembly files
firmware/    STM32WLE5 firmware, PlatformIO configuration, and host tests
web/         Website, public docs, dashboard, APIs, and forecast worker
supabase/    Database migrations and permission checks
simulation/  Balloon trajectories, buoyancy, and fleet coverage models
analysis/    Antenna, radio, power, and flight studies; bench diagnostics
docs/        Engineering notes for flight qualification and forecasting
scripts/     Sticker layout tool
assets/      Original project artwork and simulation media

Firmware

Install PlatformIO. From the repository root:

cd firmware
cp include/secrets.h.example include/secrets.h

Fill in your regional TTN credentials, then build the flight environment:

pio run -e stratolink

Upload through J-Link over SWD:

pio run -e stratolink --target upload

Use the firmware revision that matches your board. Hardware setup covers assembly and programming; firmware/README.md covers configuration and host checks.

Website

Use Node 22. From the repository root:

cd web
cp .env.example .env.local
ONNXRUNTIME_NODE_INSTALL=skip npm ci
npm run dev

Set the values in .env.local as described in web/README.md. Run npm run verify before submitting website changes. Deployment and backend setup are documented there.

---

• Fork this repository
• Watch this repo
• Create issue