immerse/RELEASE_NOTES_v1.1.0.md

Immerse v1.1.0 Release Notes

Release Date: November 24, 2024

🎉 What's New

📈 Reporting & Analytics System

A complete analytics dashboard to track your productivity over time!

Features:

• Key Metrics Dashboard: View tasks completed, tasks per day, hours per day, minutes per task, and current day streak
• Visual Charts: Beautiful pie chart showing distribution of tasks, hours, and pomodoros
• Time by List Analysis: See exactly how much time you spend on different task categories
• Productivity Insights: Discover your most productive hour, day, and month
• Daily Breakdown: Visual bar charts showing the last 10 days of activity with tasks, hours, and pomodoros
• Flexible Filtering: Quick filters (Today, Last 7/30/90 days) plus custom date range selection
• Report View: Dedicated view accessible via "📊 Reports" button

🗓️ Task Scheduling & Reminders

Never miss a deadline with the new scheduling system!

Features:

• Schedule Tasks: Set specific date and time when tasks are due
• Smart Reminders: Choose notification timing (5, 10, 15, 30, or 60 minutes before due time)
• Visual Indicators:
  • Blue 📅 badge shows scheduled date/time
  • Red ⚠️ pulsing "OVERDUE" badge for past-due tasks
  • Red left border highlight on overdue tasks
• Background Monitoring: Automatic checks every 30 seconds for upcoming/overdue tasks
• Startup Alerts: Get notified when opening Obsidian if tasks are overdue
• Sound Notifications: Optional audio alerts for reminders (respects sound settings)
• Duplicate Prevention: Smart tracking ensures you don't get reminded multiple times

📱 Mobile Optimization

Full responsive design for excellent mobile experience!

Improvements:

• Responsive Layouts: All UI elements adapt to mobile screen sizes
• Touch-Friendly:
  • Minimum 44px tap targets (Apple's recommended size)
  • Larger checkboxes (28px on mobile)
  • Larger action buttons
• Optimized Views:
  • Pie charts scale down appropriately (220px on tablets, 180px on phones)
  • Stats grid adapts (2 columns on tablets, 1 column on small phones)
  • Daily breakdown bars stack vertically on mobile
  • Modal buttons become full-width and stack
• Always Visible Actions: Task action buttons always visible on mobile (no hover needed)
• Adaptive Typography: Font sizes scale appropriately for readability

🔧 Technical Improvements

Performance

• Efficient report generation with on-demand calculation
• Optimized reminder checks with 30-second intervals
• Smart caching to prevent duplicate notifications

Code Structure

• New reportView.ts file for analytics view
• Enhanced type definitions for scheduling and reporting
• Improved data tracking for historical statistics
• Better separation of concerns

Compatibility

• Fully compatible with Obsidian desktop and mobile
• Works with both light and dark themes
• Respects user's sound and notification preferences

📊 Statistics Tracked

The plugin now tracks comprehensive statistics including:

• Total tasks completed
• Total time spent (all-time and daily)
• Total pomodoros completed
• Tasks per day average
• Hours per day average
• Minutes per task average
• Current day streak
• Most productive hour/day/month
• Time breakdown by task list

🎨 UI/UX Enhancements

• New "📊 Reports" button in main view header
• Modern, clean report interface with gradient accents
• Color-coded progress bars using list colors
• Hover effects and animations for better interactivity
• Responsive filter controls
• Improved date picker styling and alignment

🐛 Bug Fixes

• Fixed pie chart rendering issues (now uses proper color values)
• Improved gradient calculation for proper segment display
• Better normalization of metrics (using time-based calculations)
• Fixed date input alignment in report filters

⚙️ Settings Updates

New Settings:

• Enable Reminders: Toggle reminder notifications on/off
• Default Reminder Minutes: Set default reminder time for new scheduled tasks (default: 30 minutes)

Updated Settings:

All existing settings remain compatible with no migration required.

📱 Mobile Testing Recommendations

To ensure the best experience on mobile:

1. Test on actual device: Install Obsidian mobile and test the plugin
2. Browser DevTools: Use Chrome/Edge DevTools device emulation
3. Responsive breakpoints:
   • Desktop: >768px
   • Tablet: ≤768px
   • Phone: ≤480px

🔄 Upgrade Instructions

From v1.0.x:

1. Backup your data (optional but recommended):

   • Your tasks and settings are in .obsidian/plugins/immerse/data.json
   • Make a copy before updating

2. Update files:

   • Copy main.js, manifest.json, and styles.css to your vault
   • DO NOT replace data.json - this contains your tasks!

3. Reload Obsidian:

   • Press Ctrl/Cmd+R to reload
   • Or restart Obsidian

4. Verify:

   • Check that your tasks are still there
   • Click "📊 Reports" to see your new analytics
   • Try scheduling a task with a reminder

🚀 What's Next (v1.2.0)

Future enhancements we're considering:

• Calendar view integration
• Export reports (PDF/CSV)
• More chart types and visualizations
• Task templates
• Recurring tasks
• Advanced filtering options

💡 Feedback

Found a bug or have a feature request?

• Open an issue: https://git.cribdev.com/crib/immerse/issues
• Join the discussion in the repository

🙏 Credits

Special thanks to:

• Blitzit for continued inspiration
• The Obsidian community for feedback and support
• Claude.ai for development assistance

---

Enjoy v1.1.0! ⚡

Made with ❤️ for the Obsidian community