Note: To access all shared projects, get information about environment setup, and view other guides, please visit Explore-In-HMOS-Wearable Index.

HydrationWave

A fun, visual, and interactive daily hydration tracker designed for HarmonyOS wearable devices.

Instead of a boring water counter, HydrationWave turns your daily hydration into a game-like experience. Tap the growing water drop, fill the progress ring, and celebrate when you complete your daily goal.

Preview

Use Cases

• Minimal and touch-friendly hydration tracker for watches
• Gamified drinking habit formation
• Visual drop growth animation per sip
• Circular progress ring synced with daily goal
• Celebration animation when target is reached
• No phone needed — fully standalone HarmonyOS wearable experience

Tech Stack

Language

• ArkTS

SDK / Tools

• HarmonyOS SDK (Wearable, API 12+)
• DevEco Studio 5.x/6.x

Libraries / Kits

• Stage model: UIAbility
• ArkUI (Declarative)

Directory Structure

entry/
  src/main/ets/
    entryability/
      EntryAbility.ets     # app launcher ability
    pages/
      HydrationWave.ets    # main app screen
  src/main/resources/      # strings, media, etc.
  app.json5                # app/module configuration
hvigor/                    # build scripts (if present)

Constraints and Restrictions

• Platform scope
  • Designed for HarmonyOS wearable devices (round screens). Rectangular or very low‑resolution screens may require layout tweaks.
• Minimum API level
  • Wearable API 12+ is recommended. Earlier APIs may lack certain ArkUI features or performance optimizations.
• Performance and battery
  • Animations are lightweight but still consume power. Long‑running background tasks are intentionally avoided.
• Data model limitations
  • Single‑day tracking focused. The sample does not include historical charts or multi‑day analytics by default.
• Offline behavior
  • Fully offline; no network required. Sync to phone/cloud is not included in the sample.
• Storage
  • Local, lightweight state only (e.g., preferences). Large datasets and databases are out of scope.
• Localization (i18n)
  • Sample UI text is in English. For production, replace hard‑coded strings with resource references and add localized strings.
• Permissions and syscap
  • Basic UI functions require no special runtime permissions. If you add haptics/sound or advanced features, declare the corresponding syscaps/permissions in app/module config files.
• Accessibility
  • Color contrast and font scaling should be validated on target devices. Voice guidance is not included in the sample.
• Form factor variations
  • Layout and touch targets are optimized for small, round wearables; verify on different sizes to avoid clipping or overlap.

Supported Devices

• Huawei Watch series (HarmonyOS wearable)
• Recommended: HarmonyOS 5.1.0+ (Wearable, API 12+)

License (MIT)

HydrationWave is distributed under the terms of the MIT License.

See the LICENSE file for more information.