PHPackages mailcarrier/mailcarrier - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. mailcarrier/mailcarrier ActiveLibrary[Mail & Notifications](/categories/mail) mailcarrier/mailcarrier ======================= Mailing platform with templates and logs included v3.1.0(1mo ago)1632.5k↓85.6%15[1 issues](https://github.com/mailcarrierapp/mailcarrier/issues)[3 PRs](https://github.com/mailcarrierapp/mailcarrier/pulls)MITPHPPHP ^8.4CI passing Since Aug 4Pushed 1mo ago1 watchersCompare [ Source](https://github.com/mailcarrierapp/mailcarrier)[ Packagist](https://packagist.org/packages/mailcarrier/mailcarrier)[ Docs](https://github.com/mailcarrierapp/mailcarrier)[ Fund](https://www.buymeacoffee.com/theraloss)[ GitHub Sponsors](https://github.com/danilopolani)[ RSS](/packages/mailcarrier-mailcarrier/feed)WikiDiscussions main Synced 2w ago READMEChangelog (10)Dependencies (74)Versions (66)Used By (0) ![MailCarrier logo](https://camo.githubusercontent.com/1b8f7ac0fcf98093c813d7ad02ab9bc6bed10fd5efe4ee3229bd39c1f7d9992c/68747470733a2f2f6d61696c636172726965722e6170702f696d616765732f6c6f676f732f6c6f676f2d6461726b2e706e67) User friendly, provider-aware, mailing platform with templates and logs included. --------------------------------------------------------------------------------- [](#user-friendly-provider-aware-mailing-platform-with-templates-and-logs-included) Design global layouts, compose your template, preview your emails and send them with your desired provider (SES, MailGun etc.) through intuitive and friendly API endpoint protected by your desired auth guard. Then, inspect them through logs. ### Features [](#features) - 🎨 **Beautiful syntax**: Explore a beautiful, expressive template syntax similar to JS thanks to [Twig by Symfony](https://twig.symfony.com). - 🧩 **Provider aware**: Bring your desired provider to send email, such as Amazon SES, MailGun, SendGrid etc. - ✨ **Friendly APIs**: Use a friendly and well documented API endpoint to send your emails. - 🔐 **Secure by default**: Both authentication and API endpoint are always secure: use one of the pre-built auth system or bring your own. - 📎 **Attachments**: Upload or retrieve attachments from a remote source such *S3*, *Spaces* etc. - 🪄 **Hackable**: MailCarrier relies on [Laravel](https://laravel.com/) and [Filament](https://filamentphp.com/), that means that over 30K packages are available to customise your MailCarrier instance. - ⏳ **Queues**: You can choose whether or not to send emails in a enqueued, background jobs, to not block the user experience. - 🪝 **Webhooks**: Track and receive events from your provider directly in MailCarrier. Quick start ----------- [](#quick-start) ### Classic way [](#classic-way) **Prerequisites**: PHP 8.4, Laravel 13, Composer ``` curl "https://mailcarrier.app/create" | bash ``` Learn more about [the classic way](https://mailcarrier.app/docs/getting-started/installation). ### Docker [](#docker) ``` docker run -p 80:80 -ti mailcarrier/mailcarrier ``` Learn more about [running with Docker](https://mailcarrier.app/docs/getting-started/running-docker). Testing ------- [](#testing) ``` composer test ``` Upgrading --------- [](#upgrading) Upgrading from v2 to v3? See the [upgrade guide](UPGRADE.md). ### Upgrade with your AI agent [](#upgrade-with-your-ai-agent) MailCarrier ships machine-readable upgrade instructions. Paste the following prompt into your AI coding agent (Cursor, Claude Code, Codex, etc.) and it will perform the v2 → v3 upgrade for you: ``` Upgrade this project from MailCarrier v2 to v3 by following these instructions exactly: https://raw.githubusercontent.com/mailcarrierapp/mailcarrier/main/ai/upgrades/v2-to-v3.md Apply every phase in order, run the verification gate after each phase, run `composer test` at the end, and stop and report if any stop condition is hit. ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](https://github.com/mailcarrierapp/.github/blob/master/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [Danilo Polani](https://github.com/danilopolani) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 60 — FairBetter than 98% of packages Maintenance91 Actively maintained with recent releases Popularity37 Limited adoption so far Community15 Small or concentrated contributor base Maturity80 Battle-tested with a long release history Bus Factor1 Top contributor holds 99.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~25 days Recently: every ~7 days Total 57 Last Release 33d ago Major Versions v0.8.1 → v1.0.02023-03-31 1.x-dev → v2.0.02024-02-20 2.x-dev → v3.0.02026-06-18 PHP version history (2 changes)v0.1.0PHP ^8.1 v3.0.0PHP ^8.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/8ed568a3c0ca4ca3d3b7d199371b455e3a50347dcffc39ec01c94e04743bdcd6?d=identicon)[Theraloss](/maintainers/Theraloss) --- Top Contributors [![danilopolani](https://avatars.githubusercontent.com/u/6277291?v=4)](https://github.com/danilopolani "danilopolani (272 commits)")[![aldrahastur](https://avatars.githubusercontent.com/u/5844861?v=4)](https://github.com/aldrahastur "aldrahastur (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)") --- Tags email-sendermailmailingmailing-systemlaravelmailcarrier ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/mailcarrier-mailcarrier/health.svg) ``` [![Health](https://phpackages.com/badges/mailcarrier-mailcarrier/health.svg)](https://phpackages.com/packages/mailcarrier-mailcarrier) ``` ### Alternatives [spatie/laravel-permission Permission handling for Laravel 12 and up 13.0k107.5M1.6k](/packages/spatie-laravel-permission)[spatie/laravel-health Monitor the health of a Laravel application 88212.7M188](/packages/spatie-laravel-health)[laravel/ai The official AI SDK for Laravel. 1.1k4.6M322](/packages/laravel-ai)[rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3915.5k](/packages/rawilk-profile-filament-plugin)[backstage/mails View logged mails and events in a beautiful Filament UI. 16429.7k](/packages/backstage-mails)[finity-labs/fin-mail A powerful email template manager and composer for Filament with dynamic token replacement, template versioning, and inline email sending. 316.8k2](/packages/finity-labs-fin-mail) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)