A modern, feature-rich Pomodoro timer with session-specific task management and beautiful animations
π Live Demo β’ π± Download APK β’ π Report Bug β’ β¨ Request Feature
π Web App | π± Android APK |
---|---|
Instant access, no installation | Full mobile experience |
Always up-to-date | Offline support |
Cross-platform compatible | Native Android integration |
- Download the latest APK from Releases
- Enable "Install from unknown sources" on your Android device
- Install the APK file
- Enjoy TIMORA on your mobile! π―
|
|
- Node.js 16+
- npm or yarn
-
Clone the repository
git clone https://github.com/ravixalgorithm/timora.git cd timora
-
Install dependencies
npm install # or yarn install
-
Start development server
npm run dev # or yarn dev
-
Open your browser
http://localhost:5173
# 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)
Technology | Purpose | Version |
---|---|---|
UI Framework | 18+ | |
Styling | 3+ | |
Animations | Latest | |
Build Tool | 4+ | |
Mobile | 6+ | |
Audio | Native |
Key | Action |
---|---|
Space |
Start/Pause timer |
R |
Reset timer |
C |
Open/Close configuration |
Esc |
Close modals |
- Click "Configure" to open timer settings
- Set duration using hours, minutes, seconds inputs
- Add session name (e.g., "Deep Work", "Study Session")
- Add session tasks - specific to this timer session
- Click "Done" and start your focused work!
- β 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
- π Review session in the history panel
- π― See task completion rates and statistics
- π Start new session or adjust current timer
- πΎ All data saved automatically
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
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
We love contributions! Here's how you can help make TIMORA even better:
Found a bug? Open an issue with:
- Clear description of the problem
- Steps to reproduce
- Expected vs actual behavior
- Screenshots if applicable
Have an idea? Open a feature request with:
- Clear description of the feature
- Use cases and benefits
- Mockups or examples if helpful
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
- Follow existing code style and patterns
- Add comments for complex logic
- Test on multiple screen sizes
- Ensure accessibility compliance
- Update documentation as needed
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License - feel free to use, modify, and distribute!
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
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