# 🚀 Quick Version Update Guide

**Current Version**: `6.10.0`

---

## Fast Track (5 minutes)

### 1. Run the COMPREHENSIVE automated script
```bash
cd /opt/media-downloader
bash scripts/update-all-versions.sh 6.11.0  # Replace with your new version
```

This script updates **ALL** version references across the entire codebase automatically!

### 2. Update changelogs (manual)
- Edit `data/changelog.json` - add entry at TOP
- Edit `docs/CHANGELOG.md` - add section at TOP

### 3. Finalize
```bash
# Services restart automatically (dev server running)
# Or manually restart:
sudo systemctl restart media-downloader-api media-downloader.service

# Create version backup
bash scripts/create-version-backup.sh
```

### 4. Verify
- Open browser: Check login page shows correct version
- Check Dashboard loads correctly
- Check Configuration page shows correct version
- Verify Health page loads

---

## Files Updated by Script (Automatic)

✅ `/opt/media-downloader/VERSION`
✅ `/opt/media-downloader/README.md` (header + directory structure comment)
✅ `web/frontend/src/pages/Login.tsx`
✅ `web/frontend/src/App.tsx` (2 locations)
✅ `web/frontend/src/pages/Configuration.tsx` (multiple locations)
✅ `web/frontend/package.json`

---

## Manual Updates Required

❌ `data/changelog.json` - Add new version entry
❌ `CHANGELOG.md` - Add new version section

---

## Full Documentation

For complete checklist and troubleshooting:
📖 **[docs/VERSION_UPDATE_CHECKLIST.md](docs/VERSION_UPDATE_CHECKLIST.md)**

---

## Version Number Format

Follow [Semantic Versioning](https://semver.org/): `MAJOR.MINOR.PATCH`

- **6.x.0** - Major features, breaking changes
- **6.4.x** - New features, backward-compatible
- **6.4.2** - Bug fixes, patches

---

**Last Updated**: 2025-10-31