How redberryproducts/mailbox-for-laravel works
Mailbox for Laravel intercepts outgoing Laravel mail, normalizes and captures rendered messages and attachments, then exposes them through a local dashboard and a fluent assertion API. Its main runtime path is documented as transport → normalizer → capture service → stores. The graph also preserves dashboard management, search, attachment handling, optional real delivery, and testing capabilities. Some frontend and controller internals were not sampled; edges involving those areas rely on README documentation or route registrations rather than assumed component-level calls.
Main entry points: CaptureService.php Capture service · mailbox.php Mailbox routes · MailboxController.php Mailbox listing · AttachmentStore.php Attachment stores
Components 28
Mail capture
- Mailbox transport
src/Transport/MailboxTransport.php - Message normalizer
src/Support/MessageNormalizer.php - Capture service
src/CaptureService.php - Message DTO
src/DTO/MailboxMessageData.php
Persistence and search
- Store manager
src/StoreManager.php - Message store
src/Contracts/MessageStore.php - Database store
src/Storage/DatabaseMessageStore.php - File store
src/Storage/FileStorage.php - Attachment stores
src/Contracts/AttachmentStore.php - Database attachments
src/Storage/DatabaseAttachmentStore.php - File attachments
src/Storage/FileAttachmentStore.php - Message search
src/Search/DefaultMessageSearch.php
Mailbox dashboard
- Mailbox routes
routes/mailbox.php - Mailbox authorization
src/Http/Middleware/AuthorizeMailboxMiddleware.php - Mailbox listing
src/Http/Controllers/MailboxController.php - Message actions
src/Http/Controllers/SeenController.php - Delete and clear
src/Http/Controllers/DeleteMailboxMessageController.php - Attachment delivery
src/Http/Controllers/AttachmentController.php - Inline image rewriting
src/Support/CidRewriter.php - Mailbox dashboard UI
resources/js/components/mail/MailboxLayout.vue - Live polling
resources/js/composables/useMailboxPolling.ts - Test email endpoint
src/Http/Controllers/SendTestMailController.php
Email testing
- Mailbox facade
src/Facades/Mailbox.php - Collection assertions
src/Testing/MailboxAssertions.php - Message assertions
src/Testing/PendingMailboxMessageAssertion.php
Other components
- Laravel application
- Dashboard user
- Configured mailer
Connections 32
- Laravel application → Mailbox transport: sends mail through
README.md - Mailbox transport → Message normalizer: normalizes message
src/Transport/MailboxTransport.php - Mailbox transport → Capture service: captures message
src/Transport/MailboxTransport.php - Mailbox transport → Configured mailer: forwards optionally
README.md - Capture service → Message store: persists message
src/CaptureService.php - Capture service → Attachment stores: persists attachments
README.md - Capture service → Message DTO: creates DTOs
src/CaptureService.php - Store manager → Database store: resolves driver
src/StoreManager.php - Store manager → File store: resolves driver
src/StoreManager.php - Database store → Message search: applies search
src/Storage/DatabaseMessageStore.php - File store → Message search: filters messages
src/Storage/FileStorage.php - Database attachments → Attachment stores: implements contract
src/Storage/DatabaseAttachmentStore.php - File attachments → Attachment stores: implements contract
- Dashboard user → Mailbox routes: opens dashboard
README.md - Mailbox routes → Mailbox authorization: guards access
routes/mailbox.php - Mailbox routes → Mailbox listing: routes listing
routes/mailbox.php - Mailbox routes → Message actions: routes seen action
routes/mailbox.php - Mailbox routes → Delete and clear: routes management
routes/mailbox.php - Mailbox routes → Attachment delivery: routes downloads
routes/mailbox.php - Mailbox routes → Test email endpoint: routes test send
routes/mailbox.php - Mailbox listing → Capture service: lists messages
src/Http/Controllers/MailboxController.php - Mailbox listing → Inline image rewriting: rewrites inline images
src/Http/Controllers/MailboxController.php - Mailbox listing → Attachment stores: loads attachment metadata
src/Http/Controllers/MailboxController.php - Message actions → Capture service: updates read state
src/Http/Controllers/SeenController.php - Delete and clear → Capture service: deletes messages
src/Http/Controllers/DeleteMailboxMessageController.php - Attachment delivery → Attachment stores: reads attachment
src/Http/Controllers/AttachmentController.php - Mailbox listing → Mailbox dashboard UI: serves dashboard data
README.md - Mailbox dashboard UI → Live polling: refreshes list
- Test email endpoint → Capture service: sends test message
src/Http/Controllers/SendTestMailController.php - Mailbox facade → Capture service: exposes mailbox API
src/Facades/Mailbox.php - Mailbox facade → Collection assertions: dispatches assertions
src/Facades/Mailbox.php - Collection assertions → Message assertions: builds message checks