How lucasotw/sextant works
Sextant is a web app for finding and exploring scholarly literature. The main journey runs from search and topic browsing to an article page, where readers can inspect metadata, access an open PDF, get an optional AI summary, and follow related works. Signed-in readers can save articles into lists, annotate them, and revisit highlights and citations; recommendations and MCP access extend that library. The README documents several capabilities whose implementation was not sampled, so those subsystem links are shown at the documented level rather than as inferred internal call chains.
Main entry points: openalex.ts OpenAlex client · [id]/page.tsx Article page · route.ts Library APIs · search/page.tsx Search interface
Components 24
Search & discovery
- Search interface
src/app/search/page.tsx - Search suggestions
src/components/search-box.tsx - Suggestion API
src/app/api/suggest/route.ts - Topic browsing
src/app/theme/[slug]/page.tsx - Personal recommendations
src/app/api/recommendations/route.ts
Article reading
- Article page
src/app/article/[id]/page.tsx - Author details
src/components/author-chip.tsx - Open PDF access
src/app/api/pdf/route.ts - AI summary
src/app/api/summary/route.ts
Personal library
- Highlights & citations
src/components/highlights/article-highlights.tsx - Article notes
src/components/notes/article-note.tsx - Favorites interface
src/components/favorites/favorites-provider.tsx - Saved lists
src/components/collections/collection-dialog.tsx - Library APIs
src/app/api/favorites/route.ts - Collection API
src/app/api/collections/route.ts
Accounts & access
- Sign-in interface
src/components/auth/auth-button.tsx - Session API
src/app/api/auth/session/route.ts - Session verification
src/lib/auth.ts
Server services
- Firestore access
src/lib/firebase/admin.ts - OpenAlex client
src/lib/openalex.ts - API guards
src/lib/api/guard.ts - MCP integration
src/app/api/mcp/route.ts
Other components
- Reader
- Mistral AI
Connections 30
- Reader → Search interface: searches
- Reader → Topic browsing: browses
- Reader → Article page: opens work
- Search interface → Search suggestions: accepts query
- Search suggestions → Suggestion API: requests suggestions
src/components/search-box.tsx - Search interface → OpenAlex client: searches works
- Topic browsing → OpenAlex client: loads topic works
- Article page → Author details: shows author
- Article page → Open PDF access: requests PDF
- Open PDF access → OpenAlex client: looks up work
src/app/api/pdf/route.ts - Article page → AI summary: requests summary
- AI summary → OpenAlex client: loads work
src/app/api/summary/route.ts - AI summary → Mistral AI: generates summary
- Reader → Highlights & citations: annotates reading
- Reader → Article notes: writes notes
- Reader → Favorites interface: saves works
- Favorites interface → Library APIs: syncs favorites
- Reader → Saved lists: organizes favorites
- Saved lists → Collection API: manages lists
- Library APIs → Session verification: reads session
src/app/api/favorites/route.ts - Library APIs → Firestore access: stores favorites
- Collection API → Firestore access: stores lists
- Sign-in interface → Session API: opens session
- Session API → Session verification: verifies identity
src/app/api/auth/session/route.ts - Session verification → Firestore access: checks account
src/lib/auth.ts - Library APIs → API guards: guards writes
src/lib/api/guard.ts - Reader → Personal recommendations: explores suggestions
- Personal recommendations → OpenAlex client: ranks works
src/app/api/recommendations/route.ts - Reader → MCP integration: connects library
- MCP integration → API guards: checks requests
src/app/api/mcp/route.ts