🐨 Koala Hydrate — Drink Water Reminder

Stay hydrated while you code with a friendly, animated Aussie Koala companion!

Features • Configuration • Commands • How It Works • License

✨ Why Koala Hydrate?

Long coding sessions often mean hours of hyperfocus without taking a single sip of water. Koala Hydrate brings a delightful, animated Koala character right into VS Code that pops up at your preferred interval (every 30 minutes, 1 hour, or 2 hours) to ask:

"Did you drink water, mate?"

Choose "💧 Yes, I drank water!" or "😅 No, not yet..." and watch the Koala react in real time:

🎉 If Yes: The Koala bursts into celebration! Bouncing with joy, raising victory paws, showering confetti and eucalyptus leaves, accompanied by a cheery celebratory chime.
🥺 If No: The Koala turns comically heartbroken! Sagging droopy ears, dramatic cartoon waterfall tears, a shivering slump, and funny guilt-tripping Aussie quotes like "My eucalyptus leaves are withering just looking at you!"
⏳ Auto-Dismiss: After displaying the reaction, the Koala smoothly fades out and disappears in a few seconds so you can jump right back to your code without interruption.

🚀 Features

⏱️ Flexible Intervals: Choose presets of 30 minutes, 1 hour (60m), or 2 hours (120m), or configure any custom minute frequency.
🐨 Expressive Vector Animations: Smooth SVG character animations for Asking, Celebrating, and Crying states.
💧 Interactive Feedback: Click "Yes" or "No" directly in the popup, or Snooze for 5 minutes if you're in the middle of a delicate git rebase.
⏳ Smart Auto-Disappear: Displays the happy or sad reaction, then gracefully closes itself after a few seconds (configurable: 2–15s).
📊 Hydration Tracking & Streaks: Automatically logs your daily glasses (e.g. 8/8) and builds your day-to-day hydration streak.
🎵 Built-in Synthesized Sound Effects: Uses Web Audio API for zero-lag cheerful chimes and sad cartoon slide whistles (can be toggled on/off).
📌 Live Status Bar Countdown: Displays time until your next water break (🐨 28m | 💧 3/8) with a one-click Quick Menu.
⚙️ Customizable Alert Modes: Choose between interactive Webview Popups, standard VS Code notifications, or both.

🖼️ Koala Reactions Preview

State	Preview & Reaction
🤔 Inquiring	Friendly Koala holding a fresh glass of water with ice and straw, asking "Did you drink water, mate?" with interactive Yes / No buttons.
🎉 Happy (Yes)	Ecstatic jumping Koala with glowing heart eyes, thumbs up, dancing eucalyptus leaves, and confetti! Plays an upbeat chime.
🥺 Sad (No)	Dramatically weeping Koala with comical waterfall tears, drooping fuzzy ears, and an empty tipped glass. Reminds you to drink up!

⚙️ Configuration

Configure Koala Hydrate in your VS Code Settings (Cmd + , on macOS or Ctrl + , on Windows/Linux) or search @ext:cloud-mavericks.koala-hydrate:

Setting	Default	Description
`koalaHydrate.intervalMinutes`	`60`	Preset reminder interval: `30` (every 30m), `60` (every 1 hour), or `120` (every 2 hours).
`koalaHydrate.customIntervalMinutes`	`null`	Optional custom interval in minutes (e.g., `45` or `90`). Overrides presets if set.
`koalaHydrate.reminderStyle`	`"popup"`	Alert style: `"popup"` (animated Koala panel), `"notification"` (toast), or `"both"`.
`koalaHydrate.popupAutoDismissSeconds`	`4`	How many seconds the reaction shows before disappearing automatically (2–15s).
`koalaHydrate.enableSound`	`true`	Play cute synthesized audio chimes for happy and sad reactions.
`koalaHydrate.dailyGoalGlasses`	`8`	Your daily hydration target in glasses (default: 8).
`koalaHydrate.showStatusBarTimer`	`true`	Show countdown timer and glass count in the status bar.
`koalaHydrate.snoozeMinutes`	`5`	Minutes to snooze when you click Snooze.

⌨️ Commands

Access these commands from the VS Code Command Palette (Cmd + Shift + P or Ctrl + Shift + P):

Koala Hydrate: Check Hydration Now (Test Koala) — Immediately pops up the animated Koala reminder.
Koala Hydrate: Change Reminder Interval (30m / 1h / 2h) — Quick menu to adjust how often the Koala appears.
Koala Hydrate: Log a Glass of Water (💧) — Manually increment your daily hydration counter.
Koala Hydrate: View Hydration Stats & Streaks — View today's total, best streak, and lifetime statistics.
Koala Hydrate: Pause Reminders — Temporarily pause reminders during meetings or presentations.
Koala Hydrate: Resume Reminders — Resume your scheduled reminders.
Koala Hydrate: Reset Today's Water Count — Reset today's drink counter back to 0.

Click on the 🐨 [Time] (💧 X/Y) item in your VS Code status bar at any time to open the Quick Menu:

[+] Log a Glass of Water (💧)
[♥] Check on Koala (Trigger Reminder)
[⏰] Change Interval (30m / 1h / 2h / Custom)
[📊] View Hydration Stats & Streaks
[⏸] Pause Reminders
[⚙] Extension Settings

🧪 Development & Building

To build or package the extension from source:

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Bundle extension for production
npm run build

# Package into a .vsix marketplace file
npm run package

Koala Hydrate - Drink Water Reminder

VineethBatreddy