The pet health app that works like a human medical record — but for your dog, cat, or any animal. Blockchain-verified. Offline-first. Free to start.
Every time you switch vets, move cities, or face a pet emergency — your animal's medical history is either lost, on paper in a drawer, or locked inside another clinic's software. There is no portable, owner-controlled pet health record. Until now.
Cocohub gives every pet a tamper-proof digital health passport — medication schedules, vaccination history, vet records, and emergency contacts — that lives on your phone, works offline, and can be shared with any vet via a QR code in seconds.
Records are verified on the Stellar blockchain (hashes only — no personal data ever on-chain), so any vet anywhere can independently confirm a record hasn't been altered.
▶ Try the web app live → — use
owner1@example.com/Password123!
| Feature | What it does | |
|---|---|---|
| 🔒 | Blockchain Records | SHA-256 hash of every record anchored on Stellar — tamper-proof forever |
| 💊 | Medication Reminders | Smart daily/weekly schedules, dose logging, refill tracking, drug interaction detection |
| 📅 | Appointments | Book vet visits, conflict detection, calendar sync |
| 🚨 | Emergency SOS | One-tap alert with live GPS to all emergency contacts |
| 📊 | Health Dashboard | A–F health score, weight trend chart, vitals history, AI predictive alerts |
| 📱 | QR Scanner | Scan any pet's QR code — instant record access, no app needed on vet's side |
| 🗺️ | Vet Finder | Nearby clinics on a live map via OpenStreetMap + Google Places |
| 🩺 | AI Symptom Checker | Describe symptoms → urgency triage + probable conditions + next actions |
| 🧬 | Breed Insights | Breed-specific health risks and care recommendations per pet |
| 📄 | PDF Import (OCR) | Photograph old paper records — AI extracts the data |
| 🎂 | Birthday Reminders | Annual birthday + age-based health milestone notifications |
| 🌐 | Offline-First | Full functionality with no internet — syncs when back online |
| 🔐 | Privacy-First | AES-256 encryption, biometric login, GDPR compliant |
| 🌍 | Multi-Language | English + Spanish, RTL support |
| 🩻 | Telemedicine | Video consultations via WebRTC |
| 👥 | Community | Forum, Lost & Found network, adoption matching |
Web app: cocohub.app/app
Test account:
Email: owner1@example.com
Password: Password123!
The web app works in demo mode even without the backend running — you'll see real UI with sample data.
Or run locally in 2 minutes — see Quick Start below.
Cocohub pays contributors in XLM (Stellar Lumens) via GrantFox smart escrow — released within 48 hours of your PR being merged.
| Size | Reward | Examples |
|---|---|---|
| 🟢 Small | 5–15 XLM | Bug fixes, docs, UI polish |
| 🟡 Medium | 20–50 XLM | New features, translations, test suites |
| 🔴 Large | 75–150 XLM | Soroban contracts, AI features, wearable sync |
👉 View all 25 open bounties → 👉 How to claim & get paid →
New to Stellar? Get a free wallet at Freighter.app in 2 minutes.
| Layer | Technology |
|---|---|
| Mobile/Web | React Native 0.85 + Expo SDK 56 |
| Language | TypeScript 5 |
| Navigation | React Navigation v6 |
| State | React Context + SQLite (offline) |
| Backend | Node.js 18, Express 5, PostgreSQL 15, Redis 7 |
| Blockchain | Stellar SDK + Soroban smart contracts |
| Local DB | expo-sqlite (AES-256 encrypted) |
| Auth | JWT + refresh tokens + OAuth (Google/Apple/Facebook) + biometrics |
| Push | Expo Notifications (APNs + FCM) |
| Maps | react-native-maps + OpenStreetMap |
| Video | react-native-webrtc |
| Error Tracking | Sentry |
| CI/CD | GitHub Actions (11 workflows) |
| Testing | Jest, Vitest, Testing Library, Detox, Maestro |
cocohub/
├── src/ # React Native app (75+ screens, 85+ services)
│ ├── screens/ # All UI screens
│ ├── components/ # 60+ shared components
│ ├── services/ # API + business logic
│ ├── navigation/ # App, Care, More navigators
│ ├── context/ # Auth, Pet, Theme, Toast providers
│ └── utils/ # Encryption, haptics, validators
├── backend/ # Node.js/Express API (50+ routes)
│ ├── server/ # Express app + route modules
│ ├── migrations/ # 30+ PostgreSQL migrations
│ └── seeds/ # Dev seed data
├── website/ # Next.js marketing site
├── android-widget/ # Android home screen widget (Java)
├── ios-widget/ # iOS home screen widget (Swift)
├── legal/ # Privacy Policy, Terms of Service
└── storelisting/ # App Store + Google Play metadata
Prerequisites: Node.js ≥ 18, Docker Desktop
# 1. Clone
git clone https://github.com/cocohub-mobileapp/cocohub-main.git
cd cocohub-main
# 2. Install
npm install --legacy-peer-deps
# 3. Run web app instantly (no backend needed)
npx expo start --web
# → open http://localhost:8081Full stack with backend:
docker-compose up # PostgreSQL + Redis + API
npm run migrate # Run DB migrations
npm run seed:dev # Seed test dataTest credentials: owner1@example.com / Password123!
Cocohub uses a dual-layer approach — your data stays private:
- Storage — Records stored encrypted on the Cocohub backend (AES-256)
- Verification — A SHA-256 hash of each record is anchored on Stellar via
manageData
No personal data is ever written to the blockchain. Only hashes. Any vet can verify a record independently by recomputing the hash and checking it against the on-chain value.
Record → SHA-256 hash → Stellar manageData tx → tamper-evident audit trail
Stellar assets:
PETC— Cocohub utility tokenVETH— Vet Health CreditsPAWP— PawPoints loyalty rewards
npm test # Unit tests (Jest)
npm run typecheck # TypeScript
npm run lint # ESLint
npm run e2e:test # Maestro E2E smoke testWe welcome everyone — from first-timers to senior engineers. See CONTRIBUTING.md.
Look for issues tagged good first issue — these are scoped, self-contained, and come with a bounty.
- AES-256-GCM encryption on all local SQLite data
- Tokens in device Keychain (iOS) / SecureStore (Android)
- HMAC-SHA256 request signing
- SSL certificate pinning
- Biometric re-auth on foreground
- Screen capture prevention on sensitive screens
- Rate limiting + Helmet headers on the backend
Report vulnerabilities privately to security@cocohub.app — do not open a public issue.
Cocohub is not a substitute for professional veterinary care. Always consult a licensed veterinarian.
| Channel | Link |
|---|---|
| 🐛 Issues | GitHub Issues |
| 💬 Discussions | GitHub Discussions |
| support@cocohub.app | |
| @cocohubapp | |
| 🌐 Website | cocohub.app |
MIT — see LICENSE for details.
Built with ❤️ for pet lovers everywhere · Powered by Stellar · Bounties via GrantFox