How frankji1019/remind-me works
remind-me is a self-hosted daily briefing system: a scheduled Lambda gathers Notion tasks and Google Calendar events, assembles template data, and sends an SES email. Its React admin portal previews email and themes, manages schedule and configuration, and displays delivery statistics and run logs through an HTTP API. The README documents the service relationships; sampled portal source shows routing and selected page-to-hook wiring. Other portal endpoint mappings are not shown, so those links are left unasserted.
Main entry points: App.tsx Portal routing · api-hooks API hooks · remind-me.ts Briefing orchestrator · assemble-email.ts Email assembler
Components 26
Briefing delivery
- Briefing orchestrator
service-functions/src/remind-me.ts - Email assembler
service-functions/src/assemble-email.ts
Briefing inputs
- Todo retrieval
service-functions/src/get-todos.ts - Calendar retrieval
service-functions/src/get-calendar.ts
Admin services
- Parameter management
service-functions/src/manage-ssm.ts - Schedule management
service-functions/src/email-schedule.ts - Delivery statistics
service-functions/src/email-stats.ts - Run log summaries
service-functions/src/email-logs.ts - Template selection
service-functions/src/email-template.ts
Admin portal
- Portal routing
admin-portal/src/App.tsx - Portal shell
admin-portal/src/containers/Page/index.tsx - API hooks
admin-portal/src/api-hooks - Email preview
admin-portal/src/pages/EmailPreviewPage/EmailPreviewPage.tsx - Theme selection
admin-portal/src/pages/ThemesPage/ThemesPage.tsx - Statistics view
admin-portal/src/pages/StatsPage/StatsPage.tsx - Logs view
admin-portal/src/pages/LogsPage/LogsPage.tsx - Settings view
admin-portal/src/pages/SettingsPage/SettingsPage.tsx - Preview sample data
admin-portal/src/utils/mockTemplateData.ts
Other components
- Daily schedule
- AWS SES
- SES templates
service-functions/ses-templates - Notion API
- Google Calendar API
- SSM Parameter Store
- HTTP API
- Administrator
Connections 29
- Daily schedule → Briefing orchestrator: triggers daily
- Briefing orchestrator → Email assembler: invokes
- Email assembler → Todo retrieval: fetches tasks
- Email assembler → Calendar retrieval: fetches events
- Todo retrieval → Notion API: queries
- Calendar retrieval → Google Calendar API: fetches events
- Briefing orchestrator → AWS SES: sends email
- Briefing orchestrator → SES templates: uses selected design
- Email assembler → SES templates: renders preview
- Parameter management → SSM Parameter Store: manages parameters
- Schedule management → HTTP API: serves schedule operations
- Delivery statistics → HTTP API: serves statistics
- Run log summaries → HTTP API: serves run summaries
- Template selection → SSM Parameter Store: reads and writes selection
- Template selection → HTTP API: serves template operations
- Administrator → Portal routing: uses
- Portal routing → Portal shell: renders shell
admin-portal/src/App.tsx - Portal routing → Email preview: routes to
admin-portal/src/App.tsx - Portal routing → Theme selection: routes to
admin-portal/src/App.tsx - Portal routing → Statistics view: routes to
admin-portal/src/App.tsx - Portal routing → Logs view: routes to
admin-portal/src/App.tsx - Portal routing → Settings view: routes to
admin-portal/src/App.tsx - Email preview → API hooks: uses email and schedule data
admin-portal/src/pages/EmailPreviewPage/index.tsx - Theme selection → API hooks: loads and applies templates
admin-portal/src/pages/ThemesPage/index.tsx - Statistics view → API hooks: receives statistics
admin-portal/src/pages/StatsPage/index.tsx - Logs view → API hooks: receives run logs
admin-portal/src/pages/LogsPage/index.tsx - Settings view → API hooks: loads settings
admin-portal/src/pages/SettingsPage/index.tsx - API hooks → HTTP API: requests data
- Theme selection → Preview sample data: renders sample preview
admin-portal/src/pages/ThemesPage/ThemesPage.tsx