feat: major feature updates and cleanup

- Add Redis architecture implementation - Update browser extension functionality - Clean up deprecated files and documentation - Enhance backend handlers for auth, messages, search - Add new configuration options and settings - Update Docker and deployment configurations
2026-06-03 20:12:58 +00:00 · 2026-03-03 11:03:37 +01:00
parent 446bc7acfb
commit 083373a24f
241 changed files with 46662 additions and 24880 deletions
@@ -0,0 +1,125 @@
+# 🚀 Trackeep Release Guide
+
+This guide covers how to create releases for Trackeep using different methods.
+
+## Method 1: GitHub CLI (Recommended)
+
+For new features or bug fixes:
+
+```bash
+# 1. Commit your changes
+git commit -m "feat: add new amazing feature"
+
+# 2. Create version tag and push
+git tag v1.2.7
+git push origin v1.2.7
+
+# 3. Create GitHub release with CLI
+gh release create v1.2.7 \
+  --title "Trackeep v1.2.7 - Release Title" \
+  --notes "Release notes here..."
+
+# Or use a release notes file
+gh release create v1.2.7 \
+  --title "Trackeep v1.2.7 - Release Title" \
+  --notes-file RELEASE_v1.2.7.md
+```
+
+### GitHub CLI Installation
+
+If you don't have GitHub CLI installed:
+
+```bash
+# Ubuntu/Debian
+sudo apt install gh
+
+# Alternative with Snap
+sudo snap install gh
+
+# Authenticate with GitHub
+gh auth login
+```
+
+## Method 2: Manual Scripts
+
+For traditional workflow:
+
+```bash
+# Use version update script
+./scripts/update-version.sh 1.2.7
+
+# Commit and push
+git add . && git commit -m "chore: bump version to 1.2.7"
+git push origin main
+```
+
+## Method 3: Release Script
+
+Use the automated release script:
+
+```bash
+./scripts/release.sh 1.2.7
+```
+
+This script will:
+- Update version in .env file
+- Build Docker images with version tags
+- Push images to GitHub Container Registry
+- Create and push Git tag
+- Push tag to origin
+
+## Semantic Versioning
+
+Follow industry standard (MAJOR.MINOR.PATCH):
+
+```
+1.2.6 → 1.3.0  (MINOR: new features)
+1.2.6 → 1.2.7  (PATCH: bug fixes)  
+1.2.6 → 2.0.0  (MAJOR: breaking changes)
+```
+
+## Release Notes Template
+
+Create comprehensive release notes following this structure:
+
+```markdown
+# 🎉 Trackeep v1.2.7 - Release Title
+
+## ✅ What's New
+
+### **Feature Category 1**
+- ✅ New feature description
+- ✅ Another improvement
+
+### **Bug Fixes**
+- ✅ Fixed issue description
+- ✅ Another bug fix
+
+## 🎯 How to Update
+
+### **Current Users:**
+```bash
+# Option 1: Built-in updates
+# Update button appears in left navigation
+
+# Option 2: Manual Docker pull
+docker compose pull
+docker compose up -d
+```
+
+## 📦 Docker Images
+
+- `ghcr.io/dvorinka/trackeep/backend:1.2.7`
+- `ghcr.io/dvorinka/trackeep/frontend:1.2.7`
+- `ghcr.io/dvorinka/trackeep/backend:latest`
+- `ghcr.io/dvorinka/trackeep/frontend:latest`
+```
+
+## Docker Images
+
+Images are automatically built and pushed to GitHub Container Registry:
+
+- **Registry**: `ghcr.io/dvorinka/trackeep`
+- **Latest tags**: `backend:latest`, `frontend:latest` (for auto-updates)
+- **Versioned tags**: `backend:1.2.5`, `frontend:1.2.5` (for specific releases)
+- **Automatic builds**: Triggered by Git tags and pushes to main branch