Aplikasi dan alat contoh untuk Gea Stack. Repo ini adalah galeri aplikasi yang digunakan oleh simulator, target tertanam, Gea OS, target Apple, ekstensi VS Code/Cursor, dan demo pemasaran. Setiap contoh adalah paket kecil dengan manifes gea di package.json.

Apa yang Ada di Sini: apps/* Aplikasi Gea. Sebagian besar adalah aplikasi TSX yang menargetkan web, ESP32, dan/atau Gea OS. apps/*/package.json Manifes aplikasi, kompatibilitas target, skrip, dan metadata peluncur. tools/dialer-browser Alat bantu sisi browser kecil untuk alur kerja dialer. package.json Penanda ruang kerja untuk koleksi contoh. docs Katalog dan panduan kontribusi.

Mulai Cepat: Jalankan pemeriksaan untuk contoh individual: cd apps/watch npm install npm run check npm run build. Beberapa contoh juga membawa pengujian, sebagian besar menjaga tata letak atau pengaturan perangkat yang tidak akan ditangkap oleh hal lain -- npm test di folder aplikasi menjalankannya. Loop web digerakkan dari simulator, yang merupakan repositori terpisah: geastack/simulator. Skripnya membaca aplikasi dari akar proyek aplikasi, yang mereka ambil dari GEA_APPS_ROOT -- repo ini, atau milik Anda sendiri. Tidak ada default, jadi setel atau lewati --app-dir; tidak ada yang mengasumsikan kedua checkout berada di sebelah satu sama lain. cd /path/to/simulator GEA_APPS_ROOT=/path/to/examples ./targets/web/dev-web.mjs watch # loop pengembangan GEA_APPS_ROOT=/path/to/examples ./targets/web/build-web.sh watch # build untuk web ./targets/web/dev-web.mjs --app-dir /path/to/examples/apps/watch # atau beri nama satu aplikasi. Flash papan yang kompatibel melalui Gea CLI: npx gea flash watch --board <alias> npx gea flash watch --board <alias> --monitor.

Dokumentasi: docs/EXAMPLE-CATALOG.md: kategori contoh, kompatibilitas target, dan bagaimana manifes digunakan. docs/DEVELOPMENT.md: cara menambah, menguji, dan memelihara aplikasi contoh.

Dasar-dasar Manifes Aplikasi: Setiap aplikasi yang dapat dibangun harus memiliki package.json dengan bidang gea: {"gea": {"id": "watch","name": "Watch","entry": "index.tsx","runtime": "gea","targets": {"web": true,"esp32": true,"geaos": true}}}. Manifes dikonsumsi oleh simulator, skrip papan tertanam, Gea OS, target Apple, dan ekstensi IDE. Jaga akurasinya.

Catatan Pemeliharaan: Jaga contoh tetap kecil dan fokus. Contoh yang baik membuktikan satu perilaku dengan jelas. Utamakan API kerangka kerja bersama daripada trik khusus target di dalam contoh. Tambahkan pengujian untuk contoh dengan logika, fisika, atau penguraian yang tidak sepele. Perbarui dokumentasi katalog saat menambah, mengganti nama, menyembunyikan, atau mengubah kompatibilitas target untuk aplikasi.

Lisensi: MIT (lihat LICENSE). Gunakan, ubah, kirim produk sumber tertutup di atasnya, tanpa syarat. Satu-satunya kode Gea Stack di bawah lisensi berbeda adalah dukungan papan tertanam (targets dan @geastack/chips, GPL-3.0-only): mengirim firmware sumber tertutup melalui itu memerlukan lisensi komersial. Hubungi [email protected] untuk ketentuan komersial, dukungan, dan build yang dihosting.

Entitas Utama: Perusahaan: Gea Stack, GeaOS, Apple, VS Code, Cursor