https://github.com/inledgroup/tocatoma
Reminder app for medication
https://github.com/inledgroup/tocatoma
Last synced: about 1 month ago
JSON representation
Reminder app for medication
- Host: GitHub
- URL: https://github.com/inledgroup/tocatoma
- Owner: InledGroup
- Created: 2026-04-19T17:17:48.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-04-19T17:46:26.000Z (about 1 month ago)
- Last Synced: 2026-04-19T19:29:55.828Z (about 1 month ago)
- Language: Astro
- Size: 3.63 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ๐ TOCATOMA
### *Your Vibrant, 3D Medication Companion*



**Tocatoma** is a high-performance, visually stunning medication manager for Android. Built with a "Duolingo-inspired" aesthetic, it turns the chore of tracking your health into a tactile and engaging experience.
---
## โจ Key Features
- **๐จ Duolingo-Style 3D UI:** Large, bouncy buttons and blocks with real depth. Every interaction feels satisfying.
- **โฐ Persistent Smart Alarm:** Unlike standard notifications, Tocatoma launches a full-screen "Wake-up" intent that rings for up to 1 minute until you take action.
- **๐ค Advanced Snooze:** Not ready? Postpone your dose by 5, 10, or 15 minutes with a single tap.
- **๐
Flexible Scheduling:** Pick specific days of the week for each medication. Your list only shows what you need *today*.
- **๐ธ Visual Memory:** Attach photos of your medication boxes to avoid confusion.
- **๐ Daily Progress:** Interactive "Check/Circle" system to track your intakes. Cards turn green once you're done!
- **๐พ Data Sovereignty:** Your data stays on your device in a local **SQLite** database. Export and Import your entire history as a JSON file anytime.
---
## ๐ Tech Stack
Designed with **Clean Architecture** (Hexagonal/DDD) and **Screaming Architecture** principles:
- **Frontend:** [Astro](https://astro.build/) (Strictly component-based, zero React overhead).
- **Styling:** [Tailwind CSS 4.0](https://tailwindcss.com/) & Custom 3D CSS primitives.
- **Native Bridge:** [Capacitor](https://capacitorjs.com/) with a custom Java **AlarmPlugin**.
- **Icons:** [Lucide Icons](https://lucide.dev/).
- **Persistence:** `@capacitor-community/sqlite`.
---
## โ ๏ธ Important Notes
### ๐งช Beta Version
This app is currently in **Beta**. We are actively refining the alarm persistence and background task handling for the latest Android versions (API 33+).
### ๐ช๐ธ Language Support
Please note that the **User Interface is currently available in Spanish only**. Multi-language support is planned for future releases.
---
## ๐ Deployment & CI/CD
Tocatoma features a fully automated build pipeline using **GitHub Actions**.
- **Automatic APK Generation:** Every time a commit message contains the tag `[RELEASE]`, a GitHub Action triggers a full build, generating an installable Android APK available in the "Actions" tab.
---
## ๐ Development
```bash
# Install dependencies
npm install
# Run web dev server
npm run dev
# Build web assets
npm run build
# Sync with Android project
npx cap sync android
# Open in Android Studio
npx cap open android
```
---
Developed with โค๏ธ by **JaimeGH**
*ยฉ 2026 Inled Groupยฎ - MIT-INLED Licensed.*