MailVoid

A developer email testing tool that captures and organizes test emails without creating separate email accounts. It integrates with your mail server via webhooks and provides a clean web interface for viewing and managing messages. It also includes a webhook capture feature for testing HTTP webhooks.

Features

• Receive and store emails via mail server webhooks
• Organize emails into groups with configurable retention policies
• Capture and inspect arbitrary HTTP webhooks
• Real-time notifications via SignalR
• JWT authentication with refresh token rotation
• Responsive Angular SPA with dark theme

Requirements

• Go 1.27+
• Node.js 22+ and npm
• SQLite (embedded; no separate install)

Getting Started

git clone https://github.com/timothydodd/MailVoid.git
cd MailVoid

Backend

The API and SMTP server are Go services in src/go. They read the same appsettings.json, appsettings.{Environment}.json, user secrets (Development) and environment variables (Section__Key) as the original .NET services, and use the existing SQLite database as-is.

Configure src/go/cmd/mailvoid-api/appsettings.json (or environment variables) with your database and JWT settings:

{
  "ConnectionStrings": {
    "DefaultConnection": "Data Source=mailvoid.db"
  },
  "JwtSettings": {
    "Secret": "at-least-32-characters-long-secret-key",
    "Issuer": "mailvoid",
    "Audience": "mailvoid",
    "ExpiryMinutes": 30
  }
}

Start the API (missing tables are created automatically; it listens on http://localhost:5133 unless ASPNETCORE_URLS / ASPNETCORE_HTTP_PORTS say otherwise):

cd src/go/cmd/mailvoid-api
go run .

The SMTP server runs the same way from src/go/cmd/mailvoid-smtp.

Frontend

cd src/MailVoidWeb
npm install
npm start

Update src/environments/environment.ts if your API is not running on the default port.

Default Credentials

• Username: admin
• Password: admin

Docker

docker build -f src/go/Dockerfile.api -t mailvoid src
docker run -p 5133:8080 mailvoid

docker build -f src/go/Dockerfile.smtp -t mailvoid-smtp src/go

Tech Stack

Layer	Technology
Backend	Go (net/http, go-smtp), SignalR-compatible hub
Frontend	Angular 19, RxJS, Lucide, Bootstrap
Database	SQLite

Project Structure

src/
├── go/                    # Go backend
│   ├── cmd/mailvoid-api/  # API entrypoint (+ default appsettings)
│   ├── cmd/mailvoid-smtp/ # SMTP server entrypoint (+ default appsettings)
│   └── internal/          # api, smtpd, config (.NET-compatible), ordered
├── MailVoidWeb/           # Angular frontend
│   └── src/app/
│       ├── Pages/         # Page components
│       ├── _components/   # Shared components
│       └── _services/     # API and auth services
└── legacy/                # Original .NET services (kept until the Go port is signed off)

License

This project is licensed under the MIT License.