GUI completeness
Every essential task has a graphical path.
Intelligence, in its place.
A local-first, AI-augmented email client exploring how intelligence should live inside traditional graphical applications.
Your PHYS 204 problem set is now due Friday at 5:00 PM. Submit it through the course portal.
Hi Alex,
The PHYS 204 assignment deadline has changed from Thursday at 5:00 PM to Friday at 5:00 PM.
Please submit your problem set through the course portal by the new deadline.
01 The design question
AI opens up new ways to work. But when everything becomes a conversation, what happens to the structure we rely on?
01 / StructureChat-first interaction can hide navigation and make familiar tasks harder to see.
02 / ControlUnpredictable actions can leave users unsure of what changed, or why.
03 / PrivacyCloud-first intelligence can expose personal context beyond the device.
How should artificial intelligence be integrated into traditional graphical applications?
02 Design philosophy
GUI provides structure and control. AI adds understanding, organization, prediction, and suggestions. The assistant is an optional way to access information.
Every essential task has a graphical path.
Understanding, organization, and suggestions.
Review and confirm meaningful actions.
Visible history and clearly bounded Undo.
Designed for predictability, adaptability, transparency, progressive automation, and local privacy.
03 Product experience
A native SwiftUI workspace, from the first message of the day to the last draft. Demo Mode is available without accounts or a model.
Inbox · Reader · Categories
Source-backed summaries, classification suggestions, and extracted actions sit inside a conventional message reader. Accept a local category when it makes sense. Keep reading when it doesn’t.
Smart Reply offers editable ideas in the normal composer.
Submit the problem set by Friday, 5:00 PM.
Conceptual presentation · Not an application screenshot
Daily Briefing · Search · Assistant
Daily Briefing explains priority signals. Optional local query expansion helps search cached mail. The read-only assistant answers from bounded excerpts and links back to sources.
Query expansion with local ranking; an embedding index is not implemented.
Maya is waiting for feedback on the category flow.
John asks you to confirm the new meeting time.
Conceptual presentation · Not an application screenshot
Composer · Drafts · Writing Tools
Proofread, adjust tone, or rewrite a draft. Preview the suggestion before Replace or Insert. Saving stays local; syncing a draft and sending require explicit action.
Draft recovery protects work. Sending has a separate confirmation and no automatic Undo.
The draft stays unchanged until you accept.
Conceptual presentation · Not an application screenshot
Accounts · Sync · Offline
Gmail, Microsoft, and iCloud share a provider architecture. Local persistence and an offline cache keep synchronized mail available. Attachments download only when requested.
Provider adapters are implemented. Live sign-in, sync, and writes remain unverified.
Conceptual presentation · Not an application screenshot
04 Local intelligence
Personal mail deserves a deliberate boundary. In Local AI mode, inference stays on the device, with no silent cloud fallback.
Limited contextOnly the context needed for the request.
Validated outputStructured responses and source-quote checks.
Cancellable requestsLate results cannot overwrite a different task.
Local AI cachingCapability caches respect content and account boundaries.
Selected, locally cached messages
Bounded, task-specific excerpts
Validation, cancellation & cache
Loopback runtime · Local inference
Verified on-device model
Mail sync separately contacts your authenticated provider. Local AI stays inside the local inference boundary.
AI mode is an explicit choice. Generated text can be wrong; source validation does not guarantee accuracy. Local mail storage is a prototype JSON store, not an encrypted database.
05 Human-guided AI
Suggest → Confirm → Execute. AI providers hold no mail writer or action executor. Permission and execution belong to the application’s controlled action layer.
Context, meaning, and possible next steps.
A visible, editable proposal.
Check the source, scope, and effect.
Explicit approval for the action.
Permission checks and a durable record.
06 Progressive automation
Automation can increase. The scope of permission is always defined by the user. Explore the five levels implemented in the research prototype.
Level 2 / Suggestion
AI can suggest a category or prepare a writing preview. You review and accept the suggestion. External mail actions still pass through account permissions and a confirmation preview.
07 Architecture & engineering
A native macOS application built with Swift and SwiftUI. Clear boundaries separate presentation, intelligence, permissions, and the systems that act.
Simplified from the Beta architecture. The reasoning layer has no direct mail-write authority.
130 XCTest + 292 Swift Testing.
Debug and Release builds passing.
Swift 6 + SwiftUINative macOS research prototype
Swift Package ManagerExplicit modules and provider abstractions
Local-first persistenceOffline mail cache · Keychain credentials
3 mail provider architecturesGmail · Microsoft Outlook / 365 · iCloud
The adapters include authentication, bounded synchronization, and many confirmed write operations. Live Gmail, Microsoft, and iCloud sign-in, synchronization, and writes remain unverified; real-account validation is ongoing.
The local preview is ad hoc signed. Production readiness, notarized distribution, comprehensive native accessibility coverage, and broad hardware validation are not claimed. The portfolio’s browser checks are separate from the macOS application’s documented 422-test gate.
08 The research behind the product
Working paper · Research prototypeA Human-Guided Framework
for AI-Augmented Applications
How can an application become more intelligent without making its user less in control?
The proposed framework treats AI as an augmentation of an already complete graphical application. Structure stays visible, suggestions stay reviewable, and authority stays explicit.
Flora Mail puts that framework into a working macOS email prototype: a familiar GUI, embedded assistance, and an optional information-access assistant.
Implementation is evidence of a design direction. It is not evidence of a usability improvement.
Ordinary mail navigation and controls. AI and contextual assistance are hidden.
The read-only assistant leads the Today surface. Normal mail controls remain accessible.
A traditional GUI with embedded AI and an optional assistant. The default research mode.
These modes change presentation, not permissions. They do not establish feature parity or a controlled experimental design.
Proposed Evaluation
A future evaluation could compare how people find information, review suggestions, and complete email tasks across the three conditions.
No participant study or experimental results are reported.Proposed tasks include finding a message, identifying a deadline, organizing mail, and drafting a reply. Tasks must be reviewed for suitability in each mode before any comparison. Assignment and counterbalancing remain to be designed.
A proposed study could examine task completion and errors, review and correction behavior, perceived control, predictability, trust, and workload. Task correctness and subjective measures need a reviewed protocol; they are not inferred from event counts.
Existing instrumentation is opt-in and off by default. It records fixed interaction events and explicit task timers locally, excluding mail content, account identity, queries, and credentials. A real study still needs recruitment, participant consent, a data-handling plan, and any required institutional review.
The prototype and automated developer checks establish implementation behavior. They do not establish statistical significance, usability gains, model accuracy, or experimental findings. The working paper’s publication status and public manuscript are not yet provided.
09 Project journey
A conceptual development sequence. Provider-backed actions are implemented; live-account validation is still ahead.
Flora Mail – Beta / v0.2.0 Prerelease
The idea worth pursuing