🎯 TIMORA

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! 🎯

• Node.js 16+
• npm or yarn

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 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)

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!

• ✅ 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

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

• 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!