MedX is a Flutter-based mobile application designed to help doctors track patient records across multiple hospitals. The app provides two distinct flows: a "Personal" flow for patients and a "Medical" flow for doctors, ensuring a seamless and secure experience for all users.
-
Account Management:
- Doctors and patients can create new accounts and log in using Firebase Authentication.
- SharedPreferences is utilized to store login status, allowing users to directly access the main screen after their first login.
-
User Profiles:
- User details and profile pictures are stored securely in Firebase Firestore and Firebase Storage.
-
Medical Record Management:
- Doctors can add and delete patient records, with data securely stored in Firebase Firestore.
-
Frontend:
- Flutter
-
Backend:
- Firebase Authentication
- Firebase Firestore
- Firebase Storage
To run this project locally, follow these steps:
-
Clone the repository:
git clone https://github.com/Esfokom/MedX.git
-
Navigate to the project directory:
cd MedX
-
Install dependencies:
flutter pub get
-
Set up Firebase:
- Follow the official Firebase documentation to connect your Flutter app with Firebase.
- Make sure to add your
google-services.json
(for Android) andGoogleService-Info.plist
(for iOS) files to the appropriate directories.
-
Run the app:
flutter run
- lib/: Contains the main source code.
main.dart
: Entry point of the application.screens/
: Contains the UI screens for both patient and doctor flows.services/
: Contains the service classes for Firebase authentication, Firestore, and Storage operations.models/
: Contains the data models used in the app.widgets/
: Contains reusable widgets.
Add screenshots of your app here.
Contributions are welcome! If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Distributed under the MIT License. See LICENSE
for more information.
Elvis Owusu - Email
Project Link: https://github.com/Esfokom/MedX