FileMailer-Web Module #
FileMailer-Web — the email experience your FileMaker solution has been waiting for. Native where it matters, web-standard where it counts.

A modern React TypeScript web client for the FileMailer-PG backend. FileMailer-Web is purpose-built to run inside a FileMaker Web Viewer, offering a seamless, powerful email integration for any existing CRM, ERP or custom FileMaker solution — while remaining a fully capable standalone browser application.
Overview #
FileMailer-Web is the frontend companion of FileMailer-PG. While FileMailer-PG handles IMAP/SMTP synchronization, PostgreSQL metadata and Minio content-addressable storage, FileMailer-Web delivers a clean, responsive UI to browse, search, read, compose, reply and organise email — all through REST APIs.
What makes it unique is the deep FileMaker integration by design. An integrated mail headers system links every email to any FileMaker object you care about — clients, providers, operations, articles, invoices, tickets, other emails — through metadata headers and REST API links. No need to bloat your FileMaker files with copies of email content: the authoritative copy lives in FileMailer-PG, FileMaker stores only the references.
Key Features #
FileMaker Web Viewer–First Design #
- Built to be embedded in a FileMaker Web Viewer with seamless two-way integration
- Clean startup contract: API key and context are handed over from FileMaker
- Responsive, compact layouts that look native inside a FileMaker layout
- Works equally well as a standalone browser web app
Integrated Mail Headers System #
- Every email carries structured custom headers linking it to FileMaker objects
- Bind messages to clients, providers, operations, articles, emails — or any entity your solution needs
- Metadata-only linkage: FileMaker files stay lean, email content lives in FileMailer-PG
- Custom header patterns configurable per account and per workflow
Modern Email Management #
- Virtual scrolling for mailboxes with tens of thousands of messages
- Multi-account IMAP/SMTP management with alphabetical account sorting
- Rich HTML email rendering with sanitisation (DOMPurify)
- Full-featured composer with Quill rich-text editor
- Reply, reply-all, forward, drafts with autosave
- Attachment upload, preview and download via CAS storage
Real-Time Updates #
- Live sync status driven by the backend’s IMAP IDLE notifications
- Account-level and folder-level sync indicators
- Inline refresh without reloading the app
AI-Ready Content Pipeline #
- The companion FileMailer-PG backend embeds and indexes email bodies and attachments for AI immersion
- FileMailer-Web surfaces this indexed content to the user and exposes hooks for AI search and retrieval workflows
- Your CRM/ERP gains AI-powered email context without leaving FileMaker
Developer-Grade Stack #
- React 19 with hooks and concurrent features
- TypeScript end-to-end — shared types with the FileMailer-PG OpenAPI schema
- Vite for instant dev server and fast production builds
- Tailwind CSS utility-first styling
- shadcn/ui accessible component library
- Lucide icons
- Axios with interceptors for API key auth, error handling and logging
Theming & UX #
- Built-in light and dark mode
- Responsive layout — desktop, tablet and mobile
- Optimised for embedding inside constrained viewports (FileMaker Web Viewer)
Architecture #
FileMaker Solution
└── Web Viewer
└── FileMailer-Web (React SPA)
└── REST API (X-API-Key)
└── FileMailer-PG (Spring Boot)
├── PostgreSQL (metadata, full-text search)
└── Minio / S3 (CAS storage, SHA-256 deduplication)
- Stateless — no backend of its own; all state lives in FileMailer-PG
- Deployable anywhere — static
dist/folder deploys to Vercel, Netlify, GitHub Pages, S3+CloudFront, nginx, or served directly by FileMaker Server - API-key authenticated — no sessions, no cookies, Web Viewer friendly
Integration with FileMaker #
- Configure the FileMailer-PG API base URL and API key on first launch (or inject from FileMaker on Web Viewer load)
- Use FileMaker scripts to open the web viewer on a specific account, folder, or search context
- Use the mail headers system to navigate from a FileMaker record (a client, an order, a ticket) straight to the related email thread
- Compose new messages pre-populated with headers linking back to the originating FileMaker record
Use Cases #
- CRM email integration — attach customer communication history directly to customer records
- ERP operation tracking — tie supplier correspondence to purchase orders and operations
- Ticketing and helpdesk — link incoming messages to tickets, cases or incidents
- Document workflows — attachments flow through the dedup engine and remain linked to the source business object
- AI-augmented mailboxes — semantic search, summarisation and retrieval over your full email corpus
Technical Specifications #
Stack #
- React 19 + TypeScript
- Vite 7
- Tailwind CSS 3 + shadcn/ui
- Radix UI primitives
- Quill rich-text editor
- Axios HTTP client
- React Router v7
Requirements #
- Node.js 18+ for development
- A running FileMailer-PG backend
- A valid FileMailer-PG API key
- Any modern browser, or a FileMaker Web Viewer (FileMaker Pro 21+ recommended)