Skip to content

Web UI basics

The main interface provides: inbox browsing, folders/labels, thread reading, and bulk actions.

Routes at a glance

  • / → redirects to /inbox
  • /inbox → inbox view (supports ?folder=)
  • /thread/<id> → thread / conversation view

Full endpoint list: API endpoints

Inbox view (/inbox)

The main inbox displays:

FeatureDescription
Unread indicatorsBold styling, visual badges
Sender & subjectQuick scan with avatars
TimestampsRelative (“2 hours ago”) and absolute
SnippetsFirst line preview
PaginationConfigurable page size

Folder navigation

Switch between Gmail folders:

  • INBOX — Primary inbox
  • [Gmail]/Sent Mail — Sent emails
  • [Gmail]/Drafts — Draft emails
  • [Gmail]/All Mail — All archived mail
  • Custom labels — Your Gmail labels

Thread view (/thread/<id>)

Click an email to view the full conversation:

  • Chronological display — Oldest to newest
  • Sender avatars — Visual distinction
  • HTML rendering — Safe, sanitized HTML
  • Attachments — Download links
  • Reply/Forward — Action buttons

Bulk actions

Select multiple emails with checkboxes:

┌──────────────────────────────────────────────────┐
│ ☑ Select All    [Mark Read] [Archive] [Delete]   │
├──────────────────────────────────────────────────┤
│ ☑ Newsletter from Company A                      │
│ ☑ Weekly Digest #234                             │
│ ☐ Important: Q4 Budget Review                    │
│ ☑ Your order has shipped                         │
└──────────────────────────────────────────────────┘

Available actions:

  • Mark as Read — Clear unread status
  • Mark as Unread — Flag for attention
  • Archive — Move to All Mail
  • Delete — Move to Trash
  • Apply Label — Add Gmail label

Confirmation Required

All bulk actions require confirmation before executing.

Next: Search · AI chat · Settings

Released under the MIT License.