🐾 Cocohub

Secure pet health records, medication reminders, QR scanning, and emergency SOS — powered by blockchain.

Cocohub is a full-stack mobile and web application for pet owners to securely manage their pets' medical records, medication schedules, vet appointments, and emergency contacts. Built with React Native and Expo, backed by a Node.js/PostgreSQL API, and anchored to the Stellar blockchain for tamper-proof record verification.

Cocohub is an open-source project with paid bounties. We pay contributors in XLM (Stellar Lumens) via GrantFox smart escrow for bug fixes, features, tests, translations, and docs.

👉 View all open bounties → 👉 How to contribute & get paid →

cocohub/
├── src/                      # React Native app
│   ├── navigation/           # AppNavigator, CareNavigator, MoreScreen
│   ├── screens/              # 75+ screens
│   ├── components/           # 60+ shared components
│   ├── services/             # 85+ API + business logic services
│   ├── context/              # Auth, Pet, Theme, Toast providers
│   ├── theme/                # Colors, tokens, dark/light mode
│   ├── hooks/                # Custom hooks
│   ├── utils/                # Encryption, validators, animations
│   └── __web_stubs__/        # Web-safe stubs for native modules
├── backend/                  # Node.js API
│   ├── server/               # Express app + routes
│   ├── src/                  # Services, models, middleware
│   ├── migrations/           # PostgreSQL migrations
│   └── seeds/                # Development seed data
├── website/                  # Next.js marketing site
│   └── src/app/              # Landing page, Privacy, Terms
├── assets/                   # App icons, splash screen
├── legal/                    # Privacy Policy, Terms of Service
├── storelisting/             # App Store + Google Play metadata
├── App.tsx                   # Native entry point
├── App.web.tsx               # Web entry point
├── metro.config.js           # Metro bundler config
└── docker-compose.yml        # PostgreSQL + Redis + backend

• Node.js ≥ 18
• Docker Desktop (for backend)
• Expo Go on your phone (for mobile testing)

git clone https://github.com/DogStark/Cocohub-MobileApp.git
cd Cocohub-MobileApp
npm install --legacy-peer-deps

npx expo start --web

Open http://localhost:8081 in your browser.

npx expo start

Scan the QR code with Expo Go on iOS or Android. Phone and PC must be on the same Wi-Fi.

# Start PostgreSQL + Redis + API
docker-compose up

# In a new terminal — run migrations and seed test data
npm run migrate
npm run seed:dev

Test credentials after seeding:

Email:    owner1@example.com
Password: Password123!

The website/ folder contains the Next.js marketing site.

cd website
npm install
npm run dev        # http://localhost:3001

Pages:

• / — Landing page (hero, features, download CTAs)
• /privacy — Privacy Policy
• /terms — Terms of Service

Environment:

# website/.env.local
NEXT_PUBLIC_APP_URL=http://localhost:8081   # local
# NEXT_PUBLIC_APP_URL=https://app.cocohub.app  # production

Deploy to Vercel:

cd website
npx vercel --prod

1. Install Expo Go from App Store or Play Store
2. Run npx expo start
3. Scan the QR code

npm install -g eas-cli
eas login
eas build --platform android --profile preview

EAS builds it in the cloud and gives you a direct APK download link — no Play Store needed.

eas build --platform ios --profile preview

Requires an Apple Developer account.

npm run seed:dev     # 5 owners, 10 pets, records, appointments, medications
npm run seed:test    # Minimal — 2 owners, 1 vet, 1 pet
npm run seed:large   # 20 owners, 30 pets, large dataset

Seed data flags:

npm test                    # Unit tests (Jest)
npm run test:ci             # CI mode with coverage
npm run typecheck           # TypeScript check
npm run lint                # ESLint
npm run e2e:test            # Maestro E2E smoke test (requires device)

Cocohub uses a dual-layer verification approach:

1. Storage layer — Medical records are stored encrypted on the Cocohub backend
2. Verification layer — A SHA-256 hash of each record is anchored on the Stellar blockchain via manageData operations

No personal data is ever written to the blockchain — only hashes.

Stellar assets:

Future: Soroban smart contract for on-chain pet record registry with vet access control.

Assets and metadata are ready in:

• storelisting/ — App Store + Google Play descriptions, keywords, release notes
• legal/ — Privacy Policy and Terms of Service
• assets/ — Icons and splash screen

See storelisting/README.md for the submission checklist.

• All local data encrypted with AES-256-GCM via expo-sqlite
• Auth tokens stored in device Keychain (iOS) / SecureStore (Android)
• HMAC-SHA256 request signing on all API calls
• SSL pinning for production API endpoints
• Biometric re-authentication on foreground
• Screen capture prevention on sensitive screens
• Circuit breaker + exponential backoff on all network calls
• Rate limiting and Helmet security headers on the backend

See CONTRIBUTING.md for the development workflow, branch naming, and PR guidelines.

• Privacy Policy
• Terms of Service

Cocohub is not a substitute for professional veterinary care. Always consult a licensed veterinarian for medical advice.

MIT — see LICENSE for details.

Built with ❤️ for pet lovers everywhere · Powered by Stellar