Overview
The Bookmarks feature provides quick access to your browser’s bookmark tree directly from the Meelio new tab. It syncs with your browser’s native bookmarks and displays them in an organized, visual interface.Bookmarks requires the optional bookmarks permission. The extension will prompt you to grant this permission when you first access the bookmarks feature.
How It Works
The bookmark system:- Syncs from Browser: Reads your browser’s native bookmark tree
- Caches Locally: Stores a local copy in IndexedDB for fast access
- Auto-Refreshes: Refreshes cached bookmarks every hour or on manual refresh
- Listens for Changes: Automatically updates when you add/edit/delete bookmarks in your browser
bookmarks.store.ts:39, the cache duration:
Display Modes
Frombookmarks.store.ts:9, bookmarks can be displayed in multiple ways:
- Bar (Default)
- Sheet
- Both
Bookmarks Dynamic IslandA compact widget at the top of your new tab showing recently accessed bookmarks.From Features:
newtab.tsx:133:- Shows favorite/recent bookmarks as favicon icons
- Compact, non-intrusive display
- Quick one-click access to frequent sites
- Hovers to show bookmark name
Granting Permissions
When you first open the Bookmarks feature:Permission Prompt
You’ll see a screen saying “Bookmarks permission required” with a Grant Permission button.
Browser Prompt
Your browser will show a popup requesting permission to:
- Read and change your bookmarks
bookmarks.sheet.tsx:134-160:
bookmarks.store.ts:370-413, the permission request:
You can revoke the bookmarks permission at any time from your browser’s extension settings. Your cached bookmarks will remain visible until you clear extension data.
Viewing Bookmarks
Bookmarks Tree Structure
Frombookmarks.store.ts:49-58, Chrome bookmarks are mapped to:
Folders vs. Links
Frombookmarks.store.ts:111-143, bookmarks are separated into:
- Folders with folder icon and expand/collapse chevron
- Links with favicon (or bookmark icon fallback) and external link icon
bookmarks.sheet.tsx:207-304:
Opening Bookmarks
Click any bookmark link to open it: Frombookmarks.sheet.tsx:110-116:
- In extension: Opens in new browser tab
- Maintains your current Meelio new tab
- No navigation away from your dashboard
Bookmark Organization
Folder Navigation
Find Folder
Folders appear with a folder icon and show the number of items inside (e.g., “Work (23)”).
bookmarks.sheet.tsx:224-268:
Favicon Display
Frombookmarks.sheet.tsx:272-294, bookmarks show favicons:
Syncing Bookmarks
Automatic Sync
Frombookmarks.store.ts:282-288:
- On extension load (if cache is older than 1 hour)
- When you first grant permissions
- When cache is empty
- When you manually click refresh
Manual Refresh
From
bookmarks.sheet.tsx:174-183:
Live Updates
Frombookmarks.store.ts:545-561, the extension listens for bookmark changes:
- Create a bookmark in your browser
- Edit a bookmark title or URL
- Delete a bookmark
- Move a bookmark to a different folder
Bookmark Caching
Cache Storage
Frombookmarks.store.ts:145-170, bookmarks are cached in IndexedDB:
Cache Benefits
- Fast Loading: No delay waiting for Chrome API on every page load
- Offline Access: View cached bookmarks even if sync temporarily fails
- Performance: Tree building from cache is faster than Chrome API
- Resilience: Fallback if permission is temporarily revoked
bookmarks.store.ts:220-228:
Cache Refresh Logic
Frombookmarks.store.ts:230-233:
Cache is automatically refreshed after 1 hour to ensure you see recent bookmark changes.
Managing Bookmarks
Add Bookmark
Frombookmarks.store.ts:424-438:
Currently, adding bookmarks through Meelio UI is not exposed. Use your browser’s native bookmark manager or bookmark bar to add bookmarks. Meelio will auto-sync them.
Edit Bookmark
Frombookmarks.store.ts:440-453:
- Use your browser’s native bookmark manager
- Edit the bookmark there
- Meelio automatically syncs the changes
Delete Bookmark
Frombookmarks.store.ts:455-466:
- Use your browser’s native bookmark manager
- Delete the bookmark
- Meelio removes it from the display on next sync
Folder Management
Frombookmarks.store.ts:468-508, folders can be:
Statistics Display
Frombookmarks.sheet.tsx:184-189:
- Total number of bookmark links
- Total number of folders
- Updates in real-time as you sync
Empty State
Frombookmarks.sheet.tsx:192-199:
Extension-Only Feature
Frombookmarks.sheet.tsx:345-370:
- Accessing the Chrome bookmarks API
- Reading the bookmark tree
- Listening to bookmark changes
Browser Compatibility
- Chrome/Edge/Brave
- Firefox
- Opera
- Safari
Full Support
- Native
chrome.bookmarksAPI - All bookmark operations supported
- Live sync with bookmark changes
- Folder hierarchy fully supported
Privacy & Data
- Bookmarks are read from your browser’s native bookmark storage
- A cached copy is stored locally in IndexedDB for performance
- No bookmark data is sent to Meelio servers
- Bookmark URLs and titles remain private to your browser profile
- Optional: Sync bookmark cache across devices when signed in to Meelio
Meelio never uploads your bookmark URLs to external servers. The cache is local-only for performance.
Troubleshooting
Permission request not working
Permission request not working
- Check if you’ve already granted/denied the permission in the past
- Go to browser settings > Extensions > Meelio > Permissions
- Manually enable “Read and change your bookmarks”
- Refresh the Meelio tab after granting permission
Bookmarks not showing up
Bookmarks not showing up
- Verify you have bookmarks in your browser’s bookmark manager
- Click the Refresh button to manually sync
- Check if you’re signed in to the correct browser profile
- Check browser console for sync errors
Favicons not loading
Favicons not loading
- Some sites don’t have favicons
- Favicon URLs may be blocked by content security policy
- Extension falls back to bookmark icon automatically
- This is expected behavior for certain sites
Bookmarks outdated after adding new ones
Bookmarks outdated after adding new ones
- Wait for auto-sync (happens within 1 hour)
- Click the Refresh button to force immediate sync
- Check if bookmark change listeners are working (console logs)
- Verify you have the latest extension version
Can't expand folders
Can't expand folders
- Ensure you’re clicking the folder row (not just the icon)
- Check if JavaScript is enabled
- Try refreshing the page
- Check browser console for React errors
Related Features
Tab Stash
Save temporary tab sessions vs. permanent bookmarks
Search
Search your bookmarks from the universal search bar
Dock Customization
Configure the bookmarks icon position in the dock
Settings
Change bookmark display mode (bar, sheet, both, hidden)