About
Elixpo Mails is the multi-tenant, event-based transactional email service
for the Elixpo ecosystem. It helps a business send the everyday emails its
product needs to send — receipts, welcome notes, order updates, password
resets, invoices — beautifully designed, on-brand, and sent automatically
when something happens in their app.
No mail server to run. No email HTML to hand-write. No shared "noreply@" address —
the emails go out from your own mailbox, so they look like they came from you.
Within the ecosystem, Elixpo Mails is the shared mailing infrastructure that
backs the other Elixpo products.
This repository is the source for the mails.elixpo.com hosted service.
Who it's for
Any business or team that wants reliable, professional transactional email without
standing up a whole email platform. If your app needs to email a customer when they
sign up, pay, or place an order — this is for you.
Why it's different
- 📤 Your own sender. Connect your Gmail, Google Workspace, or any SMTP mailbox.
Emails are sent as you, not from a shared pool — better trust and deliverability.
- 🎨 Design without code. A visual editor (like writing a document) with
{{placeholders}} for the bits that change per customer — names, amounts, links.
- 🏷️ On-brand by default. Each product carries its own logo, address, phone, and
footer, added to every email automatically.
- 📎 Attachments. Attach a file from Google Drive, a link, or a per-send variable
(e.g. each customer's own invoice).
- 🔕 Unsubscribe handled for you. Built-in one-click unsubscribe and a suppression
list, so you stay compliant without building anything.
- 📊 See every send. A delivery log shows exactly what went out, to whom, and
whether it landed.
How it works — in four steps
- Connect a sender — add the mailbox your emails should come from.
- Create a product — this represents one of your services and holds its
credentials and branding.
- Design a template — write the email once, with
{{variables}} for the
personalized parts.
- Add a webhook — your app calls a single secure URL when an event happens, and
Elixpo Mails renders the template with that customer's details and sends it.
That's it — your product now sends polished, branded email on autopilot.
Built on
Elixpo Mails runs entirely on Cloudflare's edge network for speed and
reliability — Pages + D1 + a cloudflare:sockets SMTP Worker (with send and
retry queues) — and signs in through Elixpo Accounts (SSO). Senders are
AES-GCM encrypted at rest, and webhooks are HMAC-signed. It's part of the Elixpo
suite of products and provides the shared mailing infrastructure for the rest of
the ecosystem.
The ecosystem
Developers can drop our editors into their own projects with the
@elixpo/lixsketch and @elixpo/lixeditor packages, on npm and as VS
Code extensions.
For developers
The full API reference — authentication, the trigger endpoint, templates, variables,
attachments, and unsubscribe — lives at mails.elixpo.com/docs
(with a one-click "Copy for LLM" button).
Running locally
npm install
npm run dev
Then open http://localhost:3000.
Useful scripts (see package.json for the full list):
npm run build # Production build
npm run pages:build # Build for Cloudflare Pages
npm run lint # Biome check
npm run db:migrate # Apply D1 migrations (remote)
npm run db:migrate:local # Apply D1 migrations (local)
npm run queues:create # Create the send / retry queues
npm run worker:deploy # Deploy the SMTP sender Worker
Deployment is driven by deploy.sh and wrangler.toml.
Built by the community
Elixpo is made by people, in the open. 45+ contributors have shaped these
tools, with a small core team steering the way:
Everyone is welcome. See CONTRIBUTING.md and our
Code of Conduct.
Recognition & programs
Elixpo has taken part in and been supported by GSSOC, Hacktoberfest,
Pollinations.AI, MS Startup Foundations, and OSCI.
Get involved
- 💬 Join the conversation in GitHub Discussions.
- 🚀 Submit your project to be featured across the ecosystem.
- 🛠️ Contribute - browse good first issues in the monorepo.
Brand assets
Brand-ready marks and icons live under public/ (logo, mark, and the
icon set). The ecosystem brand source of truth (mascot, palette, rules) is at
elixpo.com/assets.
License
Elixpo uses one licensing standard across every repository:
The Oreo mascot, the chest E-badge, and the "Elixpo" and "Oreo" names, domains,
and palette are reserved - this protects the brand and its royalties while
keeping the code and assets free. See LICENSE and the per-product
notice board, NOTICE.
Exclusive
Per-repo "exclusive" artifacts (an npm package, a VS Code extension, a hosted
SaaS, a paid tier) are declared here and in NOTICE.
This repository: None - it does not publish an npm package, a marketplace
extension, or a separately-licensed binary. mails.elixpo.com is the official
hosted deployment; the brand and the hosted deployment are reserved, but the
source carries the full MIT / CC-BY-4.0 grant.
