A Rails engine for receiving and processing incoming emails via HTTP POST endpoints from email services.
Griddler is a Rails engine that provides an endpoint for services that convert incoming emails to HTTP POST requests, parsing them into a structured email object for custom processing. It solves the problem of integrating email reception into Rails apps without dealing with raw email data or service-specific APIs. Note: As of June 2024, it is deprecated in favor of Rails' built-in ActionMailbox.
Rails developers who need to receive and process incoming emails from services like SendGrid, Mailgun, or Postmark in their applications.
Developers choose Griddler for its simplicity, adapter-based architecture supporting multiple email services, and clean abstraction that lets them handle emails with custom logic without wrestling with email parsing complexities.
Simplify receiving email in Rails (deprecated)
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Parses incoming email POSTs into a structured Griddler::Email object with attributes like to, from, body, and attachments, eliminating raw email handling.
Supports multiple email services via adapter gems (e.g., SendGrid, Mailgun), allowing easy integration with various providers without rewriting parsing logic.
Enables developers to implement a custom processor class (e.g., EmailProcessor) with options like reply delimiters, tailoring email handling to app needs.
Includes examples for creating test factories, such as with FactoryGirl, to simulate incoming emails in tests, aiding in robust validation.
As of June 2024, Griddler is officially deprecated, meaning no new updates or support, and Rails' built-in ActionMailbox is the recommended alternative.
Requires installing separate adapter gems for each email service, adding maintenance overhead and risk of outdated or unmaintained adapters.
Setting up involves multiple steps like configuring processor class, email service, and reply delimiters, which can be complex compared to integrated solutions.