Skip to content

KuroTDM/KuroFront

Repository files navigation

Kuro 🏥

A modern Android healthcare application built with Jetpack Compose, designed to streamline medical appointment management, prescription tracking, and doctor-patient communication.

📱 Features

  • User Authentication: Secure Firebase Authentication with Google Sign-in integration
  • Appointment Management: Schedule, view, and manage medical appointments
  • Doctor Directory: Browse and connect with healthcare professionals
  • Prescription Tracking: Digital prescription management with QR code scanning
  • Push Notifications: Real-time updates via Firebase Cloud Messaging
  • Camera Integration: Barcode scanning for prescription verification
  • Offline Support: Local data storage with Room database
  • Modern UI: Built with Jetpack Compose and Material Design 3

🛠️ Tech Stack

Core Technologies

  • Language: Kotlin
  • UI Framework: Jetpack Compose
  • Architecture: MVVM (Model-View-ViewModel)

🚀 Getting Started

Installation

  1. Clone the repository

    git clone https://github.com/KuroTDM/KuroFront.git
    cd KuroFront
  2. Firebase Setup

    • Create a Firebase project at Firebase Console
    • Enable Authentication, Cloud Messaging, and Analytics
    • Download google-services.json and place it in the app/ directory
    • Update the configuration in your Firebase project
  3. Build the project

    ./gradlew build
  4. Run the application

    • Connect an Android device or start an emulator
    • Run the app from Android Studio or use:
    ./gradlew installDebug

Configuration

  1. API Configuration: Update base URLs and endpoints in your network configuration
  2. Firebase Configuration: Ensure google-services.json is properly configured

🏗️ Architecture

This application follows the MVVM (Model-View-ViewModel) architecture pattern:

  • Models: Data classes and entities (Room database, API responses)
  • Views: Composable UI components and screens
  • ViewModels: Business logic and state management
  • Repositories: Data access layer abstracting network and local storage

📱 Screenshots

View our application UI and features in this presentation.

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

About

A Kotlin-based mobile app that simplifies healthcare management by enabling patients to book, manage, and track appointments with doctors. Features include real-time doctor listings, QR code check-ins, digital prescriptions, offline mode with synchronization, and push notifications.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages