{"id":26334586,"url":"https://github.com/seanverano/reboost","last_synced_at":"2025-03-16T00:19:52.755Z","repository":{"id":252791480,"uuid":"840805810","full_name":"seanverano/reboost","owner":"seanverano","description":"Reboost is a Chrome extension with 2 core features, a hydration tracker for logging and tracking water intake and also a reminder for setting custom break alerts. ✨","archived":false,"fork":false,"pushed_at":"2025-03-12T17:45:16.000Z","size":4264,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-12T18:38:25.494Z","etag":null,"topics":["chrome-api","chrome-extension","react","tailwindcss"],"latest_commit_sha":null,"homepage":"https://chromewebstore.google.com/detail/reboost/bdlffpdkioakgjjpmgpboogfiaegbpgp","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seanverano.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}},"created_at":"2024-08-10T18:29:54.000Z","updated_at":"2025-03-12T17:45:20.000Z","dependencies_parsed_at":"2025-03-05T16:29:24.899Z","dependency_job_id":"40ee3a11-fb53-458b-8f91-ad472003215f","html_url":"https://github.com/seanverano/reboost","commit_stats":null,"previous_names":["seanverano/daily-reboot-chrome","seanverano/daily-reboot","seanverano/reboost"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seanverano%2Freboost","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seanverano%2Freboost/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seanverano%2Freboost/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seanverano%2Freboost/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seanverano","download_url":"https://codeload.github.com/seanverano/reboost/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243807010,"owners_count":20350944,"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","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":["chrome-api","chrome-extension","react","tailwindcss"],"created_at":"2025-03-16T00:19:52.187Z","updated_at":"2025-03-16T00:19:52.744Z","avatar_url":"https://github.com/seanverano.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# **Reboost**\n\nReboost is a Chrome extension with two features: a hydration tracker for logging water intake and a wellness reminder system for setting custom break alerts.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://i.imgur.com/Id14fNB.png\" alt=\"Reboost Banner\" style=\"width: 100%; height: auto;\"\u003e\n\u003c/p\u003e\n\n---\n\n## **🧭 Navigation**\n\n- [📋 Project Information](#seven)\n- [❓ The Problem](#one)\n- [🏛️ Project Architecture](#two)\n- [🌟 Key Features](#three)\n- [⚙️ Installation \u0026 Setup](#five)\n- [🛠️ Technologies Used](#six)\n- [📜 Changelog](#eight)\n- [🤝 Contributing](#four)\n\n---\n\n## \u003ca name=\"seven\"\u003e\u003c/a\u003e📋 Project Information\n\n### **Links**\n\n- 🔗[**Chrome Web Store**](https://chromewebstore.google.com/detail/reboost/bdlffpdkioakgjjpmgpboogfiaegbpgp)\n- 🔗[**Official Site**](https://reboost.fyi/)\n- 🔗[**Chrome Extension Source Code**](https://github.com/seanverano/reboost)\n- 🔗[**Official Site Source Code**](https://github.com/seanverano/reboost-site)\n- 🔗[**Demo Video \u0026 Preview**](https://www.youtube.com/watch?v=g8RL_s4DbIY)\n\nThis project was solely developed by me, **Sean Dustin Verano**.\n\nDevelopment started around October 2024, this Chrome extension is actively maintained to ensure stability, add features, and enhance user experience. With a growing user base, continuous updates keep it stable, functional, and user-friendly.\n\n---\n\n## \u003ca name=\"one\"\u003e\u003c/a\u003e❓ The Problem\n\nMany people forget to stay hydrated and take breaks while working or studying on a computer. Similar tools, like mobile apps, are often too generic, cluttered, and easy to ignore.\n\nA Chrome extension is more efficient and faster, keeping users focused without switching devices.\n\n---\n\n## \u003ca name=\"two\"\u003e\u003c/a\u003e🏛️ Project Architecture\n\n### **Frontend Overview**\n\nThe frontend is built using React + TailwindCSS. Below are the main routes:\n\n- **`/`**: Homepage with an overview and navigation.\n- **`/menu`**: Lets users choose between hydration tracking and reminders.\n- **`/hydration-tracker`**: Users can log and track their water intake.\n- **`/wellness-reminder`**: Allows users to set custom break reminders.\n\n### Chrome Extension APIs \u0026 Required Permissions\n\nReboost utilizes the following Chrome APIs, which require specific permissions to function properly:\n\n- **Alarms API (`alarms` permission)**: Schedules hydration reminders and break alerts in the background. The extension creates an alarm when a timer starts and listens for its completion to trigger notifications.\n- **Storage API (`storage` permission)**: Stores hydration logs, reminder settings, and user preferences in local storage. This ensures that timers persist even after the extension is closed or the browser is restarted.\n- **Notifications API (`notifications` permission)**: Sends non-intrusive pop-up notifications to remind users of their hydration goals and scheduled breaks. Notifications include interactive buttons for user acknowledgment.\n\n---\n\n## \u003ca name=\"three\"\u003e\u003c/a\u003e🌟 Key Features\n\n### **Dual Self-Care Tools in One**\n\n- **Hydration Tracker**: Log water intake and track progress toward daily hydration goals.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://i.imgur.com/BITNl1q.gif\" alt=\"Hydration Tracker GIF\" style=\"width: 60%; height: auto;\"\u003e\n\u003c/p\u003e\n\n- **Wellness Reminders**: Set personalized break reminders (Eye Break, Hydration, Posture etc.) with custom notes.\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://i.imgur.com/0xT2Y19.gif\" alt=\"Wellness Reminder GIF\" style=\"width: 40%; height: auto;\"\u003e\n\u003c/p\u003e\n\n- **Mini Pop-Up Notifications**: Get non-intrusive alert notification to stay on track without disrupting your workflow.\n- **Persistent Tracking \u0026 Insights**: Review daily hydration logs and countdown timers for upcoming breaks.\n\n### **Free, Lightweight \u0026 Privacy-Focused**\n\n- **Lightweight \u0026 Efficient**: Runs smoothly without slowing down your browser.\n- **No Account Required**: Use all features without signing up.\n- **No Data Tracking**: Your data stay on your device (local storage).\n- **Completely Free**: No hidden fees, subscriptions, or in-app purchases.\n\n---\n\n## \u003ca name=\"five\"\u003e\u003c/a\u003e⚙️ Installation \u0026 Setup\n\n### **1. Clone the repository:**\n\n```bash\ngit clone https://github.com/seanverano/reboost.git\n```\n\n### **2. Install dependencies:**\n\n```bash\nnpm install\n```\n\n### **3. Build the extension:**\n\n```bash\nnpm run build\n```\n\n### **4. Load the extension in Chrome:**\n\n1. Open Google Chrome and navigate to `chrome://extensions/`\n\n2. Enable **Developer Mode** (toggle in the top-right corner)\n\n3. Click **Load unpacked**\n\n4. Select the **build** folder inside your project\n\n### **Alternative Installation**\n\nIf you prefer to install the extension directly, visit [**Reboost - Chrome Web Store**](https://chromewebstore.google.com/detail/reboost-track-water-intak/bdlffpdkioakgjjpmgpboogfiaegbpgp)\n\n---\n\n## \u003ca name=\"six\"\u003e\u003c/a\u003e🛠️ Technologies Used\n\n- React\n- React Router\n- Tailwind CSS\n- React Icons\n- Chrome Extension APIs (Alarms, Storage, and Notifications)\n\n---\n\n## \u003ca name=\"eight\"\u003e\u003c/a\u003e📜 Changelog\n\nSee the latest updates and improvements of this project in the [**Changelog**](https://github.com/seanverano/reboost/blob/main/CHANGELOG.md).\n\n---\n\n## \u003ca name=\"four\"\u003e\u003c/a\u003e🤝 Contributing\n\nThis project is open for contributions! Feel free to submit issues and pull requests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseanverano%2Freboost","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseanverano%2Freboost","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseanverano%2Freboost/lists"}