# PRODUCT.md · screen/aggregate-mail

[View on GitCafe](https://git.cafe/screen/aggregate-mail/blob/refs%2Fheads%2Ffix%2Fmail-links-ui-review/PRODUCT.md)

Repository: [screen/aggregate-mail](https://git.cafe/screen/aggregate-mail)

Visibility: public

Requested revision: refs/heads/fix/mail-links-ui-review

Commit: b43db2ee6722891b804ca9859856c148553659a8

Blob: e3ea050c7ef130deb5e474a663748bcd24850700

Size: 1902 bytes

[Immutable source](https://git.cafe/screen/aggregate-mail/blob/b43db2ee6722891b804ca9859856c148553659a8/PRODUCT.md?format=markdown)

```
# Aggregate Mail

<!-- impeccable:product-schema 1 -->

## Platform

Windows desktop and a macOS build target

## Stack

Electron with React and TypeScript. Bundled mail service and local SQLite persistence. The user explicitly corrected the initial browser implementation and requested a desktop app matching the video frames.

## Product Purpose

Build the email aggregation client demonstrated in Ryan Vogel's supplied video. The user requested real inbox connections with OAuth setup.

## Capabilities and Constraints

One inbox across accounts. Important and Other categories. Variable row heights reflect relevance. Keyboard navigation and account filtering. Teachable sorting. Gmail OAuth and IMAP providers. Installable Windows application with its own runtime and local app-data storage. Optional local MCP access lets AI clients read cached mail and reply through the running app. MCP is off by default, uses an encrypted persistent bearer token, and requires a separate opt-in for sending replies. Settings sections: Accounts, Sorting, Connection, MCP, About.

The macOS target packages the same application as unsigned DMG and ZIP files. It uses native menus, Command editing shortcuts and Keychain-backed database-key protection. This is a maintainer-led open-source project. Public contributions must exclude personal information, local machine details, credentials and private runtime data. See [the desktop packaging decision](docs/adr/0001-unsigned-macos-packaging.md).

## Evidence on Hand

qsgWf9eTSH3hwijq.mp4. Full machine transcript in .reference/transcript.txt. Gmail, iCloud, Fastmail, Yahoo, and custom IMAP are described in the video. Cloudflare mailbox creation is a future idea, outside this implementation.

## Brand Commitments

Follow the video's compact black interface. White text. No decorative cards, pills, or slogans. No live browser testing, per user instruction.

```