Skip to content

CONFIG_SIMPLIFICATION.md

Latest commit

 

History

History
77 lines (62 loc) · 1.83 KB

CONFIG_SIMPLIFICATION.md

File metadata and controls

77 lines (62 loc) · 1.83 KB

Configuration Simplification

Before vs After

Old Process (4 steps)

1. Select provider (choose from 8 options)
2. Input email address
3. Input password
4. Input account name

New Process (2 steps)

1. Input email address → Auto-detect provider ✓
2. Input password → Done ✓

Usage Example

$ mailcli config add
Email address: user@gmail.com
✓ Detected provider: Gmail
Password (or app-specific password): ********
✓ Configuration saved!

📧 Account: Gmail (user@gmail.com)
🔗 Provider: Gmail

You can now use 'mailcli mail list' to view your emails

Supported Providers

Auto-detected from email address:

  • Gmail: @gmail.com, @googlemail.com
  • Outlook: @outlook.com
  • Office 365: @office365.com
  • QQ Mail: @qq.com
  • 163 Mail: @163.com
  • 126 Mail: @126.com
  • Yahoo Mail: @yahoo.com, @ymail.com
  • iCloud: @icloud.com, @me.com, @mac.com

For custom IMAP servers:

Email address: user@custom-domain.com
⚠️  Unknown email provider. Please enter your IMAP server details.
IMAP server address: mail.custom-domain.com
IMAP port: 993
Use TLS? [Yes/No]
Password: ********

Implementation Details

Auto-Detection Logic

// Email domain → Provider mapping
user@gmail.com      → Gmail (imap.gmail.com:993)
user@outlook.com     → Outlook (outlook.office365.com:993)
user@qq.com         → QQ Mail (imap.qq.com:993)

Account Naming

  • Default: Email address (user@gmail.com)
  • User can customize during setup
  • Used for account reference in multi-account setups

Benefits

✅ Fewer steps: 2 instead of 4 ✅ No manual selection: Auto-detected from email ✅ Less cognitive load: User doesn't need to know IMAP details ✅ Same power: Custom IMAP still available when needed ✅ Better UX: Progressive disclosure (only ask when needed)