PathFind

PathFind is a premium, self-hosted, AI-assisted personal bookmark and collection manager. Built with Next.js 16 and Tailwind CSS 4, it provides a centralized, beautiful space to collect, organize, and instantly retrieve links, articles, and media from across the web.

---

🌐 The PathFind Ecosystem

PathFind is more than just a web app. It's a complete cross-platform bookmarking solution:

• PathFind Web: The core self-hosted server and dashboard.
• PathFind Extension: Browser extension for Chrome, Edge, and Firefox.
• PathFind iOS: Native SwiftUI mobile app for iPhone.
• PathFind Android: Native Kotlin & Compose mobile app.

---

✨ Features

• 🧠 AI-Powered Insights: Integrates with Google Gemini to automatically summarize content, extract key points, and suggest organization.
• 🖼️ Rich Media Clipping: Automatically fetches high-quality thumbnails, favicons, and metadata for every link you save.
• 🔍 Lightning-Fast Search: Instant full-text search (FTS5) across titles, descriptions, and notes.
• 📁 Organized Collections: Create custom collections and use nested tags to keep your digital life structured.
• 📥 Smart Workflows: Built-in "Read Later" and "Archive" states to help you manage your digital consumption.
• 🤖 Automations:
  • GitHub Sync: Automatically import your starred repositories.
  • Reddit Sync: Keep track of your saved Reddit posts via RSS.
  • Telegram Bot: Save links via a dedicated Telegram bot on the go.
• 📱 PWA Ready: Install PathFind as an app on your phone with native share sheet integration.

---

🚀 Getting Started

Option 1: Docker (Recommended)

1. Clone the repository:

   git clone https://github.com/dnlnm/pathfind.git
   cd pathfind

2. Configure your environment:

   cp .env.sample .env
   # Edit .env with your ADMIN_EMAIL, ADMIN_PASSWORD, and AI keys

3. Launch:

   docker-compose up -d

4. Access at http://localhost:3000.

Option 2: Local Development

1. Install dependencies:

   npm install

2. Setup environment: Create a .env file (refer to .env.sample).
3. Run development server:

   npm run dev

---

🛠 Tech Stack

• Framework: Next.js 16 (App Router)
• Styling: Tailwind CSS 4 & Shadcn UI
• Database: SQLite via better-sqlite3 (with sqlite-vec for embeddings)
• Auth: Auth.js (NextAuth)
• AI: Google Generative AI (Gemini)
• PWA: @ducanh2912/next-pwa

---

🤝 Contributing

We welcome contributions! Please feel free to open issues or submit pull requests.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.