FocusFlow is a sleek, distraction-free productivity application built with React and TypeScript. It leverages the Pomodoro Technique to help users manage their time effectively, offering detailed analytics and a customizable environment to maximize focus.
| Splash Screen | Focus Timer |
|---|---|
![]() |
![]() |
| Statistics | Settings |
![]() |
![]() |
Note: For the Focus Timer image, I used the placeholder link based on your pattern. Make sure to paste the correct
timer.jpglink if it differs!
- β±οΈ Advanced Timer Logic: Custom hooks handle focus sessions, short breaks, and long breaks with precise TypeScript state management.
- π Productivity Analytics: * Track daily focus vs. break time.
- Weekly consistency trends with visual charts.
- π¨ Personalization: Toggle themes (Dark/Light), adjust typography, and customize notification sounds.
- πΎ Persistent Storage: Uses
localStorageto keep your stats and settings saved even after closing the browser.
- Framework: React 18
- Language: TypeScript
- Build Tool: Vite
- Icons: Phosphor Icons / Lucide React
- State Management: React Hooks (useState, useEffect, useMemo)
To run this project locally, follow these steps:
- Clone the repository:
git clone [https://github.com/MoHamed-B-M/FocusFlow.git](https://github.com/MoHamed-B-M/FocusFlow.git)
- Navigate to the project directory:
cd FocusFlow - Install dependencies:
npm install
- Start the development server:
npm run dev
Hama
- IT Student at ISET Sidi Bouzid
- GitHub: @MoHamed-B-M
*Built with β€οΈ and focus.



