├── 📂 assets/           # Static assets (favicon, test data, etc.)
├── 📂 backend/          # Node.js/Express backend API
├── 📂 docs/             # Documentation and guides
├── 📂 frontend/         # HTML, CSS, JavaScript frontend
├── 📂 scripts/          # Setup and utility scripts
├── 📂 tests/            # Test files and verification scripts
├── bookmarks.html       # Test data (sample bookmarks)
└── bookmarks_all_*.json # Test data (bookmark exports)

🚀 Quick Start

Option 1: Docker Setup (Recommended)

./scripts/docker-setup.sh

Option 2: Manual Setup

./scripts/setup.sh

📖 Documentation

Getting Started - Complete setup guide
Docker Setup - Docker installation guide
Manual Setup - Manual installation steps
Troubleshooting - Common issues and solutions

🔧 Development

Backend Development

cd backend
npm install
npm run dev

Frontend Development

The frontend files are in the frontend/ directory. Open frontend/index.html in your browser or serve via the backend.

Database Management

cd backend
npm run db:backup    # Create database backup
npm run db:status    # Check database status
npm run db:reset     # Reset database (development only)

🧪 Testing

Test files are organized in the tests/ directory:

Integration Tests: tests/test_*.html
Unit Tests: tests/test_*.js
Verification Scripts: tests/verify_*.js

📊 Features

Advanced Search & Filtering
Folder Organization
Link Testing & Validation
Import/Export (HTML, JSON)
Duplicate Detection
Analytics & Statistics
Mobile-Responsive Design
Security Features
Database Backup/Restore

🔒 Security

JWT-based authentication
Email verification
Password reset functionality
Rate limiting
Input validation
CSRF protection

📱 Mobile Support

Fully responsive design with touch-friendly interactions and mobile-optimized UI.

🤝 Contributing

Fork the repository
Create a feature branch
Make your changes
Run tests
Submit a pull request

📄 License

This project is licensed under the MIT License.