🎯 TIMORA

Session-focused productivity redefined

A modern, feature-rich Pomodoro timer with session-specific task management and beautiful animations

🚀 Live Demo • 📱 Download APK • 🐛 Report Bug • ✨ Request Feature

---

📦 Get TIMORA

Choose Your Platform

🌐 Web App	📱 Android APK
Instant access, no installation	Full mobile experience
Always up-to-date	Offline support
Cross-platform compatible	Native Android integration

📱 Mobile Installation:

1. Download the latest APK from Releases
2. Enable "Install from unknown sources" on your Android device
3. Install the APK file
4. Enjoy TIMORA on your mobile! 🎯

---

✨ Features

⏰ Advanced Timer 🕐 Hours support - Set timers up to 23 hours ⏱️ Precision timing - Hours, minutes, and seconds 🎨 Beautiful circular progress indicator ⏸️ Smart controls - Start, pause, reset, +5min quick add 🌓 Dark/Light mode support 📋 Smart Task Management 🎯 Session-specific tasks - Tasks tied to timer sessions ✅ General task list - Persistent tasks across sessions 🔄 Auto-archiving - Session tasks archived on completion 📊 Progress tracking - Completion rates and statistics 💾 Auto-save - All data persisted locally

📈 Session Analytics 📅 Detailed history - Complete session records 🎯 Task completion rates - Visual progress indicators 📊 Performance insights - Track productivity over time 🔍 Session details - Click any session for full breakdown 📱 Responsive design - Perfect on all devices 🎵 Enhanced Experience 🔊 Pleasant audio alerts - WebAudio API chimes 📳 Vibration support - Mobile haptic feedback ⌨️ Keyboard shortcuts - Space, R, C, Esc keys 🖥️ Fullscreen mode - Distraction-free focus 🌟 Smooth animations - Framer Motion powered

---

🚀 Quick Start

Prerequisites

• Node.js 16+
• npm or yarn

Installation

1. Clone the repository

   git clone https://github.com/ravixalgorithm/timora.git
   cd timora

2. Install dependencies

   npm install
   # or
   yarn install

3. Start development server

   npm run dev
   # or
   yarn dev

4. Open your browser

   http://localhost:5173
   

📱 Build Mobile APK

# Build for production
npm run build

# Add Android platform
npx cap add android

# Sync with Capacitor
npx cap sync android

# Open in Android Studio
npx cap open android

# Build APK in Android Studio: Build > Build Bundle(s) / APK(s) > Build APK(s)

---

🛠️ Tech Stack

Technology	Purpose	Version
	UI Framework	18+
	Styling	3+
	Animations	Latest
	Build Tool	4+
	Mobile	6+
	Audio	Native

---

📱 Screenshots

🖥️ Desktop Experience

📱 Mobile Responsive

⚙️ Configuration Modal

---

⌨️ Keyboard Shortcuts

Key	Action
Space	Start/Pause timer
R	Reset timer
C	Open/Close configuration
Esc	Close modals

---

🎯 Usage Guide

Setting Up a Session

1. Click "Configure" to open timer settings
2. Set duration using hours, minutes, seconds inputs
3. Add session name (e.g., "Deep Work", "Study Session")
4. Add session tasks - specific to this timer session
5. Click "Done" and start your focused work!

During Your Session

• ✅ Check off tasks as you complete them
• ⏰ Monitor progress with the circular timer
• 🎵 Enjoy audio alerts when time's up
• 📊 Track completion rates in real-time

After Session Completion

• 📈 Review session in the history panel
• 🎯 See task completion rates and statistics
• 🔄 Start new session or adjust current timer
• 💾 All data saved automatically

---

🔧 Configuration

Environment Variables

Create a .env file in the root directory:

# Optional: Analytics tracking
VITE_ANALYTICS_ID=your_analytics_id

# Optional: Custom branding
VITE_APP_NAME=TIMORA
VITE_APP_VERSION=2.1

Customization

TIMORA is built with customization in mind:

• Colors: Modify Tailwind config for custom themes
• Sounds: Replace audio generation in playChime() function
• Storage: Extend localStorage keys in LS_KEYS object
• Features: Add new session types or timer modes

---

🤝 Contributing

We love contributions! Here's how you can help make TIMORA even better:

🐛 Bug Reports

Found a bug? Open an issue with:

• Clear description of the problem
• Steps to reproduce
• Expected vs actual behavior
• Screenshots if applicable

✨ Feature Requests

Have an idea? Open a feature request with:

• Clear description of the feature
• Use cases and benefits
• Mockups or examples if helpful

🔧 Pull Requests

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📋 Development Guidelines

• Follow existing code style and patterns
• Add comments for complex logic
• Test on multiple screen sizes
• Ensure accessibility compliance
• Update documentation as needed

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License - feel free to use, modify, and distribute!

---

🙏 Acknowledgments

Built with ❤️ by the community

Special thanks to:

• 🎨 Tailwind CSS team for amazing utility classes
• ⚡ Framer Motion for smooth animations
• ⚛️ React team for the fantastic framework
• 🚀 Vite for lightning-fast development
• 📱 Capacitor for seamless mobile integration
• 🌟 Open source community for inspiration and feedback

Star History

---

📞 Connect & Support

Love TIMORA? Give us a ⭐ on GitHub and help others discover it!

⭐ Star this repo • 🐦 Share on Twitter • 📱 Download APK

---

Made with 💎 and ☕ by @ravixalgorithm

© 2025 TIMORA - Productivity redefined