{"id":28489956,"url":"https://github.com/preveen369/pomodoro-app","last_synced_at":"2026-04-10T01:01:15.800Z","repository":{"id":295047508,"uuid":"988923057","full_name":"Preveen369/pomodoro-app","owner":"Preveen369","description":"Pomodoro App is a React-based productivity tool combining a to-do list with the Pomodoro technique. Built with Tailwind CSS and LocalStorage, it features task management, themes, and is deployable via Firebase Hosting.","archived":false,"fork":false,"pushed_at":"2025-06-04T18:10:58.000Z","size":126,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-30T20:44:13.178Z","etag":null,"topics":["firebase","react","tailwind-css","vite"],"latest_commit_sha":null,"homepage":"https://pomodoro-app-7b05a.firebaseapp.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Preveen369.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-23T09:28:45.000Z","updated_at":"2025-06-04T18:11:01.000Z","dependencies_parsed_at":"2025-06-30T20:32:37.996Z","dependency_job_id":"eec7f243-4fc4-4142-aa15-033508a016c3","html_url":"https://github.com/Preveen369/pomodoro-app","commit_stats":null,"previous_names":["preveen369/pomodoro-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Preveen369/pomodoro-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Preveen369%2Fpomodoro-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Preveen369%2Fpomodoro-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Preveen369%2Fpomodoro-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Preveen369%2Fpomodoro-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Preveen369","download_url":"https://codeload.github.com/Preveen369/pomodoro-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Preveen369%2Fpomodoro-app/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266324294,"owners_count":23911226,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-21T11:47:31.412Z","response_time":64,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["firebase","react","tailwind-css","vite"],"created_at":"2025-06-08T07:07:01.223Z","updated_at":"2025-12-30T22:07:00.778Z","avatar_url":"https://github.com/Preveen369.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⏰ Pomodoro-App – A Productivity Web App\n\n![Platform](https://img.shields.io/badge/Platform-Web-blue.svg)\n![Tech](https://img.shields.io/badge/Frontend-React-orange.svg)\n![Tech](https://img.shields.io/badge/UI-Tailwind%20CSS-emerald.svg)\n![Language](https://img.shields.io/badge/Language-JavaScript-yellow.svg)\n![License](https://img.shields.io/badge/License-MIT-lightgrey.svg)\n\n**Pomodoro-App** is a beautifully designed productivity application that integrates a to-do list with the Pomodoro time-management technique. Built using React, JavaScript, and Tailwind CSS, it offers a seamless user experience with features like task management, a customizable timer, and a progress dashboard. The app uses LocalStorage for data persistence, supports multiple themes, hosted on Firebase Hosting for scalable deployment.\n\n🔗 **Project Demo**: \u003chttps://pomodoro-app-7b05a.firebaseapp.com/\u003e\n\n---\n\n## 🚀 Features\n\n### 📋 Task Management\n- Add, edit, delete, and reorder tasks with drag-and-drop functionality.  \n- Organize tasks efficiently to boost productivity.\n\n### ⏲️ Pomodoro Timer\n- Customizable work and break durations for focused sessions.  \n- Start, pause, and reset the timer with ease.\n\n### 📊 Progress Dashboard\n- Displays task completion stats and Pomodoro session history.  \n- Tracks productivity trends over time.\n\n### ⚙️ Settings Panel\n- Personalize the app with user-defined settings.  \n- Adjust timer durations and other preferences.\n\n### 🎨 Multiple Themes\n- Choose from Tomato, Mint, and Midnight themes.  \n- Enhances visual appeal and user engagement.\n\n### 💾 LocalStorage Persistence\n- Saves tasks and user preferences locally.  \n- Ensures data retention across sessions.\n\n### 📱 Mobile-Responsive Design\n- Adapts seamlessly to different screen sizes.  \n- Provides a consistent experience on all devices.\n\n### ⌨️ Keyboard Shortcuts\n- Boosts productivity with shortcuts like `Space` to start/pause, `R` to reset, and more.  \n- Includes shortcuts for quick navigation and actions.\n\n---\n\n## 🛠️ Tech Stack\n\n- **Frontend**: React, JavaScript, Tailwind CSS  \n- **State Management**: Context API  \n- **Data Persistence**: LocalStorage  \n- **Icons**: Lucide React  \n- **Hosting**: Firebase Hosting  \n\n---\n\n## 📂 Project Structure\n\n```\npomodoro-app/\n    ├── src/\n    │   ├── components/         # UI components\n    │   │   ├── Dashboard/      # Progress dashboard components\n    │   │   ├── Header/         # App header components\n    │   │   ├── PomodoroTimer/  # Timer modal components\n    │   │   ├── Settings/       # Settings modal components\n    │   │   └── TaskList/       # Task list components\n    │   ├── context/            # React Context providers\n    │   ├── hooks/              # Custom React hooks\n    │   ├── types/              # TypeScript interfaces and types\n    │   ├── utils/              # Utility functions\n    │   ├── App.tsx             # Main app component\n    │   └── main.tsx            # Entry point\n    ├── dist/                   # Production build output\n    ├── .firebaserc             # Firebase configuration file\n    └── firebase.json           # Firebase hosting configuration\n```\n\n---\n\n## 🧪 Installation \u0026 Setup\n\n### 📋 Prerequisites\n- Node.js (v14 or higher)  \n- npm or yarn  \n- Firebase CLI (optional, if deploying with Firebase)\n\n### 🧑‍💻 Steps to run\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/yourusername/pomodoro-todo.git\n   cd pomodoro-todo\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   # or\n   yarn\n   ```\n\n3. **Start the development server**\n   ```bash\n   npm run dev\n   # or\n   yarn dev\n   ```\n   🌐 Open your browser and navigate to `http://localhost:5173`.\n\n4. **Build for Production**\n   ```bash\n   npm run build\n   # or\n   yarn build\n   ```\n   The built files will be in the `dist` directory.\n\n5. **(Optional) Deploy with Firebase**\n   - Initialize Firebase: `firebase init`\n   - Deploy: `firebase deploy`\n\n    🌐 Access your app live at: \u003chttps://pomodoro-app-7b05a.firebaseapp.com/\u003e\n---\n\n## 🤝 Contributing\n\nPull requests are welcome! Feel free to fork the repository and suggest improvements.\n\nSteps to contribute:\n\n```bash\n# 1. Fork the repository\n# 2. Create a feature branch\ngit checkout -b feature-name\n\n# 3. Commit your changes\ngit commit -m \"Add feature description\"\n\n# 4. Push to GitHub\ngit push origin feature-name\n\n# 5. Open a Pull Request\n```\n\n---\n\n## 📧 Contact\nFor queries or suggestions:\n- 📩 Email: [spreveen123@gmail.com](mailto:spreveen123@gmail.com)\n- 🌐 LinkedIn: [www.linkedin.com/in/preveen-s/](https://www.linkedin.com/in/preveen-s/)\n\n---\n\n## 🌟 Show Your Support\nIf you like this project, please consider giving it a ⭐ on GitHub!\n\n## 🌟 Show Your Support\n\nIf you like this project, please consider giving it a ⭐ on GitHub!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpreveen369%2Fpomodoro-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpreveen369%2Fpomodoro-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpreveen369%2Fpomodoro-app/lists"}