How ibrahimmurtaza/brieflyy works
Brieflyy is a topic-personalized news briefing SaaS: users sign in, choose topics and delivery preferences, then receive clustered, summarized content in an in-app feed and scheduled email briefs. The graph preserves the main ingest-to-brief stages and the documented Discover, trends, archive, feedback, and account capabilities. Evidence is limited to the README and indexed/read excerpts; unsampled subsystem links are omitted where no caller relationship is shown.
Main entry points: app.ts App routes · pages/routes.ts Brief feed · auth/routes.ts Sign-in routes · ingest-service.ts Feed processing
Components 26
Accounts & setup
- Sign-in routes
src/auth/routes.ts - Authentication
src/auth/auth-service.ts - Google OAuth
src/oauth/google-client.ts - Setup routes
src/onboarding/routes.ts - Topic setup
src/onboarding/onboarding-service.ts
Content pipeline
- Ingest scheduler
src/ingest/ingest-scheduler.ts - Registry ingest
src/ingest/registry-ingest-service.ts - Feed processing
src/ingest/ingest-service.ts - Cluster formation
src/services/cluster-formation-service.ts
Briefs & delivery
- Brief feed
src/pages/routes.ts - Brief planning
src/services/brief-plan-service.ts - Scheduled briefs
src/services/scheduled-brief-service.ts - AI summaries
src/services/llm-summary-service.ts - Email transport
src/email/transport.ts
Discovery & insights
- Recommendations
src/discover/routes.ts - Topic trends
src/trends/routes.ts - Trend analysis
src/services/trends-service.ts - Archive search
src/services/archive-search-service.ts - Reader feedback
src/services/feedback-service.ts
HTTP & persistence
- Server bootstrap
src/server.ts - App routes
src/app.ts - SQLite database
src/db/client.ts - Topic repository
src/repos/topic-repo.ts - Content repositories
src/repos - Shared page shell
src/pages/shell.ts
Other components
- Reader
Connections 30
- Reader → Server bootstrap: opens app
README.md - Server bootstrap → App routes: creates routes
src/server.ts - App routes → Sign-in routes: registers
src/app.ts - Reader → Sign-in routes: signs in
README.md - Sign-in routes → Authentication: requests auth
src/auth/routes.ts - Authentication → Google OAuth: uses provider
src/auth/auth-service.ts - Sign-in routes → Setup routes: continues setup
- Setup routes → Topic setup: handles setup
src/onboarding/routes.ts - Topic setup → Topic repository: stores topics
src/onboarding/onboarding-service.ts - App routes → Ingest scheduler: wires scheduler
src/app.ts - Ingest scheduler → Registry ingest: runs registry
- Registry ingest → Feed processing: delegates ingest
src/ingest/registry-ingest-service.ts - Feed processing → Content repositories: persists articles
src/ingest/ingest-service.ts - Feed processing → Cluster formation: supplies stories
- Cluster formation → Content repositories: stores clusters
- App routes → Brief feed: registers pages
src/app.ts - Reader → Brief feed: reads brief
README.md - Brief feed → Brief planning: loads plan
src/pages/routes.ts - Brief planning → Scheduled briefs: feeds scheduling
- Scheduled briefs → AI summaries: requests writing
- Scheduled briefs → Email transport: delivers brief
- App routes → Recommendations: registers discovery
src/app.ts - App routes → Topic trends: registers trends
src/app.ts - Topic trends → Trend analysis: loads analysis
src/trends/routes.ts - App routes → Archive search: wires search
src/app.ts - Brief feed → Archive search: searches archive
src/pages/routes.ts - Brief feed → Reader feedback: records signals
src/pages/routes.ts - Server bootstrap → SQLite database: opens database
src/server.ts - Topic repository → SQLite database: queries
src/repos/topic-repo.ts - Brief feed → Shared page shell: resolves account
src/pages/routes.ts