📱KChat

A Flutter-based chat application designed for university departments, enabling students to connect and communicate with their departmental peers in a secure and organized environment.

---

📦 Download APK

👉 Click here to download the latest APK

Note: After clicking the link, you will be redirected to a drive to download the APK file.

---

🎯 Overview

KChat is a department-wise chat application that allows university students to register with their specific departments and chat exclusively with their departmental colleagues. The app features AI-powered conversations, group chats, file sharing, and real-time messaging with a modern, intuitive interface.

✨ Features

🔐 Authentication & Security

• Firebase Authentication for secure user management
• Email verification required during registration
• Password reset functionality
• Profile protection with password verification for edits

👥 Department-Based Networking

• Department selection during registration
• Department-exclusive user visibility
• Real-time user status (active/inactive)
• Profile customization with image uploads

💬 Chat Features

• Real-time messaging with departmental peers
• Group chat creation with selected members
• File sharing (images and PDFs)
• Message notifications when logged out
• Chat history persistence

🤖 AI Integration

• Gemini API integration for AI conversations
• Groq API (Llama3-8b-8192) for enhanced AI responses
• Smart chat assistance for students

📁 File Management

• Image sharing in chats
• PDF document sharing
• Profile picture uploads
• Secure file storage via Supabase

🛠️ Tech Stack

Frontend

• Flutter - Cross-platform mobile development
• Dart - Programming language
• Get - State management and navigation
• Google Fonts - Typography

Backend Services

• Firebase Auth - User authentication
• Cloud Firestore - Document database
• Firebase Realtime Database - Real-time data sync
• Supabase - File storage and management

Ai Integrations & APIs

• Gemini API - AI chat functionality
• Groq API - Advanced AI responses
• Flutter PDF - PDF handling and viewing

📦 Dependencies

dependencies:
  cupertino_icons: ^1.0.8
  firebase_core: ^3.13.1
  firebase_auth: ^5.5.4
  get_it: ^8.0.3
  dash_chat_2: ^0.0.21
  cloud_firestore: ^5.6.8
  firebase_database: ^11.3.6
  uuid: ^4.5.1
  google_fonts: ^6.2.1
  delightful_toast: ^1.1.0
  path: ^1.9.1
  image_picker: ^1.1.2
  badges: ^3.1.2
  get: ^4.7.2
  http: ^1.4.0
  pdf: ^3.11.3
  syncfusion_flutter_pdf: ^29.2.7
  file_picker: ^10.1.9
  flutter_dotenv: ^5.2.1
  fluttertoast: ^8.2.12
  toastification: ^3.0.2
  supabase_flutter: ^2.9.0
  url_launcher: ^6.3.1
  flutter_pdfview: ^1.3.2
  path_provider: ^2.1.5
  flutter_markdown: ^0.7.7+1
  intl: ^0.19.0

---

Screenshots:

Splash Screen

Register

Login

Reset Password

Home

Chat page

One can send and view image and pdfs

Edit profile

Correct password is required to modify profile

Group Chat

Chat with Ai

User can switch between Gemini and Groq

Notifications

Notifications will arrive if you are inactive

Email verification and Reset password mails

---

🚀 Getting Started

Prerequisites

• Flutter SDK (latest stable version)
• Android Studio / VS Code
• Firebase project setup
• Supabase project setup
• Gemini API key
• Groq API key

Installation

1. Clone the repository

   git clone https://github.com/AHMED-SAFA/KChat.git
   cd kchat

2. Install dependencies

   flutter pub get

3. Configure Firebase

   • Create a new Firebase project
   • Add your Android/iOS app to the project
   • Download and add google-services.json (Android) and GoogleService-Info.plist (iOS)
   • Enable Authentication, Firestore, and Realtime Database

4. Configure Supabase

   • Create a new Supabase project
   • Set up storage buckets for profile images and chat files
   • Note your project URL and anon key

5. Environment Setup Create a .env file in the root directory:

   GEMINI_API_KEY=
   GROQ_API_KEY=
    
   FIREBASE_API_KEY_ANDROID=
   FIREBASE_APP_ID_ANDROID=
   FIREBASE_MESSAGING_SENDER_ID=
   FIREBASE_PROJECT_ID=
   FIREBASE_STORAGE_BUCKET=
    
   FIREBASE_API_KEY_IOS=
   FIREBASE_APP_ID_IOS=
   FIREBASE_IOS_BUNDLE_ID=
    
   FIREBASE_API_KEY_WEB=
   FIREBASE_APP_ID_WEB=
   FIREBASE_AUTH_DOMAIN=
   FIREBASE_MEASUREMENT_ID=
    
   SUPABASE_URL=
   SUPABASE_ANON_KEY=

6. Run the app

   flutter run

📱 App Structure

lib/
├── models/           # Data models
├── services/         # API and database services
├── controllers/      # State management
├── widgets/         # Reusable components
├── utils/           # Helper functions
└── main.dart        # App entry point

🔧 Configuration

Supabase Storage Policies

Set up appropriate storage policies for file uploads based on user authentication.

Setup SupaBase

Future<void> setupSupabase() async {
  await Supabase.initialize(
    url: dotenv.env['SUPABASE_URL']!,
    anonKey: dotenv.env['SUPABASE_ANON_KEY']!,
  );
}

Setup FireBase

Future<void> setupFirebase() async {
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
}

🎨 Features in Detail

Registration Flow

1. User provides email, password, name, and department
2. Profile picture selection (optional)
3. Email verification sent
4. Account activated only after email verification

Department-Based Chat

• Users only see peers from their selected department
• Real-time status updates
• Group creation with departmental colleagues

AI Chat Integration

• Seamless integration with Gemini and Groq APIs
• Context-aware responses
• Educational assistance for students

File Sharing

• Image sharing with preview
• PDF document sharing with built-in viewer
• Secure cloud storage via Supabase

🤝 Contributing

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