StupidBookmarks
A fast, minimalistic bookmark manager built with FastAPI and Tailwind CSS
Keep it simple, keep it fast, keep it stupid
StupidBookmarks is a minimalist, single-user bookmark manager that focuses on simplicity, speed, and a clean user experience. No bloat, just pure bookmark management with a modern dark/light interface.
Version 0.0.2 Released
Our latest release adds bookmark import/export and pagination!
Netscape HTML Import/Export
StupidBookmarks now supports importing and exporting bookmarks in the widely-used Netscape HTML format, making migration from other browsers and bookmark managers a breeze.
What's New
- Import bookmarks from standard Netscape HTML format
- Export all bookmarks to Netscape HTML format
- Progress indicators for import/export operations
- Tag preservation during import/export process
- "Delete All Bookmarks" feature with confirmation modal
Pagination Support
Browse through large bookmark collections with ease using our new pagination system. Pagination is consistently implemented across both main and tag-filtered views.
Improvements
- Pagination controls on main bookmark view
- Consistent pagination for tag-filtered views
- Efficient SQL queries with limit and offset
- Visual indicators showing current page and total pages
- Fixed duplicate pagination controls
Docker Compose Support
Deploy StupidBookmarks anywhere with our new Docker Compose setup. Run with SQLite for simplicity or PostgreSQL for production environments.
What's Included
- Dockerfile with multi-stage build for smaller images
- Docker Compose configuration for quick setup
- Environment variable support for configuration
- Database options: SQLite (default) or PostgreSQL
- Production-ready with secure defaults
Features
Everything you need for bookmark management, nothing you don't
Lightning Fast
Built with FastAPI for maximum performance and async processing.
Dark Mode
Beautiful dark/light theme with system preference detection.
REST API
Full REST API with auto-generated OpenAPI documentation.
Minimalistic
Clean interface focused on bookmarking, no unnecessary features.
Responsive
Works perfectly on desktop, tablet, and mobile devices.
Pagination New
Browse large bookmark collections with intuitive navigation controls.
Database Options
SQLite for simplicity or PostgreSQL for production environments.
Import/Export New
Import and export bookmarks using Netscape HTML format.
Docker New
Easy deployment with Docker Compose for any environment.
Smart Bookmarking
Automatically fetch page titles when adding bookmarks by URL.
Tag System
Organize bookmarks with tags and visualize with a dynamic tag cloud.
Import/Export
Support for standard Netscape HTML bookmark format.
Pagination
Browse large bookmark collections with intuitive pagination controls.
API Keys
Generate secure API keys for external access to your bookmarks.
Admin Dashboard
Manage bookmarks, tags, password, and API keys from a simple dashboard.
Tech Stack
Modern technologies for maximum performance
Backend
- FastAPI - Modern async Python web framework
- SQLAlchemy - Python SQL toolkit and ORM
- SQLite - Lightweight database
- Pydantic - Data validation
- Passlib - Password hashing
Frontend
- Jinja2 - Template engine
- Tailwind CSS - Utility-first CSS framework
- Vanilla JavaScript - No heavy frameworks
- Dark Mode - System preference aware
- Responsive Design - Mobile-first approach
Quick Start
Get StupidBookmarks running in minutes
# Method 1: Standard Installation
git clone https://github.com/dannycab/stupidbookmarks.git
cd stupidbookmarks
pip install -r requirements.txt
python main.py
# Method 2: Docker Compose (NEW!)
git clone https://github.com/dannycab/stupidbookmarks.git
cd stupidbookmarks
cp env.example .env
docker-compose up -d
# Open your browser to the bookmark manager
open http://localhost:8000/
# Login with default password: admin
It's that simple! After logging in with the default password (admin), you can start adding bookmarks right away.
Vibe Coding Project
What does this mean?
StupidBookmarks is developed in a freeform, improvisational, and experimental style. It's about finding the joy in coding without rigid structures or processes.
Some key aspects of vibe coding:
- Focus on creative expression and experimentation
- Iterative development driven by inspiration
- Prioritizing developer enjoyment and satisfaction
- Emphasizing simplicity and directness over complexity
- Building what feels right rather than what's "best practice"
No pull requests will be honored. If you have a feature request or bug, please open an issue and I'll vibe code it (maybe it works, maybe not). Thanks for understanding!