Skip to content

tonsnoei/html-link-manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HTML Link Manager

A lightweight, client-side link management application that allows you to organize your bookmarks into groups and manage them efficiently. Built entirely using AI assistance in just 5-10 minutes of effort.

🚀 Features

  • Group Management: Create and organize links into custom groups
  • Link Management: Add, edit, and delete links within groups
  • Drag & Drop: Reorder groups and links with intuitive drag-and-drop functionality
  • Customizable Page Title: Change the title of your link manager page
  • Local Storage: All data is stored in your browser's local storage
  • Backup & Restore: Export and import your entire link collection
  • No Backend Required: Runs completely from the file system
  • Zero Cost: No server or database dependencies

🛠️ Built With AI

This project was created using modern AI development tools:

  • Aider: AI pair programming in your terminal - An open-source command-line AI coding assistant that automatically commits changes with sensible commit messages
  • OpenRouter: Unified interface for LLMs - Provides access to multiple AI models through a single API endpoint
  • DeepSeek-R1 (Free): Performance on par with OpenAI o1, but open-sourced - The free AI model used for development

Development Process

The entire application was built using:

  • Aider: Connected to OpenRouter for seamless AI-powered coding
  • OpenRouter API: Providing access to the DeepSeek-R1 free model
  • Time Investment: 5-10 minutes of active development spread over an hour
  • Cost: $0.00 (completely free using the DeepSeek-R1 free tier)

📦 Installation

No installation required! Simply:

  1. Download the HTML file
  2. Open it in any modern web browser
  3. Start organizing your links

🏃‍♂️ Getting Started

  1. Open the Application: Double-click the HTML file or open it in your browser
  2. Create a Group: Click "Add Group" to create your first link group
  3. Add Links: Click "Add Link" within a group to add bookmarks
  4. Organize: Drag and drop to reorder groups and links
  5. Customize: Change the page title using the settings option

💾 Data Storage

All your data is stored locally in your browser using localStorage:

  • Groups: Your link group names and order
  • Links: All bookmark URLs, titles, and descriptions
  • Settings: Page title and other preferences
  • Persistence: Data survives browser restarts but stays on your device

Privacy Benefits

  • No data transmitted to external servers
  • Complete offline functionality
  • Your bookmarks remain private and secure

🔄 Backup & Restore

Creating a Backup

  1. Click the "Backup" button in the application
  2. Download the generated JSON file
  3. Store it safely (cloud storage, external drive, etc.)

Restoring from Backup

  1. Click the "Restore" button
  2. Select your backup JSON file
  3. Confirm the restore operation
  4. Your links and groups will be restored

🌐 Browser Compatibility

Works in all modern browsers:

  • Chrome/Chromium
  • Firefox
  • Safari
  • Edge
  • Opera

🤝 Contributing

Since this was built with AI assistance, future enhancements can be developed using the same tools:

  1. Use Aider with OpenRouter for development
  2. Connect to free models like DeepSeek-R1
  3. Make incremental improvements with AI assistance

📋 Technical Details

  • Framework: Vanilla HTML, CSS, and JavaScript
  • Storage: Browser localStorage API
  • Dependencies: None (self-contained)
  • File Size: Minimal footprint
  • Performance: Instant loading and response

⚡ Performance

  • Startup: Instant loading from file system
  • Response Time: Immediate UI interactions
  • Memory Usage: Minimal browser memory footprint
  • Storage Limits: Subject to browser localStorage limits (typically 5-10MB)

🔧 Customization

The application can be easily modified:

  • Edit CSS for styling changes
  • Modify JavaScript for functionality enhancements
  • Use Aider + OpenRouter for AI-assisted development

📱 Mobile Support

The interface is responsive and works on:

  • Mobile phones
  • Tablets
  • Desktop computers
  • Any device with a modern web browser

🛡️ Security Considerations

  • All data remains on your device
  • No external network requests required
  • Safe to use on corporate networks
  • No tracking or analytics

📄 License

MIT License

Copyright (c) 2025 HTML Link Manager

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

🔗 Related Tools

  • Aider: The AI coding assistant used to build this
  • OpenRouter: API gateway for accessing multiple LLM models
  • DeepSeek-R1: The free AI model used for development

🆘 Support

Since this is a client-side application with no backend:

  • Check browser developer console for any JavaScript errors
  • Ensure localStorage is enabled in your browser
  • Try refreshing the page if issues occur
  • Create backups regularly to prevent data loss

🎯 Future Enhancements

Potential improvements that could be developed with AI assistance:

  • Import from browser bookmarks
  • Export to various formats (HTML, CSV)
  • Search and filter functionality
  • Tags and categories
  • Keyboard shortcuts
  • Theme customization
  • Cloud sync options

Built with ❤️ and AI in minutes, not hours!

About

HTML Link Manager

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published