Introduzione
Cos'è JZ Companion, come funziona e da dove cominciare.
JZ Companion è un display da scrivania: uno schermo touch quadrato da 4 pollici (480×480, ESP32-S3) che mostra una schermata per volta, e ogni schermata è un widget per una cosa che controlli durante il lavoro. Le issue di Linear, le chat, il calendario, il timer, il meteo, la batteria delle periferiche, il canale vocale di Discord. Un tap fa l'azione, senza cambiare finestra sul computer.
La scheda disegna e basta. Chi parla con le API dei servizi è il cervello, un programma che gira sul tuo computer (o, in modalità standalone, la scheda stessa) e le manda messaggi binari compatti. In più la scheda è una tastiera USB e manda scorciatoie fisse, scritte nel firmware.
Le due modalità
| Cervellone | Standalone | |
|---|---|---|
| Dove sta il cervello | sul computer (l'app JZ Companion) | sulla scheda |
| Collegamento | cavo USB, Wi-Fi o Bluetooth verso il computer | Wi-Fi verso internet, poi accesso al portale |
| Chiavi dei servizi | gestore interno del cervello, cifrato sul computer | memoria cifrata della scheda, mandate dal portale cifrate con il codice a 6 cifre |
| Integrazioni | tutte | solo quelle via API, con i connettori dichiarativi |
| Tasti multimediali | sì | no |
Ogni widget dichiara cosa richiede: solo la scheda, un'API (un connettore) o il computer. L'elenco è nel catalogo dei widget.
Da dove cominciare
Installare l'app
Scarichi l'app, la apri e il configuratore è pronto.
Abbinare una scheda
Con il codice a 6 cifre o con il cavo USB.
Il configuratore
Widget, chiavi, registri, schede e telefoni.
Le integrazioni
Discord, Chat, Linear, Batterie e i connettori.
Sicurezza e privacy
Dove stanno le chiavi e cosa vede il cloud.
Il protocollo
I frame binari tra la scheda e il computer.
Come è fatto il progetto
- Il cervello sta sul computer, l'hardware visualizza. La logica pesante è nel cervello o, in standalone, in connettori leggeri sulla scheda.
- Meno dipendenze possibili. Si installa un file. Il cervello non ha dipendenze native.
- Local-first. Le chiavi restano sul computer o sulla scheda. Il cloud non le vede.
- Un design system. jz.land, ovunque: carta, inchiostro, terra.