diff --git a/README.md b/README.md index 96f4663..6965881 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,11 @@ -# キラキラ kirakira +# kirakira [![AI-DECLARATION: copilot](https://img.shields.io/badge/䷼%20AI--DECLARATION-copilot-fee2e2?labelColor=fee2e2)](https://ai-declaration.md) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) ![Powered by Mistral](https://img.shields.io/badge/Powered_by-Mistral_AI-FA520F?logo=mistral-ai&logoColor=white) ![Flutter](https://img.shields.io/badge/Flutter-02569B?logo=flutter&logoColor=white) [![Forked from flash-mail](https://img.shields.io/badge/Forked_from-sarthakkimtani%2Fflash--mail-59636e?logo=github&logoColor=white)](https://github.com/sarthakkimtani/flash-mail) -A mobile and desktop client for [smolmail](https://smol.place), a minimalist end-to-end encrypted mail protocol: one Ed25519 identity, five operations, sealed and signed messages over a Noise_NX transport. +A mobile client for [Smol Mail](https://smol.place), a minimalist end-to-end encrypted mail protocol: one Ed25519 identity, five operations, sealed and signed messages over a Noise_NX transport. Sibling of the reference CLI client (`https://smol.place`) and the browser client (`https://code.randogoth.com/randogoth/gsmol`). -kirakira began as [FlashMail](https://github.com/sarthakkimtani/flash-mail), a Flutter UI template for a disposable-email app built on mail.tm. Its protocol core is now [fumi-core](https://code.randogoth.com/randogoth/fumi), the Rust library the reference CLI is built on: `native/` wraps it into a C ABI and ships it in the APK as `libsmol_mail_native.so` (SQLite bundled), `lib/native/` speaks that ABI over dart:ffi, and `lib/smol/` is the thin facade the UI reads. The UI is Material 3 — dark navy and mint green by default, with a matching light theme — built from a single `ColorScheme` and `AppColors` extension rather than hardcoded colors per screen. +kirakira began as [FlashMail](https://github.com/sarthakkimtani/flash-mail), a Flutter UI template for a disposable-email app built on mail.tm. Its networking layer was replaced end to end with a from-scratch Smol Mail implementation (`lib/smol/`: crypto, Noise handshake, framing, client flows), and the UI was redesigned around a Material 3 theme — dark navy and mint green by default, with a matching light theme — built from a single `ColorScheme` and `AppColors` extension rather than hardcoded colors per screen. ## What it does @@ -14,30 +14,30 @@ kirakira began as [FlashMail](https://github.com/sarthakkimtani/flash-mail), a F - Trust-on-first-use for server and contact keys, with rotation support and on-screen warnings for anything unverified. - Export/import inbox, sent mail, contacts and server pins as one shareable backup file — never the seed. -Mail, contacts and pinned server keys live in fumi-core's SQLite store, bundled into the native library; the seed, read marks and settings stay app-side in Hive. - ## Layout ``` -lib/native/ dart:ffi binding: handles, error codes, isolate plumbing -lib/smol/ thin facades over the binding: address, store, client +lib/smol/ the protocol: crypto, Noise handshake, framing, client flows lib/presentation/ screens, widgets and theme (Riverpod + auto_route) lib/data/ Riverpod providers -native/ Rust wrapper crate: the C ABI over fumi-core, pinned by rev -integration_test/ Patrol device tests against a live server -test/ store, recall, binding, interop and e2e tests +test/ protocol vectors, store tests, a live e2e round-trip ``` ## Run and verify ``` -devbox run build-native-android # the .so the APK loads — once per Rust change devbox run analyze devbox run test -flutter run --flavor prod +flutter run ``` -`test/e2e_test.dart` runs a live round-trip against the local bunshin on `127.0.0.1:1961` and skips itself when nothing's listening there. On-device flows are covered by the Patrol suite — `devbox run test-integration` builds the `integration` flavor (installed beside the real app, its data cleared between tests) and drives onboarding, registration, fetch cancellation, rotation and the unchanged-key refresh against the same server. +`test/e2e_test.dart` runs a live round-trip against `https://smol.place/smolmaild.py` on `127.0.0.1:1961` and skips itself when nothing's listening there. + +## Notes and limits + +- No server push in v1 — fetch is manual. +- The seed lives in app storage; a compromised device is a compromised identity. +- Rotation isn't revocation — a stolen key can still rotate onward. Settings surfaces rotations for out-of-band verification rather than applying them silently. ## License diff --git a/screenshots/1.png b/screenshots/1.png new file mode 100644 index 0000000..828554b Binary files /dev/null and b/screenshots/1.png differ diff --git a/screenshots/2.png b/screenshots/2.png new file mode 100644 index 0000000..fb4957c Binary files /dev/null and b/screenshots/2.png differ diff --git a/screenshots/3.png b/screenshots/3.png new file mode 100644 index 0000000..c48e680 Binary files /dev/null and b/screenshots/3.png differ diff --git a/screenshots/4.png b/screenshots/4.png new file mode 100644 index 0000000..21412d0 Binary files /dev/null and b/screenshots/4.png differ