How ayushsoni02/linknest works
LinkNest is a web-based second brain for saving links, organizing them into Nests, and rediscovering or sharing them. The principal flow is: a signed-in user submits a URL, previews and saves it, then browses content by collection or asks a Nest-specific AI question. The graph also includes authentication, public sharing, and documented search/filter capabilities. Backend excerpts are partial, so unsampled route internals and frontend wiring are represented only where the README or sampled code supports them.
Main entry points: index.ts API routes · auth.ts Auth routes · db.ts Data models · App.tsx LinkNest app
Components 21
Browser app
- LinkNest app
MindVault-FE/src/App.tsx - Dashboard
MindVault-FE/src/Pages/Dashboard.tsx
Identity
- Sign-in pages
MindVault-FE/src/Pages/Signin.tsx - Google sign-in
MindVault-FE/src/components/OAuth/GoogleOAuthButton.tsx - OAuth callback
MindVault-FE/src/Pages/OAuthCallback.tsx - Auth routes
MindVault-BE/src/auth.ts - JWT middleware
MindVault-BE/src/middleware.ts
Link capture
- Link preview
MindVault-FE/src/components/PreviewModal.tsx - Content client
MindVault-FE/src/services/contentService.ts - Metadata extraction
MindVault-BE/src/metadataExtractor.ts
Nests and sharing
- Nest workspace
MindVault-FE/src/Pages/NestWorkspace.tsx - Nest client
MindVault-FE/src/hooks/useNests.tsx - Nest RAG chat
MindVault-BE/src/index.ts - Sharing routes
MindVault-BE/src/index.ts
Backend and AI
- API routes
MindVault-BE/src/index.ts - AI service
MindVault-BE/src/services/aiService.ts - Data models
MindVault-BE/src/db.ts - MongoDB
MindVault-BE/src/db.ts
Other components
- User
- Gemini AI
- Google OAuth
Connections 29
- User → LinkNest app: uses
- LinkNest app → Sign-in pages: routes to
- Sign-in pages → Auth routes: authenticates
- Auth routes → Data models: reads and writes
- LinkNest app → Google sign-in: offers
- Google sign-in → Auth routes: starts OAuth
- Auth routes → Google OAuth: redirects for sign-in
- Auth routes → OAuth callback: redirects with token
- OAuth callback → Auth routes: fetches profile
- User → Link preview: submits URL
- Link preview → Content client: requests metadata and saves
- Content client → API routes: calls content endpoints
- API routes → JWT middleware: protects routes
- API routes → Metadata extraction: extracts metadata
- API routes → AI service: generates digest and embeddings
- AI service → Gemini AI: requests AI output
- API routes → Data models: stores and retrieves content
- Data models → MongoDB: persists records
- User → Dashboard: browses links
- Dashboard → Content client: loads and manages content
- User → Nest workspace: opens collection
- Nest workspace → Nest client: manages Nests
- Nest client → API routes: calls Nest endpoints
- API routes → Sharing routes: handles public access
- Sharing routes → Data models: reads and updates sharing
- User → Nest RAG chat: asks Nest question
- Nest RAG chat → AI service: embeds query and generates answer
- Nest RAG chat → Data models: loads Nest content
- Nest RAG chat → Gemini AI: requests response synthesis