MailKite Webmail

Open-source webmail client for MailKite — built with Next.js 15, shadcn/ui, and Tailwind v4.

Deploys to webmail.mailkite.dev on Cloudflare Workers via OpenNext.

This app has no backend. MailKite is the backend — all mail, read/unread, and tags live in the MailKite API, not here. Read docs/webmail/architecture.md before adding anything that needs to persist.

Features

• Three-panel layout — sidebar, inbox list, message detail (resizable)
• Chat-style threading — messages displayed as conversation bubbles
• OAuth login — Google and GitHub sign-in via MailKite API
• Inline reply — compose replies without leaving the thread
• Dark-first — designed for dark mode with light theme support
• Mobile responsive — drawer overlay for detail view on small screens

Stack

Layer	Tech
Framework	Next.js 15 (App Router)
UI	shadcn/ui + Tailwind v4
State	Zustand
Deploy	Cloudflare Workers (OpenNext)
API	MailKite API (api.mailkite.dev)

Development

npm install
npm run dev

Open http://localhost:3000.

Environment Variables

Copy .env.example to .env.local:

cp .env.example .env.local

Required:

• NEXT_PUBLIC_API_URL — MailKite API base URL
• NEXT_PUBLIC_GOOGLE_CLIENT_ID — Google OAuth client ID
• NEXT_PUBLIC_GITHUB_CLIENT_ID — GitHub OAuth client ID

Deploy

npm run deploy

Requires Cloudflare account with Workers paid plan and wrangler configured.