https://github.com/juanmanuelramallo/testbox

Simple test inbox via ActionMailbox
https://github.com/juanmanuelramallo/testbox

actionmailbox email email-testing rails

Last synced: about 2 months ago
JSON representation

Simple test inbox via ActionMailbox

• Host: GitHub
• URL: https://github.com/juanmanuelramallo/testbox
• Owner: juanmanuelramallo
• Created: 2021-12-27T16:18:05.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2022-01-07T01:27:27.000Z (over 4 years ago)
• Last Synced: 2025-11-22T13:20:30.623Z (7 months ago)
• Topics: actionmailbox, email, email-testing, rails
• Language: Ruby
• Homepage: https://testbox:very-strong-password@testbox.dokku.1ma.dev
• Size: 200 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Testbox

A place to send your non-production emails.

[![CI](https://github.com/juanmanuelramallo/testbox/actions/workflows/ci.yml/badge.svg)](https://github.com/juanmanuelramallo/testbox/actions/workflows/ci.yml)

## Usage

1. Deploy the app and fill the environment variables (AWS S3 credentials are needed to store the emails)

      [![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/juanmanuelramallo/testbox)

1. Add a custom domain name to your app

1. Configure Sendgrid to be able to receive emails. https://docs.sendgrid.com/for-developers/parsing-email/setting-up-the-inbound-parse-webhook. (Testbox uses ActionMailbox to process emails https://guides.rubyonrails.org/action_mailbox_basics.html#sendgrid)

1. Send an email to your recently configured test inbox and it will appear in the app's dashbaord.

1. Visit your app. Use `testbox` as username and your USER_PASSWORD env var as password.

## How it works

Uses ActionMailbox to receive emais. Testbox is basically a user interface for ActionMailbox's InboundEmails.