Skip to content

dd3v/favbox

Repository files navigation

FavBox

issues ver license love

FavBox Light Theme FavBox Dark Theme

FavBox is a local-first experimental browser extension that enhances and simplifies bookmark management without cloud storage or third-party services. It extends your browser's native bookmarking features.

Key features:

πŸ”„ Syncs with your browser profile
πŸ”’ No third‑party data sharing. No ads. No tracking.
🎨 Minimalist, clean UI
🏷️ Tag support for easy organization
πŸ” Advanced search, sorting, and filtering by tags, domains, folders, and keywords
🌁 Multiple display modes
πŸŒ— Light and dark themes
πŸ—‘οΈ Detects broken and duplicate bookmarks
⌨️ Hotkeys for quick search access
πŸ—’οΈ Local notes support
❀️ Free and open source

Concept

image

Implementation

FavBox scans all bookmarks in the browser, then makes requests to the saved pages and extracts data from them such as title, description, image, and meta tags to improve the search. All the data is stored in local storage IndexedDB. The extension also tracks all browser events related to bookmarks and synchronizes the data. It only extends the standard functionality and does not attempt to replace it. You can work with bookmarks both through the extension and the native browser’s built-in bookmark features.

FavBox is a fully local application. To keep tags synced across devices, it uses a trick. Since bookmarks are synchronized between devices, to keep tags synchronized, the app adds them to the page title.

For example, if you have a bookmark titled Google Chrome β€” Wikipedia, to save tags across devices, extension appends them to the title like this: Google Chrome β€” Wikipedia 🏷 #wiki #browser

This way, your tags become available on other devices without using any cloud services β€” only through the standard Google Chrome profile sync.

β”œβ”€β”€ public                 # Static assets (icons, etc.)
β”‚   └── icons
β”œβ”€β”€ src                    # Source code
β”‚   β”œβ”€β”€ assets             # Global styles
β”‚   β”œβ”€β”€ components         # Shared UI components
β”‚   β”‚   └── app
β”‚   β”œβ”€β”€ composables        # Vue composables
β”‚   β”œβ”€β”€ constants          # Application constants
β”‚   β”œβ”€β”€ ext                # Browser extension
β”‚   β”‚   β”œβ”€β”€ browser        # FavBox main app
β”‚   β”‚   β”‚   β”œβ”€β”€ components
β”‚   β”‚   β”‚   β”œβ”€β”€ layouts
β”‚   β”‚   β”‚   └── views
β”‚   β”‚   β”œβ”€β”€ content        # Content scripts
β”‚   β”‚   β”œβ”€β”€ popup          # Extension popup
β”‚   β”‚   └── sw             # Service worker
β”‚   β”œβ”€β”€ parser             # HTML metadata parser
β”‚   β”œβ”€β”€ services           # Utility services (HTTP client, bookmarks API, tags, hash)
β”‚   └── storage            # IndexedDB storage
β”‚       └── idb
└── tests
    β”œβ”€β”€ integration
    └── unit

Permissions

Permission Why needed
bookmarks Read and manage bookmarks
activeTab Capture page screenshot for visual previews
tabs Get current tab info when saving bookmarks
storage Store sync status and extension settings
alarms Keep service worker alive for background sync
contextMenus Add "Save to FavBox" to right-click menu
<all_urls> Fetch page metadata (title, description, favicon)

Building

  1. pnpm run build to build into dist
  2. Enable dev mode in chrome://extensions/ and Load unpacked extension

Commands

  • dev Start development server
  • dev:firefox Firefox development build (WIP)
  • build Production build
  • test:unit Run unit tests
  • test:integration Run integration tests

TODO

  • Use SQLite Wasm for storage (ideal for future experiments)
  • Improve transaction implementation (ensure reliability & better performance)
  • The extension already uses a polyfill to maintain compatibility with other browsers. It would be good to test this in Firefox. (WIP)