PathFind iOS

A native iOS companion app for PathFind. Built with SwiftUI and targeting iOS 26+, this app provides a world-class mobile experience for your self-hosted bookmarks.

---

🌐 The PathFind Ecosystem

• 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

• 📱 Premium SwiftUI UI: Native iOS experience with Card & Compact views, fluid animations, and SF Symbols.
• 🎨 Dynamic Thumbnails: High-quality thumbnails generated on-device using brand colors extracted from favicons.
• 📥 Share Extension: Save any URL to PathFind directly from the iOS Share Sheet with duplicate detection.
• 🔍 Native Search: Dedicated search tab leveraging iOS 26 native search APIs for instant results.
• 🔄 Infinite Scroll: Effortless browsing with pagination and pull-to-refresh support.
• 🛠️ Swipe Actions: Archive, Read Later, or Delete bookmarks with native swipe gestures.

---

🚀 Getting Started

Prerequisites

Requirement	Version
iOS	26.0+
Xcode	16.0+
Swift	6.0+
PathFind server	Any recent version

Installation

1. Clone the repository:

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

2. Open in Xcode:

   open PathFind.xcodeproj

3. Configure App Group:
   • The app uses group.pathfind.mobile to share credentials between the main app and the Share Extension.
   • Update the Team and ensure the App Group is active for both targets.

---

🛠 Tech Stack & Architecture

PathFind iOS is built with a modern, reactive architecture:

• State Management: @Observable stores injected via environment.
• Networking: Generic async/await REST client (Actor-based).
• Persistence: Shared UserDefaults suite for App Group access.
• Image Processing: Core Image for color extraction and dynamic card generation.

Directory Structure

PathFind/
├── PathFind.swift              # App entry point
├── Models/                     # Codable bookmark, Collection, Tag models
├── Services/                   # APIClient & BookmarkService
├── Stores/                     # AuthStore & BookmarkStore (@Observable)
├── Views/                      # SwiftUI Views (Main, List, Detail, Setup)
└── Extensions/                 # Shared UI tokens & Utilities

---

📄 License

MIT © dnlnm