PawTrack is a smart and intuitive Flutter-based mobile application that helps pet owners monitor their pets’ health and location in real time. Designed with convenience in mind, PawTrack offers user authentication, multiple pet profiles, and customizable themes to make tracking your furry friend's well-being simple and effective.

Stay connected with your pet — wherever they go. 🐶🐱

✅ Pet Health Tracking – Monitor key health metrics for each pet.
✅ Real-Time Location Tracking – Live GPS tracking powered by Firebase.
✅ User Authentication – Secure login and sign-up using Firebase Authentication.
✅ Multiple Pet Profiles – Manage and track multiple pets from a single account.
✅ Customizable Themes – Switch between dark and light themes for a personalized look.

No need to install anything! You can preview PawTrack instantly in your browser: Click here to run the app

The app will open in an emulator. Use the on-screen buttons to navigate through the Welcome and Login Screens.

Home Page	Add Pet	Profile Page

Heart Rate	Battery Settings	Theme Toggle

Heart Rate Threshold	Location & Geofence

Hardware	Pet Wearing it

Make sure you have the following installed:

• ✅ Flutter SDK (>=3.27.0)
• ✅ Dart SDK (>=3.0.0 <4.0.0)
• ✅ Android Studio or VS Code (with Flutter & Dart plugins)
• ✅ A configured Firebase project

git clone <repository-url>
cd pawtrack

flutter pub get

PawTrack uses a .env file to securely load Firebase configuration data.

• Request the .env file from a team member (via secure means like email or encrypted storage).
• Place it in the root of the project directory.
• Example structure:

FIREBASE_PROJECT_ID=your_project_id
FIREBASE_APP_ID=your_app_id
FIREBASE_API_KEY=your_api_key
FIREBASE_MESSAGING_SENDER_ID=your_sender_id
FIREBASE_STORAGE_BUCKET=your_bucket_url

⚠️ Do NOT commit .env to GitHub. It's already listed in .gitignore.

flutter run

• On first launch, you'll be greeted with the Welcome Page.
• After login or sign-up, the Home Page will guide you through pet management.

pawtrack/
│
├── android/               # Android-specific files
├── ios/                   # iOS-specific files
├── lib/                   
│   ├── auth/              # Firebase auth logic
│   ├── components/        # Reusable UI widgets
│   ├── pages/             # Screens (Home, Welcome, Profile, etc.)
│   ├── services/          # Firebase and app logic
│   ├── theme/             # Light/Dark mode settings
│   ├── utils/             # Helpers and constants
│   └── main.dart          # Entry point
├── assets/                
│   ├── images/            # App icons and logos
│   └── .env               # Environment variables (ignored by Git)
├── pubspec.yaml           # Dependencies
└── README.md              # Project documentation

• Firebase integration is manually handled via environment variables.
• Do not include the following sensitive files:
  • google-services.json
  • GoogleService-Info.plist
  • firebase_options.dart
  • firebase.json

🛠 For Firebase changes, contact the project admin for an updated .env file.

💥 Build Fails?

• Make sure .env exists and is correctly populated.

🔐 Authentication Not Working?

• Double-check Firebase setup and that the firebase_auth version is compatible.

🎨 Theme Not Switching?

• Ensure ThemeProvider is implemented and wired correctly with Provider.

🚧 The following features are planned for future development:

• 📍 Live GPS Mapping
• 🩺 Pet Health Logbook (vet visits, vaccinations)
• 🔔 Push Notifications for alerts (e.g., escaped pet, health warning)
• 🧠 Behavior Analytics

We welcome contributions! To get started:

1. Fork the repository
2. Create a branch:

git checkout -b feature/my-feature

3. Commit your changes:

git commit -m "Describe the feature"

4. Push and open a Pull Request:

git push origin feature/my-feature

✅ Please describe your changes clearly in the PR!

This project is licensed under the MIT License. See the LICENSE file for details.

Have questions or suggestions? Reach out via GitHub Issues, or email the project maintainer.

🚀 Track smarter. Care better. With PawTrack. 🐾