README.md

UTags Bookmark Manager

🚀 Project Overview

UTags Bookmark Manager empowers developers and power users to conquer bookmark chaos. This modern solution moves beyond simple lists, employing a flexible tagging system to bring order to your expanding collection of web resources. Unleash powerful filtering capabilities to instantly pinpoint the information you need, exactly when you need it.

Visit our official website (https://utags.link) to explore comprehensive features.

✨ Core Features

• Multi-dimensional tag management system
• Advanced filtering system supporting:
  • AND/OR/NOT logical combinations
  • Regular expression matching
• Local data persistence via LocalStorage
• Progressive Web App (PWA) support
• Seamless integration with UTags browser extension/userscript

Other Features

• Fully open source and free to use
• Easy self-hosting deployment
• Saved filter presets
• Data import/export capabilities
• Multi-device synchronization (TODO)
• Progressive Web App capabilities:
  • Add to Home Screen (A2HS)
  • Offline mode with Service Worker caching
  • Web App Manifest for native-like experience
• Visual data statistics dashboard
• Light/dark theme support
• Responsive layout with multiple view modes
• Cross-browser compatibility
• Browser bookmark import (Chrome/Edge/Firefox/Safari)

Usages

How to add a bookmark

• Add bookmarks on bookmark manager page
• Add bookmarks via UTags extension/userscript
• Make your own extension or userscript

How to use filters

• Filter by keywords, tags, domains, and other metadata
• Multi-level filtering system supporting AND/OR/NOT logic combinations
• Regular expression matching
• Save filter presets for quick access in future sessions

🛣 Development Roadmap

• Bookmark Management Enhancements

  • Batch modify/delete tags
  • Bulk delete bookmarks
  • Bulk add tags
  • Note viewing interface

• Bookmark Collection Solutions

  • Add bookmarks via UTags extension/userscript
  • Custom styling options
  • Navigation website style view

• Data Interoperability

  • Gist/GitHub import/export support
  • WebDAV import/export support
  • Multi-device sync solution
  • Cloud sync capability
  • Bookmark export/import enhancements
  • Use IndexedDB storage when the bookmark volume is extremely large

📦 Installation & Usage

Development

npm install
npm run dev

Access the application at http://localhost:5173

Production Build

npm run build
npm run preview

🛠 Development

Wiki: Development Guide

Data Management

Generate mock data for development:

node generate-mock-data.js

Development data is stored in browser's Local storage. To reset:

1. Visit application website and open Browser Developer Tools
2. Application → Local storage → Clear data

🤝 Contributing

Contributions through:

• 🐛 GitHub Issues - for bug reports
• 💡 Pull Requests - for feature additions
• 💬 GitHub Discussions - get help and share tips

Please follow our contribution guidelines.

📄 License

Copyright (c) 2025 Pipecraft. Licensed under the MIT License.

---