QuickMark - Enhanced Chrome Bookmark Manager

Enhanced Chrome bookmark adding with quick search and flexible tagging

English | 中文

🚀 Features

💡 Problems Solved

QuickMark addresses common bookmark management frustrations:

• Tedious Folder Navigation: No more hunting through dozens of bookmark folders without search functionality
• Manual Tag Management: Eliminates the need to manually type "tag1 | tag2" in bookmark names
• Time-Consuming Bookmark Retrieval: No more right-click → Bookmark Manager → search workflow

🔧 Core Features

• 🎯 Browser-Compatible Shortcuts: Ctrl+D to add bookmarks, Ctrl+Shift+F for global search (fully customizable)
• 🔍 Smart Search: Multi-keyword search for folders and bookmarks with real-time filtering
• 🏷️ Quick Tagging: Streamlined tag system with flexible prefix/suffix positioning
• 💾 Auto-Save Integration: Remembers recent folders, auto-saves on open/close (toggleable)
• ⚡ Instant Access: Global search overlay accessible from any webpage
• 🎨 Intelligent UI: Extension icon changes based on bookmark status, dark/light theme support

🌍 Internationalization

• 22 Languages Supported: English, Chinese (Simplified & Traditional), Japanese, Korean, French, German, Spanish, Russian, and more
• Auto Language Detection: Follows browser language by default
• Complete Translation: All UI elements fully localized

📦 Installation

From Chrome Web Store (Recommended)

Not published yet. This section will be updated after release.

1. Visit the Chrome Web Store
2. Click "Add to Chrome"
3. Confirm the installation

From Microsoft Edge Add-ons

Not published yet. This section will be updated after release.

1. Visit the Edge Add-ons Store
2. Click "Get"
3. Confirm the installation

Manual Installation (Development)

1. Clone this repository:

   git clone https://github.com/iblogc/quickmark-extension.git
   cd quickmark-extension

2. Open Chrome and navigate to chrome://extensions/
3. Enable "Developer mode" in the top right
4. Click "Load unpacked" and select the project folder

🎯 Usage

Basic Bookmark Management

1. Add Bookmark: Press Ctrl+D (or Cmd+D on Mac) or click the extension icon
2. Edit Details: Modify title, URL, folder, and tags as needed
3. Save: Press Enter or click Save button

Global Bookmark Search

1. Open Search: Press Ctrl+Shift+F (or Cmd+Shift+F on Mac) from any webpage
2. Search: Type keywords to find bookmarks
3. Navigate: Use ↑↓ arrow keys to browse results
4. Open: Press Enter to open the selected bookmark
5. Close: Press Esc or click outside to close

Settings Configuration

1. Click the extension icon
2. Click the ⚙️ Settings button
3. Configure:
   • Language: Choose from 22 supported languages
   • Auto-save: Enable/disable automatic bookmark saving

🛠️ Development

Prerequisites

• Node.js 16+
• Chrome/Edge Browser

Build

# Build for production
npm run build

# Clean build files
npm run clean

# Complete packaging process
npm run pack

Project Structure

quickmark-extension/
├── manifest.json          # Extension manifest (Manifest V3)
├── popup.html             # Main popup interface
├── popup.js               # Popup logic and UI handling
├── popup.css              # Popup styling
├── search.js              # Global search functionality
├── search.css             # Search overlay styling
├── background.js          # Service worker for extension
├── build.js               # Build script for release package
├── clean.js               # Clean build artifacts script
├── package.json           # Project configuration and build scripts
├── icons/                 # Extension icons
│   ├── icon16.png         # 16x16 icon
│   ├── icon32.png         # 32x32 icon
│   ├── icon48.png         # 48x48 icon (default)
│   ├── icon48-bookmarked.png # 48x48 bookmarked state icon
│   └── icon128.png        # 128x128 icon
├── _locales/              # Internationalization files
│   ├── en/messages.json   # English translations
│   ├── zh_CN/messages.json # Chinese (Simplified) translations
│   ├── zh_TW/messages.json # Chinese (Traditional) translations
│   └── ...                # 19+ other languages
├── utils/                 # Utility modules
│   ├── folderSearch.js    # Folder search engine
│   └── settings.js        # Settings manager
├── RELEASE_CHECKLIST.md   # Release checklist
├── README.md              # This file (English)
└── README_zh.md           # Chinese documentation

Key Technologies

• Manifest V3: Latest Chrome extension standard
• Vanilla JavaScript: No external dependencies for core functionality
• CSS Custom Properties: Dynamic theming support
• Chrome APIs: bookmarks, storage, tabs, scripting, notifications, activeTab
• Internationalization: Chrome i18n API

🤝 Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🐛 Bug Reports & Feature Requests

Please use the GitHub Issues page to report bugs or request features.

🙏 Acknowledgments

• Thanks to all contributors who have helped improve this extension
• Icons designed with modern UI principles
• Inspired by macOS Spotlight and other modern search interfaces

---

Made with ❤️ by QuickMark Team

Star ⭐ this repository if you find it helpful!