Skip to content

v1.1.0 - Phase 1 Complete (Quick Wins)

Choose a tag to compare

View all tags
@kunwar-shah kunwar-shah released this 27 Oct 10:01
· 61 commits to main since this release
v1.1.0
015d8d6
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

🎉 Claudex v1.1.0 - Phase 1 Complete!

Release Date: October 27, 2025
Phase: 1 - Quick Wins
Status: ✅ All 3 features complete (100%)

✨ What's New

1. 🏷️ Smart Title Extraction

Session titles now show meaningful text extracted from your conversations instead of cryptic session IDs.

Before: Session abc123def456
After: Help me implement yank mode for vim

  • Intelligent extraction from first user/assistant message
  • Smart edge case handling (empty messages, code-only sessions)
  • Comprehensive unit tests

2. 📊 Professional Analytics Dashboard

Re-enabled Tremor dashboard with beautiful real-time analytics.

  • Message Distribution: Donut chart with proper color coding
  • Project Activity: Multi-scale BarList visualization for sessions and messages
  • Professional Styling: Enterprise-level appearance with clean borders
  • Fast Performance: <2s load time with real data

Technical Improvements:

  • Fixed chart colors using Tremor color names + Tailwind safelist
  • Redesigned multi-scale data visualization pattern
  • Minimal CSS approach (let framework handle styling)

3. 🐳 Docker Containerization

One-command deployment is here!

  • Multi-stage Dockerfile for optimized production builds
  • docker-compose.yml for easy local development
  • Volume mounts for data persistence (~/.claude/projects)
  • Multi-platform support (linux/amd64, linux/arm64)

Get Started:

docker-compose up

📊 Statistics

  • Files Changed: 18 files
  • Lines Added: +1,474
  • Lines Removed: -269
  • Development Time: ~14 hours (within 12-16h estimate)

🔧 Technical Details

New Files:

  • server/src/utils/titleExtractor.js - Smart title extraction logic
  • server/src/utils/titleExtractor.test.js - Comprehensive tests
  • BRANCHING_STRATEGY.md - Development workflow guide
  • server/jest.config.js - Jest configuration

Key Updates:

  • Updated Tremor dashboard components with BarList pattern
  • Enhanced Docker configuration for production
  • Improved search indexer and file scanner with title extraction

Architecture Decisions (ADRs):

  • ADR-20251026-01: Use Tremor color names with Tailwind safelist
  • ADR-20251026-02: BarList pattern for multi-scale data visualization

🚀 Upgrade Instructions

Docker (Recommended):

docker pull kunwar-shah/claudex:v1.1.0
docker-compose up

From Source:

git pull origin main
git checkout v1.1.0
npm install
npm run dev

🎯 Impact

User Experience:

  • ✅ Identify sessions at a glance with meaningful titles
  • ✅ Beautiful analytics dashboard with real-time insights
  • ✅ One-command Docker deployment

Developer Experience:

  • ✅ Easy setup for contributors via Docker
  • ✅ Clean codebase with comprehensive documentation
  • ✅ Unit test coverage for critical features

🐛 Known Issues

None! This release is stable and production-ready.

🔜 What's Next - Phase 2 (v1.2.0)

Upcoming Features:

  • 🌙 Dark Mode Toggle (8-10 hours)
  • ⭐ Session Bookmarking/Favorites (6-8 hours)

Timeline: ~2 weeks

🙏 Acknowledgments

Thanks to the Tremor React team for their excellent dashboard component library!

📚 Documentation

Full Changelog: v1.0.0...v1.1.0

Assets 2
Loading