MCPcopy Index your code
hub / github.com/denho/faved

github.com/denho/faved @v2.9.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.9.1 ↗ · + Follow
575 symbols 1,481 edges 174 files 7 documented · 1%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Faved

A private open-source bookmark manager built to handle large collections and advanced use cases. Optimized for ease-of-use and efficiency.

🧪 Try Live Demo | 🌐 Visit Website | 📖 Read the Docs

📚 Blog | 𝕏 Twitter | 💬 Discord

screenshot-list-desktop-mobile-safari

Features

🏷️ Advanced Tagging

  • Organize bookmarks with nested tags for structured grouping (e.g., place Go and Python under Programming Languages → Backend)
  • Customize tags with color and description (icons — coming soon)
  • Search and filter tags directly from the sidebar
  • Optional tag rollup to include items from child tags
  • Pin frequently used tags for quick access

🤖 Smart Bookmark Management

  • Automatic fetching of titles, descriptions, and preview images
  • Duplicate detection when adding bookmarks
  • Automated tagging (planned)

⚡ Powerful UI Designed for Efficiency

  • All major actions — bookmark and tag search, filtering, and editing — in one click away with no need to navigate between screens
  • Fully responsive — works perfectly on mobile, tablet, and desktop
  • Installable as a PWA for an app-like, near-native experience on mobile
  • System-synced Light/Dark mode
  • Instant search and flexible sorting
  • Bulk actions (deleting, refetching, tagging)
  • Customizable layouts (card/list/table), fields, and sidebar

🔗 Integrations

  • Lightweight browser bookmarklet — save securely from any browser without extensions
  • Apple Shortcuts — integrate into native share sheet on iOS/MacOS/iPadOS
  • Browser extensions (planned)

📥 Import & Migration

  • Import from Chrome, Safari, Firefox, Edge with the original folder structure preserved thanks to nested tags
  • Migrate from Raindrop.io, Pocket, and other tools retaining original collections, tags and other data

Overview video

https://github.com/user-attachments/assets/0ecbf26a-9ed8-49d9-a5ce-33d471c06fdf

Get started

  • Self-host for free with no external dependencies. All data is stored locally.
  • Start in the Cloud with zero setup, automatic backups and support. Your data is secured with encryption.

Documentation

Project Structure

  • /controllers: Application controllers
  • /frontend: React frontend source files
  • /framework: Core framework components
  • /models: Data models
  • /public: Web-accessible files
  • /storage: Database storage
  • /utils: Utility classes
  • /views: HTML templates

License

This project is licensed under the MIT License.

Credits

Faved uses only open source packages:

  • TypeScript, React, Tailwind, Shadcn UI and Vite for the frontend.
  • PHP 8, SQLite and Apache for the backend.

Extension points exported contracts — how you extend this code

ControllerInterface (Interface)
(no doc)
framework/ControllerInterface.php
ResponseInterface (Interface)
(no doc)
framework/Responses/ResponseInterface.php
DataTableToolbarProps (Interface)
(no doc)
frontend/src/components/Table/Controls/Search.tsx
DataTablePaginationProps (Interface)
(no doc)
frontend/src/components/Table/Controls/Pagination.tsx
EditItemFormProps (Interface)
(no doc)
frontend/src/components/EditItem/EditItemForm.tsx
SetupWrapperProps (Interface)
(no doc)
frontend/src/layouts/Onboarding.tsx

Core symbols most depended-on inside this repo

cn
called by 194
frontend/src/lib/utils.ts
get
called by 53
framework/ServiceContainer.php
data
called by 24
framework/helper-functions.php
success
called by 17
framework/helper-functions.php
buildLink
called by 11
frontend/src/components/Settings/SettingsAbout.tsx
useSidebar
called by 11
frontend/src/components/ui/sidebar.tsx
userTableNotEmpty
called by 8
models/Repository.php
createTag
called by 8
models/TagCreator.php

Shape

Function 382
Method 130
Class 56
Interface 6
Enum 1

Languages

TypeScript63%
PHP37%

Modules by API surface

models/Repository.php32 symbols
frontend/src/components/ui/sidebar.tsx25 symbols
utils/util-functions.php22 symbols
frontend/src/components/ui/combobox.tsx16 symbols
frontend/src/components/ui/dropdown-menu.tsx15 symbols
framework/helper-functions.php13 symbols
frontend/src/lib/utils.ts11 symbols
frontend/src/components/ui/alert-dialog.tsx11 symbols
frontend/src/components/ui/sheet.tsx10 symbols
frontend/src/components/ui/select.tsx10 symbols
frontend/src/components/ui/item.tsx10 symbols
frontend/src/components/ui/field.tsx10 symbols

For agents

$ claude mcp add faved \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page