Initial commit

Author: recrsn

.dockerignore

@@ -0,0 +1,43 @@
+# Binary
+mail-sink
+
+# Dependency directories
+ui/node_modules/
+
+# Build outputs
+ui/dist/
+
+# Log files
+*.log
+
+# Mac OS
+.DS_Store
+
+# Editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Go specific
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+*.test
+*.out
+go.work
+
+# NPM/Yarn
+package-lock.json
+yarn.lock
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*

.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  backend:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Go
+      uses: actions/setup-go@v5
+      with:
+        go-version: '1.24'
+    - name: Build
+      run: go build
+    - name: Test
+      run: make test
+
+  frontend:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '22'
+        cache: 'npm'
+        cache-dependency-path: ui/package-lock.json
+    - name: Install dependencies
+      run: cd ui && npm ci
+    - name: Lint
+      run: cd ui && npm run lint
+    - name: Build
+      run: cd ui && npm run build
+    - name: Test
+      run: cd ui && npm test

.github/workflows/release.yml

@@ -0,0 +1,63 @@
+name: Release
+
+on:
+  release:
+    types: [created]
+
+permissions:
+  contents: write
+  packages: write
+
+jobs:
+  binaries:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        goos: [linux, darwin, windows]
+        goarch: [amd64, arm64]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.24'
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+      - name: Build
+        env:
+          GOOS: ${{ matrix.goos }}
+          GOARCH: ${{ matrix.goarch }}
+          BINARY_NAME: mail-sink-${{ matrix.goos }}-${{ matrix.goarch }}${{ matrix.goos == 'windows' && '.exe' || '' }}
+        run: |
+          # Build just the binary without UI
+          make all BINARY_NAME=${BINARY_NAME} VERSION=${{ github.ref_name }}
+      - name: Upload Release Asset
+        uses: softprops/action-gh-release@v1
+        with:
+          files: mail-sink-${{ matrix.goos }}-${{ matrix.goarch }}${{ matrix.goos == 'windows' && '.exe' || '' }}
+
+  docker:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: |
+            ghcr.io/${{ github.repository }}:latest
+            ghcr.io/${{ github.repository }}:${{ github.ref_name }}

.gitignore

@@ -0,0 +1,35 @@
+# Binary
+mail-sink
+
+# Dependency directories
+node_modules/
+vendor/
+
+# Build outputs
+ui/dist/
+
+# Log files
+*.log
+
+# Mac OS
+.DS_Store
+
+# Editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Go specific
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+*.test
+*.out
+go.work
+
+# NPM/Yarn
+package-lock.json
+yarn.lock

Dockerfile

@@ -0,0 +1,60 @@
+### Build UI stage ###
+FROM node:20-slim AS ui-builder
+WORKDIR /app/ui
+
+# Copy UI package files first for better caching
+COPY ui/package.json ui/package-lock.json* ./
+
+# Install dependencies
+RUN npm ci
+
+# Copy UI source files
+COPY ui/ ./
+
+# Build UI
+RUN npm run build
+
+### Build Go application stage ###
+FROM golang:1.24-alpine AS go-builder
+WORKDIR /app
+
+# Copy Go module files first for better caching
+COPY go.mod go.sum ./
+RUN go mod download
+
+# Copy UI build artifacts
+COPY --from=ui-builder /app/ui/dist ./ui/dist
+
+# Copy Go source code
+COPY . .
+
+# Build Go binary
+RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o mail-sink .
+
+### Final minimal image ###
+FROM alpine:3.19
+
+# Add ca-certificates and timezone info
+RUN apk --no-cache add ca-certificates tzdata
+
+# Create non-root user
+RUN adduser -D -u 1000 appuser
+
+WORKDIR /app
+
+# Copy binary from builder
+COPY --from=go-builder /app/mail-sink .
+
+# Use non-root user
+USER appuser
+
+# Expose ports
+EXPOSE 1025 8080
+
+# Set default environment variables
+ENV SMTP_PORT=1025
+ENV HTTP_PORT=8080
+ENV GIN_MODE=release
+
+# Run the application
+CMD ["/app/mail-sink"]

Makefile

@@ -0,0 +1,44 @@
+# Makefile for Mail Sink
+
+# Binary name
+BINARY_NAME=mail-sink
+VERSION=$(shell git describe --tags --always)
+COMMIT=$(shell git rev-parse --short HEAD)
+
+# Default target
+.PHONY: all
+all: $(BINARY_NAME)
+
+# Build Go binary (depends on UI being built)
+$(BINARY_NAME): main.go go.mod ui/dist
+	@echo "Building Mail Sink..."
+	go build -ldflags "-X github.com/recrsn/mail-sink/internal/version.GitCommit=$(COMMIT) -X github.com/recrsn/mail-sink/internal/version.Version=$(VERSION)" -o $(BINARY_NAME)
+
+# UI build - only rebuilds if src files are newer than dist
+ui/dist: ui/src/**/* ui/package.json ui/vite.config.ts
+	@echo "Building UI..."
+	cd ui && npm install && npm run build
+	@touch ui/dist
+
+# Clean build artifacts
+.PHONY: clean
+clean:
+	@echo "Cleaning up..."
+	rm -f $(BINARY_NAME)
+	rm -rf ui/dist
+
+# Run tests
+.PHONY: test
+test:
+	@echo "Running tests..."
+	go test -v ./...
+
+# Help target
+.PHONY: help
+help:
+	@echo "Mail Sink Makefile"
+	@echo ""
+	@echo "Targets:"
+	@echo "  all       - Build the entire application (default)"
+	@echo "  clean     - Remove build artifacts"
+	@echo "  test      - Run all tests"

README.md

@@ -0,0 +1,93 @@
+# Mail Sink
+
+A simple SMTP server for testing email flows locally. It provides a REST API to access received emails and includes a web UI.
+
+## Features
+
+- SMTP server that captures all incoming emails
+- Parses email content including HTML, plain text, and attachments
+- REST API to retrieve emails and clear the mailbox
+- Web UI for viewing and managing emails
+- Single binary deployment with embedded UI
+
+## Usage
+
+### Building
+
+You can use the provided Makefile to build both the UI and the Go binary in one step:
+
+```bash
+# Build everything
+make
+
+# Or separately
+cd ui
+npm install
+npm run build
+cd ..
+go build -o mail-sink
+```
+
+### Running
+
+Using the Makefile:
+
+```bash
+# Run with default settings
+make run
+
+# Run with custom ports
+make run-custom SMTP_PORT=2525 HTTP_PORT=3000
+```
+
+Or directly:
+
+```bash
+# Run with default settings
+./mail-sink
+
+# Run with custom ports
+./mail-sink --smtp-port 2525 --http-port 3000
+```
+
+### Development
+
+To run the UI in development mode with hot reloading:
+
+```bash
+# Start the Go server
+./mail-sink
+
+# In another terminal, start the UI development server
+cd ui
+npm run dev
+```
+
+This will start the UI development server that proxies API requests to the Go backend.
+
+### Command line options
+
+- `--smtp-port PORT`: SMTP server port (default: 1025)
+- `--http-port PORT`: HTTP server port (default: 8080)
+- `--help`: Show help
+
+## API
+
+The following API endpoints are available:
+
+- `GET /api/emails`: Get all received emails
+- `GET /api/emails/:id`: Get a specific email by ID
+- `DELETE /api/emails`: Clear all emails
+- `GET /api/info`: Get server information (ports)
+
+## SMTP Configuration
+
+To send emails to the Mail Sink, configure your email client or application with:
+
+- SMTP Server: localhost
+- SMTP Port: 1025 (or custom port)
+- Authentication: None required (all authentication attempts are accepted)
+
+## License
+
+MIT