Skip to content

wowohut/loop

Repository files navigation

Loop Icon

Loop

给女朋友写的生理期记录 App · 温柔、极简、全离线


✨ 简介

Loop 不是一个冷冰冰的健康工具——它更像一份温柔的陪伴。

打开 App,首页是一个安静呼吸的圆环;翻到日历,每一天被标记得清晰而优雅;洞察页会告诉她,下一次大概在什么时候。所有数据只保存在手机里,不联网,不登录,只属于你们两个人的小秘密。

🎨 设计语言

Pearl & Berry — 暖珍珠白 #FFFDFB × 浆果粉 #FF2D55

克制、干净、不刺眼,深色模式同样舒适。

📸 截图预览

💡 功能一览

页面 描述
首页 圆环动画展示周期进度,一键标记经期开始/结束
日历 左右滑动切月,历史记录实心标记,预测日期虚线提示,点击记录心情/流量/痛感/备注
洞察 平均周期、经期时长、规律性评分、近 6 次趋势图
设置 提醒开关 · 「来自他的话」每日情话 · CSV 导出

🔒 隐私

  • 全本地存储(Room),零网络请求
  • 导出 CSV 需用户手动选择保存位置
  • 不构成医疗建议,仅供个人记录参考

🛠 技术栈

  • 语言:Kotlin
  • UI:Jetpack Compose + Material 3
  • 架构:MVVM(ViewModel + StateFlow)
  • 存储:Room + KSP
  • 导航:Navigation Compose(底部三标签)
  • 最低版本:Android 7.0(API 24)

📂 项目结构

com.rhythm.loop
├── MainActivity.kt
├── data/
│   ├── dao/          # Room DAO
│   ├── db/           # 数据库实例与 Converters
│   ├── entity/       # 数据库实体
│   ├── model/        # 业务数据模型
│   └── prefs/        # 轻量偏好存储
├── navigation/       # 导航图定义
└── ui/
    ├── home/         # 首页圆环
    ├── calendar/     # 日历与记录面板
    ├── insights/     # 洞察与设置
    ├── navigation/   # 底部导航栏
    └── theme/        # Pearl & Berry 主题

🚀 构建与运行

# 1. Android Studio 运行:
# 打开项目 → 连上手机 → 点击绿色三角形 Run 'app'

# 2. 命令行编译测试版:
./gradlew :app:assembleDebug

# 3. 命令行编译正式版:
./gradlew :app:assembleRelease

📄 License

MIT License


Built with ❤️ for my girlfriend

About

「Loop」- 给女友定制的极简、优雅的生理期记录安卓APP

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages