kSmart

kSmart is a mobile and web application project designed to support people with chronic kidney disease (CKD) in tracking dietary phosphorus intake and daily health habits. It also provides tools for healthcare professionals to monitor patient records.

Project goals

• Help patients record meals and understand daily phosphorus intake.
• Support medication records and daily health routines.
• Help healthcare professionals review patient information and reports.

Features

• Daily food records and phosphorus calculations
• Food and recipe recommendations
• Medication tracking
• Daily tasks and rewards
• Patient health reports
• Warnings when phosphorus intake exceeds configured limits

Technology and structure

• app/, components/, assets/, locales/: Expo / React Native application, UI resources and translations
• backend/: Node.js, Express and MySQL backend
• ReactAppE/: Additional React Native starter project included in the original source

Local setup

The project currently uses Expo SDK 49 and React Native 0.72.6. Compatibility with newer runtimes has not been verified.

Backend

1. Create a MySQL database using an appropriate schema.
2. Copy backend/.env.example to backend/.env and set your own database credentials and JWT secret.
3. Run npm install and npm start from backend/.

Database dumps and user/patient backups are excluded from this repository. Database provisioning is required before the backend can run.

Application

1. Run npm install from the project root.
2. Update API_BASE_URL in config.js to the reachable backend address.
3. Run npm start for Expo, or use npm run android, npm run ios, or npm run web.

Data and credentials

Keep local credentials in environment files. Do not commit real user or patient records. This repository contains project source code; uploading it does not deploy a running service.