mirror of https://github.com/root-fr/jmap-webmail.git synced 2026-09-24 00:01:14 +00:00

Files

T

Matthieu MALVACHE 1306ce56f8 feat(config): Add runtime environment variables for Docker support

Enable post-build configuration by reading env vars at request time
instead of build time. This allows Docker containers to be configured
without rebuilding the image.

- Add /api/config endpoint for runtime config
- Add useConfig hook with caching
- Update login page with proper loading/error states
- Add i18n translations for config errors
- Maintain backwards compatibility with NEXT_PUBLIC_* vars

2026-01-08 02:00:09 +01:00

2.0 KiB

Raw Blame History

JMAP Webmail

A modern, privacy-focused webmail client built with Next.js and the JMAP protocol.

Screenshots

Inbox

Email Viewer

Compose

Dark Mode

Settings

Features

Modern UI - Clean, minimalist three-pane layout
Dark Mode - Full dark theme support
Email Threading - Gmail-style conversation view
Real-time Updates - Push notifications for new emails
Keyboard Shortcuts - Navigate efficiently with hotkeys
Drag & Drop - Move emails between folders
Color Tags - Organize emails with color labels
Attachments - Upload and download file attachments
Search - Full-text email search
i18n - English and French language support
Mobile Responsive - Adaptive layout for all screen sizes

Tech Stack

Framework: Next.js 16 with Turbopack
Styling: Tailwind CSS v4
State: Zustand
Protocol: JMAP (RFC 8620)
i18n: next-intl

Getting Started

# Install dependencies
npm install

# Run development server
npm run dev

Open http://localhost:3000 and connect to your JMAP server.

Configuration

Create a .env.local file:

APP_NAME=Your Webmail
JMAP_SERVER_URL=https://your-jmap-server.com

Runtime vs Build-time Configuration

Variable	Type	Description
`APP_NAME`	Runtime	App name displayed in the UI
`JMAP_SERVER_URL`	Runtime	JMAP server URL (required)
`NEXT_PUBLIC_APP_NAME`	Build-time	Legacy fallback for app name
`NEXT_PUBLIC_JMAP_SERVER_URL`	Build-time	Legacy fallback for server URL

Runtime variables are read at request time, enabling post-build configuration (ideal for Docker).

Build-time variables are baked into the bundle and require a rebuild to change.

License

MIT

2.0 KiB Raw Blame History