github.com/cartesiancs/landlink @main

Visit Website · Get Module I · Hardware Setup · FAQ · Report Bugs · Get iOS App

What is Landlink?

Landlink is off-grid communication software.

It lets phones talk to each other over LoRa when there is no cell tower, no Wi-Fi, and no internet.

Demo

https://github.com/user-attachments/assets/cd215b75-7e53-492d-968e-884c31c08897

Quick start

Web app (development)

npm install
npm run dev          # Vite dev server
npm run build        # tsc -b && vite build
npm run lint         # ESLint flat config
npm run test         # Vitest

iOS app

npm run build && npx cap sync ios
# then open ios/App in Xcode and run on a device (Bluetooth requires hardware)

Firmware (Module I)

pio --version
cd firmware
python3 tools/gen_protocol.py                 # regenerate protocol headers from YAML
pio run -e ttgo-t-beam-sx1262                 # build
pio run -e ttgo-t-beam-sx1262 -t upload       # flash
pio device monitor -e ttgo-t-beam-sx1262      # serial logs

See firmware/README.md for the full bring-up order, OTA signing flow, and milestone status.

Contributing

Issues and PRs are welcome. Before opening a PR:

1. npm run lint and npm run build both pass with zero errors.
2. New code respects the FSD layer boundaries enforced in eslint.config.js.
3. Firmware changes are flashable to a T-Beam V1.1 and don't regress the bring-up order in firmware/README.md.

Contributors

H. Jun Huh (GitHub)

License

See LICENSE.