Skip to content

Hussain-7/linkvault

Repository files navigation

🔐 LinkVault

Save, tag, and organize the media you love across YouTube, Instagram, courses, and more. LinkVault keeps everything in one place with collections, tags, and a short note for why you saved it there.


🚀 Live Demo

The app is live at https://yourlinkvault.com/


✨ Features

  • 🔑 Google sign-in with Supabase Auth
  • 🗄️ Prisma + Postgres for collections and links
  • 🎛️ Media type filtering, tags, and search
  • 📱 Mobile-first, responsive UI
  • 📲 PWA install + Android share target support

💡 Suggested Features

Ideas on the roadmap for future development:

  1. 🤖 AI-Powered Summaries — Automatically generate a summary of saved links using AI
  2. 🧩 Browser Extension — Save links directly from Chrome, Firefox, or Safari with one click
  3. 📥 Import from Other Apps — Migrate your library from Pocket, Notion, or Raindrop.io
  4. 📊 Reading/Watch Progress Tracking — Track how far you've gotten through articles and videos
  5. 🔔 Reminders & Notifications — Get nudged to revisit links you've been putting off
  6. 🖼️ Link Preview Cards — Rich Open Graph previews with thumbnails, titles, and descriptions
  7. 🔍 Full-Text Search — Search inside the content of saved pages, not just titles and tags
  8. 👥 Shared Collections — Collaborate on collections with friends or teammates
  9. 🍎 iOS Share Sheet Support — Save links from any iOS app via the native share sheet
  10. 🔁 Duplicate Detection — Automatically detect and merge duplicate saved links

🛠️ Setup

  1. Create a Supabase project.
  2. Enable Google OAuth in Supabase Auth (set your Google client ID and secret).
  3. Copy .env.local.example to .env.local and fill in:
    • NEXT_PUBLIC_SUPABASE_URL
    • NEXT_PUBLIC_SUPABASE_ANON_KEY
    • DATABASE_URL
    • DIRECT_URL
  4. Prisma reads .env, so also create .env with DATABASE_URL and DIRECT_URL.
  5. Run Prisma migrations.
  6. Start the dev server.
npm install
npx prisma migrate dev --name init
npm run dev

Open http://localhost:3000.


🤖 MCP Integration

LinkVault exposes an MCP server for authenticated agent access:

  • Endpoint: /api/mcp
  • OAuth resource metadata: /.well-known/oauth-protected-resource

Setup and client integration details are documented in docs/mcp.md.


🤖 Android / Play Store

See docs/playstore-twa.md for TWA packaging and Play Store release steps.

About

Save, tag, and organize links, videos, courses, and other media into searchable collections.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages