-FF6F00?style=for-the-badge&logo=dagger&logoColor=white){kind=icon}
- ✨ Overview
- 🚀 Features
- 🏛️ Architecture
- 📱 Screens
- 🎨 Brand System
- 🧩 Reusable Components
- 🛠️ Tech Stack
- 📁 Project Structure
- ⚡ Quick Start
- 🗺️ Navigation Flow
- 📊 Phase 1 — Foundation & Auth
- 🔥 Phase 2 — Resume & AI
- 🤖 Phase 3 — Interview & Feedback
- 📈 Phase 4 — Analytics & Features
- 🚀 Phase 5 — Production & Polish
- 🔮 Roadmap
- 📄 License
AIIC (AI Interview Coach) is a premium Android application that leverages artificial intelligence to help students and professionals prepare for placements, internships, and job interviews.
Think of it as having a world-class career coach in your pocket — available 24/7, personalized to your goals, and powered by cutting-edge AI.
The app is designed to feel like:
| Inspiration | Quality |
|---|---|
| 🍎 Apple | Polish & Attention to Detail |
| ⚡ Linear | Clarity & Minimalism |
| 💳 Stripe | Premium Branding |
| 🔍 Raycast | Modern Product Feel |
|
|
|
|
|
|
|
|
┌─────────────────────────────────────────────────────────────────┐
│ PRESENTATION │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Splash │ │Onboarding│ │ Auth │ │ Home │ │
│ │ Screen │ │ Screen │ │ Screens │ │Dashboard │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ │ │ │ │ │
│ ┌────┴─────────────┴─────────────┴─────────────┴─────┐ │
│ │ ViewModels │ │
│ │ (StateFlow + Channel Events) │ │
│ └────────────────────────┬───────────────────────────┘ │
├───────────────────────────┼─────────────────────────────────────┤
│ DOMAIN LAYER │
│ ┌────────────┐ ┌────────┴───────┐ ┌──────────────┐ │
│ │ Models │ │ Use Cases │ │ Repository │ │
│ │ (User, etc)│ │ (Login, etc) │ │ Interfaces │ │
│ └────────────┘ └────────────────┘ └──────┬───────┘ │
├─────────────────────────────────────────────┼───────────────────┤
│ DATA LAYER │ │
│ ┌────────────┐ ┌────────────────┐ ┌──────┴───────┐ │
│ │ DTOs │ │ DataStore │ │ Repository │ │
│ │ (Mappers) │ │ (Preferences) │ │ Impls │ │
│ └────────────┘ └────────────────┘ └──────────────┘ │
├─────────────────────────────────────────────────────────────────┤
│ DI (Hilt Modules) │
└─────────────────────────────────────────────────────────────────┘
| Screen | Description | Key Features |
|---|---|---|
| 🎬 Splash | Animated brand reveal | Scale + fade animation, gradient BG |
| 📖 Onboarding | 3-page feature tour | AnimatedContent, progress dots |
| 🔑 Login | Email + Google sign-in | Validation, loading states |
| 📝 Register | Full registration form | 4 fields, confirm password |
| 🔒 Forgot Password | Reset flow | Success animation |
| 🏠 Home | Dashboard shell | Hero, stats, quick actions |
| 👤 Profile | User profile | Avatar, settings menu |
| ⚙️ Settings | App settings | Toggle switches |
| 📄 Resume Dashboard | Upload & manage | File picker, cloud sync |
| 📋 Resume Detail | Stats & PDF Preview | Native PdfRenderer engine |
| 🤖 Resume Analysis | AI Intelligence | ATS Score, Skills, Recommendations |
| 🎯 Interview Setup | Configure session | Role, difficulty |
| 💬 Interview Session | Live interview | Timer, voice input |
| 📊 Session Summary | Results dashboard | Score rings, AI feedback |
| 📈 Analytics | Performance tracking | Smart time formatting |
| 💡 Interview Tips | Expert strategies | Daily challenges |
┌─────────────────────────────────────────────────────────────────┐
│ AIIC COLOR PALETTE │
├──────────────┬──────────────┬──────────────┬────────────────────┤
│ PRIMARY │ SECONDARY │ ACCENT │ BACKGROUND │
│ #7C5CFC │ #00D4AA │ #FF6B9D │ #0A0A0F │
│ Electric │ Mint │ Rose │ Deep Dark │
│ Violet │ Green │ Pink │ │
├──────────────┴──────────────┴──────────────┴────────────────────┤
│ │
│ TYPOGRAPHY │
│ ├── Display: Space Grotesk (Bold, -1.5sp tracking) │
│ ├── Headlines: Space Grotesk (SemiBold) │
│ ├── Body: Inter (Regular, 16sp) │
│ ├── Labels: Inter (SemiBold, 12sp) │
│ └── Buttons: Inter (SemiBold, 15sp) │
│ │
│ EFFECTS │
│ ├── Glassmorphism (10% white overlay) │
│ ├── Gradient buttons (Violet → Rose) │
│ ├── Soft glow accents │
│ └── Shimmer loading animations │
│ │
└─────────────────────────────────────────────────────────────────┘
| Component | Description |
|---|---|
PremiumButton |
Gradient button with loading spinner |
GlassCard |
Translucent glassmorphism card |
ScoreCard |
Metric display with accent color |
FeatureCard |
Icon + title + description row |
AIICTextField |
Custom input with password toggle & validation |
SectionHeader |
Title + subtitle + action link |
LoadingShimmer |
Animated placeholder skeleton |
EmptyStateView |
Empty content placeholder |
ErrorStateView |
Error display with retry button |
AppLogo |
Gradient circle with "AI" text |
GradientText |
Text with gradient brush fill |
PdfViewerScreen |
Native PDF renderer with pinch-to-zoom |
| Layer | Technology | Purpose |
|---|---|---|
| Language | Kotlin | Primary development language |
| UI Framework | Jetpack Compose | Declarative UI |
| Design System | Material Design 3 | Component library |
| Architecture | MVVM + Clean | Separation of concerns |
| DI | Hilt (Dagger) | Dependency injection |
| Navigation | Navigation Compose | Screen routing |
| Async | Coroutines + StateFlow | Reactive state management |
| Persistence | DataStore Preferences | Local key-value storage |
| Auth | Firebase Auth | Email/Password + Google OAuth |
| Database | Cloud Firestore | User profiles + real-time sync |
| Storage | Firebase Storage | Resume PDFs + profile photos |
| AI | Groq API (Llama 3.3) | Interview evaluation + resume analysis |
| Android PdfRenderer | Native PDF page rendering | |
| Camera | CameraX + MLKit | AI Live Interview (ProctorAI) |
# 1. Clone the repository
git clone https://github.com/Pravesh0005/AIIC.git
# 2. Open in Android Studio (Ladybug+)
# 3. Sync Gradle dependencies
# 4. Run on emulator or device (API 26+)| Requirement | Version |
|---|---|
| Android Studio | Ladybug (2024.2.1) or later |
| JDK | 17 |
| Min SDK | 26 (Android 8.0) |
| Target SDK | 35 (Android 15) |
| Gradle | 8.9 |
| AGP | 8.7.3 |
┌──────────┐ ┌──────────────┐ ┌──────────┐ ┌──────────┐
│ Splash │─▶ │ Onboarding │────▶│ Login │───▶│ Home │
│ Screen │ │ (3 pages) │ │ Screen │ │Dashboard │
└──┬───────┘ └──────────────┘ └────┬─────┘ └──────────┘
│ (returning user skips to login/home) │
│ ┌──────┴──────┐
│ ▼ ▼
│ ┌──────────┐ ┌──────────┐
│ │ Register │ │ Forgot │
│ │ Screen │ │ Password │
│ └────┬─────┘ └──────────┘
│ │
│ ▼
│ ┌───────────┐
│ │ Account │
│ │ Setup │──────▶ Home
│ └───────────┘
│
└──▶ (logged in) ──────────────────────▶ Home
+ ✅ Phase 1.1: Project Foundation
+ ✅ Project Setup & Gradle Configuration
+ ✅ Version Catalog (libs.versions.toml)
+ ✅ Premium Dark Color Palette (60+ tokens)
+ ✅ Typography System (Inter + Space Grotesk)
+ ✅ Shape & Spacing Design Tokens
+ ✅ Material 3 Theme Integration
+ ✅ Hilt Dependency Injection
+ ✅ Navigation Graph with Transitions
+ ✅ BaseViewModel + UiState + UiEvent
+ ✅ Repository Pattern (Domain + Data)
+ ✅ Splash Screen with Animations
+ ✅ 3-Page Onboarding Flow
+ ✅ Home Dashboard Shell
+ ✅ Profile & Settings Screens
+ ✅ 10+ Reusable Components
+
+ ✅ Phase 1.2: Firebase Auth & Backend
+ ✅ Firebase BOM + Auth + Firestore + Storage + Analytics
+ ✅ Google Sign-In + CredentialManager
+ ✅ NetworkResult sealed class for type-safe API responses
+ ✅ FirebaseAuthRepository (login, register, Google, reset)
+ ✅ FirestoreUserRepository (CRUD, real-time listener)
+ ✅ SessionRepositoryImpl (DataStore-backed persistence)
+ ✅ 8 Use Cases (Login, Register, Reset, Logout, Google, etc.)
+ ✅ Production-grade Auth UI (Login, Register, Forgot Password)
+ ✅ AccountSetupScreen — career goals, skills, skip option
+ ✅ Complete Hilt DI module with Firebase singletons+ ✅ Phase 2.1: Resume Platform Core
+ ✅ File Picker Integration (PDF Uploads)
+ ✅ Firestore Resume Document Storage (Version History)
+ ✅ Cloud Storage Resume File Uploading
+ ✅ ResumeDetailScreen (Stats, Metadata, Actions)
+ ✅ ResumeDashboardScreen & ResumeHistoryScreen
+
+ ✅ Phase 2.2: AI Resume Intelligence Engine
+ ✅ Generative AI SDK Integration (Groq Llama 3.3)
+ ✅ Prompt Engineering Pipeline (Structured JSON constraints)
+ ✅ Real-Time ATS Score Engine
+ ✅ Skill Categorization & Keyword Gap Analysis
+ ✅ Actionable AI Recommendation Cards
+ ✅ Animated State Management (Analyzing, Success, Failed)+ ✅ Phase 3.1: AI Mock Interview Engine
+ ✅ Interview Setup Screen (Role, Difficulty, Configuration)
+ ✅ Interview Session Engine (State Machine for Interviews)
+ ✅ Generative AI Real-Time Answer Evaluation
+ ✅ Groq API (Llama 3.3) Integration for high availability
+ ✅ Distraction-Free Interview UI with Live Timer
+ ✅ Interview Summary Dashboard
+ ✅ Firestore Session, Question, and Answer Tracking
+
+ ✅ Phase 3.2: AI Feedback & Evaluation Engine
+ ✅ Real-Time AI Answer Evaluation & Scoring
+ ✅ AnswerFeedbackScreen (Strengths, Weaknesses, Improvements)
+ ✅ Actionable Session Summaries & Score Rings
+ ✅ Deterministic AI JSON Parsing Engine
+ ✅ Target Role Context Injection+ ✅ Phase 4.1: Analytics Dashboard
+ ✅ Comprehensive Interview Report Screen
+ ✅ Analytics Dashboard with performance tracking
+ ✅ Smart practice time formatting
+
+ ✅ Phase 4.2: ProctorAI Engine (AI Live Interview)
+ ✅ CameraX + MLKit eye tracking integration
+ ✅ Interview permission gate system
+ ✅ AI Live Interview feature card on Home
+
+ ✅ Phase 4.3: Interview Tips & Mastery
+ ✅ Expert strategy cards with daily challenges
+
+ ✅ Phase 4.4: Stabilization & Repair
+ ✅ @Singleton AnswerRepository + Firestore persistence
+ ✅ Offline-first data model for session summaries
+ ✅ Groq-Only Architecture for high availability
+ ✅ Navigation Hardening & dead link removal
+ ✅ Resume Analysis cache-first persistence fix
+ ✅ API timeout & token limit tuning (8192 tokens, 30s)
+ ✅ Microphone auto-recovery on audio errors+ ✅ Phase 5.1: Native PDF Preview Engine
+ ✅ PdfViewerViewModel with Firebase Storage download
+ ✅ PdfViewerScreen with pinch-to-zoom & double-tap zoom
+ ✅ Inline PDF preview in ResumeDetailScreen
+ ✅ Animated download/rendering states
+
+ ✅ Phase 5.2: Engine Stabilization
+ ✅ Smart practice time formatting (eliminates 0.00802h bug)
+ ✅ Retrying vs Analyzing state separation in Resume Analysis
+ ✅ Phase naming convention migration (Day → Phase)
+
+ ✅ Phase 5.3: Build & Syntax Hardening
+ ✅ CameraX Unresolved Reference fix (setSurfaceProvider)
+ ✅ Interview Permission Gate structural fix (named parameters)
+ ✅ Material Icon Resolution (Whatshot replacement)
+ ✅ Compose Experimental API opt-ins (@OptIn)
+
+ ✅ Phase 5.4: Production Polish & Presentation
+ ✅ Full multi-page PDF export engine (PdfDocument API)
+ ✅ FileProvider integration for secure PDF sharing
+ ✅ Face detection hardened (5-frame threshold, glasses-safe)
+ ✅ Editable voice transcript with inline edit button
+ ✅ Premium golden gradient Start Practice button
+ ✅ Resume "Pending Analysis" state bug fix
+ ✅ Graceful AI fallback messages (no more API key errors)
+ ✅ Increased AI token limit to 8192 for long answers
+ ✅ Microphone silence timeout extended to 5s
+
- ⬚ Phase 5.5: Play Store Release (Upcoming)
- ⬚ ProGuard & R8 optimization
- ⬚ Play Store listing & screenshots
- ⬚ Demo Video GenerationPhase 1.1 ██████████████████████████████ 100% — Project Foundation ✅
Phase 1.2 ██████████████████████████████ 100% — Firebase Auth & Backend ✅
Phase 2.1 ██████████████████████████████ 100% — Resume Platform Core ✅
Phase 2.2 ██████████████████████████████ 100% — AI Resume Intelligence ✅
Phase 3.1 ██████████████████████████████ 100% — AI Mock Interview Engine ✅
Phase 3.2 ██████████████████████████████ 100% — AI Feedback Engine ✅
Phase 4.1 ██████████████████████████████ 100% — Analytics Dashboard ✅
Phase 4.2 ██████████████████████████████ 100% — ProctorAI Engine ✅
Phase 4.3 ██████████████████████████████ 100% — Interview Tips & Mastery ✅
Phase 4.4 ██████████████████████████████ 100% — Stabilization & Repair ✅
Phase 5.1 ██████████████████████████████ 100% — PDF Preview Engine ✅
Phase 5.2 ██████████████████████████████ 100% — Engine Stabilization ✅
Phase 5.3 ██████████████████████████████ 100% — Build & Syntax Hardening ✅
Phase 5.4 ██████████████████████████████ 100% — Production Polish ✅
Phase 5.5 ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0% — Play Store Release
This project is proprietary and protected under a custom license.
See the LICENSE file for details.
© 2026 Pravesh Jakhar — All Rights Reserved.
Built with ❤️ by Pravesh Jakhar
Premium Android Engineering • Clean Architecture • AI-Powered Coaching
⭐ Star this repo if you find it impressive! ⭐
- Extracted and implemented pixel-perfect custom neon icons for Resume Feedback flows.
- Applied 'Shine of Earth' radial glow gradients to all Auth interfaces.
- Resolved edge-to-edge system navigation clipping issues.