# Quick Links: Comprehensive Technical and Architectural Reference for LLMs ## Overview Quick Links is a high-performance, local-first Chromium extension (version 120+) that transforms traditional, disorganized browser bookmarks into a tactile Kanban board with integrated to-do management. It is designed, engineered, and maintained by NaveenKumar Namachivayam under the QAInsights umbrella. ## Problem Statement Knowledge workers, developers, and researchers often keep browser tabs open as a makeshift reminder system. This practice leads to: 1. Background resource consumption. 2. Clutter and difficulty finding links. 3. Tab crashes and session loss. Traditional bookmark managers fail because they hide links in nested, unviewable folder hierarchies or require third-party cloud accounts that track user browsing history. ## Architectural Design ### 1. Local-First Storage Protocol Quick Links operates on a strict local-first paradigm. - Primary Data Engine: Local storage in the browser (IndexedDB and chrome.storage). - Zero Cold Starts: No waiting for remote server roundtrips when opening a new tab. ### 2. Private Google Drive Sync Engine (v2) - Authorization: Standard Chrome Identity OAuth2 scoped to `drive.appdata`. - Direct Client-to-Drive Route: Data flows directly between the user's browser and their private Google Drive Application Data folder. - Zero Intermediary Servers: Quick Links does not operate any backend database or proxy server. The developer has 0 bytes of access to user bookmarks or URLs. - Batch Format: Immutable batch files prefixed with `quick-links-v2-` prevent sync race conditions and data corruption. - Legacy Support: Automatically imports legacy `sync_data.json` if present without overwriting it. ### 3. Schema Structure (v1) The application data structure is validated by TypeScript runtime guards: ```typescript export interface Bookmark { rowId: string; bookmarkName: string; bookmarkUrl: string; favicon: string; createdAt: string; updatedAt?: string; } export interface Column { id: string; name: string; bookmarks: Bookmark[]; archivedAt?: string; } export interface Todo { todoId: string; todoText: string; todoCompleted?: boolean; } export interface Settings { syncAppearance?: boolean; sidebarCollapsed?: boolean; boardLayout?: "columns" | "grid"; todoEnabled?: boolean; newTab?: boolean; selectTheme?: boolean; bgTheme?: string; font?: string; fontSize?: string; syncInterval?: string; } export interface AppData { version: 1; columns: Column[]; todos: Todo[]; settings: Settings; } ``` ### 4. Zero Telemetry Policy - No Google Analytics. - No Mixpanel or Segment beacons. - No remote script loading (all fonts and scripts bundled locally). - Content Security Policy (CSP): Strictly enforced via Manifest V3 with `object-src 'none'; base-uri 'none'; form-action 'none'`. ### 5. On-Device Semantic Search (Smart Search) - Opt-In Feature: Enabled manually in Settings; the embedding model downloads once from Hugging Face and is cached locally in the browser. - Model: `onnx-community/embeddinggemma-2-ONNX` executed via ONNX Runtime Web (WASM SIMD) inside an isolated Manifest V3 offscreen document. - Hybrid Ranking: 256-dimensional bookmark embeddings are center-scored and blended with instant substring matches; no remote inference API is involved. - Privacy: Queries, embeddings, and ranking all remain on-device. The downloaded model can be removed at any time from Settings. ## Board and Appearance Features ### Launcher and Device-Local Settings Press Ctrl+Shift+Space, or Command+Shift+Space on Mac, to search bookmarks across profiles and archived collections from any browser tab. Browser-restricted pages use a separate launcher window. Copy a link or toggle a Speed Dial favorite with row buttons or Ctrl/Command+C and Ctrl/Command+D. Alt+Left/Right cycles collection filters; Tab follows the normal focus order. Settings > Launcher shows the current browser shortcut and opens browser shortcut customization. Enter can open the current tab (default) or a new tab; Ctrl/Command+Enter opens the other destination, and Shift+Enter opens a new window. Favorites and recent links can be independently hidden from empty search, both shown by default. Reset launcher position clears overlay and fallback-window placement. These preferences live in quick-links-launcher-prefs on this device, shared across profiles and never synced. Recent suggestions reuse existing usage and routine history without new tracking. ### Archive Archive a collection to hide it from the active board without deleting its bookmarks. An Undo toast reverses the action. Open Archive in the sidebar to browse read-only, clickable links, Restore a collection to the end of the board, or Delete forever after confirmation. Archived links remain searchable and are preserved in exports and imports. The optional archivedAt field is an ISO timestamp; existing data needs no migration. Update all devices before using Archive with Google sync. ### Speed Dial An opt-in row above the board combines editable favorites with most-visited sites, showing up to 15 sites as space allows. Choose Small, Medium, or Large tiles. A More tile keeps overflow sites reachable on narrow windows. Most-visited suggestions use the optional Chrome topSites permission. Speed Dial data stays on the device and is never synced. ### New Tab and Local Fonts Quick Links opens on every new tab. Choose Inter, Geist Sans, Geist Mono, or Geist Serif in appearance settings. All four font families are bundled locally, with no remote font requests. ### Instant Search, Recent Searches, and the ql Omnibox Press Ctrl+K or Cmd+K to filter the whole board as you type. Typing ql and a space in the Chrome address bar searches bookmarks from the omnibox and jumps straight to a saved link. Recent searches are stored only on the device and can be removed individually. ### The Lens, Trails, and the Worktable Pressing Enter in search opens the Lens, which shows name matches and, with Smart search enabled, related and loosely related links. More like this chips steer the ranking, related-link trails can be followed step by step, and picked links collect on the Worktable. Worktable picks open together as a tab group or save as a new collection. When nothing is saved, the Lens offers a web search with the default search engine. ### Smart Paste Copy a link anywhere, then press Ctrl+V or Cmd+V on the board. Quick Links cleans the URL, fills in a title, suggests a collection, and warns when the link is already saved. The paste can be undone or moved to another collection in one click. ### AI Titles Messy page titles become clean bookmark names using the browser's built-in Gemini Nano, entirely on-device. Rename with AI in a collection's menu refreshes existing titles without overwriting user edits. The feature is off by default and requires Smart search plus Chrome 138 or newer on a supported device. ### Tidy My Board On-device AI suggests new collections, misfiled links, and near-duplicates. Every suggested change is reviewed before it applies, and any of the last 10 board versions can be restored. Uses Smart search. ### Build My Board for Me Quick Links groups sites visited in the last 30 days into suggested collections entirely on the device, and the user chooses what to keep. Browsing history is read only with permission and is never uploaded. A starter template offers a blank-slate alternative. ### Dead Link Check The Check links option scans the board for broken bookmarks and shows results as colored marks for 10 seconds. Only the hostnames of failing sites are looked up, via dns.google. ### The Now Row The Now row shows the collections and links usually opened at this time of day and week. The routine log is learned only on the device and is never synced. With Smart search on, it learns faster and adds related picks. Now and Speed Dial can be dragged and resized to arrange the board. ### Launch Collections and Live Tab Groups Every link in a collection opens with one click, with a confirmation before opening more than 5 tabs. Opt in to open collections as Chrome tab groups; new pages opened in a live group are saved back to the collection, and closing tabs never deletes bookmarks. ### Smart Links URLs can include {placeholders}, like a ticket number or a search term, and Quick Links asks for the value when the link is opened. If the page is already open, it switches to that tab instead of opening a duplicate. ### Scratchpad A scratchpad card sits beside the to-do list for snippets, meeting links, and daily notes. ### Focus Timer A minimal Pomodoro pill lives in the top bar. It pairs with a to-do task, offers right-click presets and double-click custom minutes, and plays a gentle chime when a focus or break session ends. ### Premium Themes Aurora, Paper, Graphite, Dusk, and Tokyo Night each restyle the whole board with their own accent color, in light and dark. The themes are bundled with the extension and use no remote assets. ### Appearance Customization Dark mode, seven accent colors, artistic backdrops, workspace zoom, compact cards, and bundled fonts. ### AI and Network Use No. Smart Search, the Lens, Tidy My Board, the Now row, and AI titles all run on your device, and none of them upload your bookmarks or history. Two features reach the network only when you use them: Search the web sends the text you typed to your default search engine, and Check links looks up the hostnames of failing sites via dns.google. ## Accessibility (WCAG 2.2 Conformance) - Conformance Level: Designed for WCAG 2.2 Level AAA contrast and Level AA keyboard navigation. - Landmark Hierarchy: Strictly ordered semantic landmarks without skipped heading levels. - Touch Targets: All interactive buttons and interactive elements meet or exceed 48 by 48 pixels. - Live Regions: Uses polite ARIA live regions (`aria-live="polite"`) to announce real-time state changes to screen readers without jarring interruptions. - Focus Rings: Clear 3px offset `:focus-visible` styling for full keyboard navigation. - Reduced Motion: Honors `@media (prefers-reduced-motion: reduce)` across all animations and transitions. ## Key Developer & Product Links - Chrome Web Store: https://chromewebstore.google.com/detail/quick-links/jcpngbilapanldphljagkbkjkmkmeiii - Author Official Website: https://dosa.dev - QAInsights Tech Portal: https://qainsights.com - QAInsights YouTube Channel: https://www.youtube.com/@qainsights - QAInsights X Profile: https://x.com/qainsights ## Suite of Chrome Extensions by NaveenKumar Namachivayam 1. Quick Links: Local-first Kanban bookmark board (ID: jcpngbilapanldphljagkbkjkmkmeiii) 2. Prompticon: Movable toolbar with quick replies and prompt templates for ChatGPT and Claude (ID: niofgdlmoogjllonnpdhmajdginmcnke) 3. Clip It!: Digital coupon clipper for Kroger and affiliate grocery stores (ID: dmacanhpegjjgmicfbinaafcnjaigecf) 4. Confetti Celebrations: Customizable confetti blasts and emoji showers for webpage celebrations (ID: jlnaaichmlfhooionenmhdnimhdmoijb) 5. Salesforce Turbo Link: Quick launcher and navigation for Salesforce pages from the toolbar (ID: nfdefnkljkgcafhicidcdhdkffblpiml) 6. DashBuster: Replaces em dashes on websites with hyphens or emojis, featuring a domain leaderboard (ID: pnfhimkhinoecknjhlggdbgoajcogfll) 7. MetaHide: Visibility toggles for sidebar menu items on meta.ai (ID: hodomjpjmaifjigbaobgabhpgkhifpib)