🚀 CareerLens: AI-Powered Career Development Platform

Your Personal AI-Powered Career Co-Pilot with Premium Glassmorphism UI

🌟 Complete Career Management | 🤖 AI-Powered Insights | 📚 20M+ Learning Resources | 🎓 Smart Recommendations

Live Demo | Architecture | Features

📋 Table of Contents

Overview
Core Features
Technology Stack
Google Cloud Services
Architecture
AI Features Deep Dive
Project Structure
Getting Started
Deployment

🔥 Recent Updates (November 2025)

Latest Updates (Security & Feature Enhancements)

Security Improvements 🔒

Privacy-First Location Services: Removed all exact coordinate displays from UI
Project ID Sanitization: Removed hardcoded Google Cloud project IDs from all files
Secure External Links: Added rel="noopener noreferrer" to prevent reverse tabnabbing
Generic Documentation: Made all documentation project-agnostic and reusable
Error Logging: Enhanced geolocation error handling with console logging for debugging

Library Finder Enhancements 📚

User Location Marker: Green circle indicator shows your current position on map
Distance Calculation: Haversine formula calculates accurate distances to each library
Smart Distance Display: Shows "350 meters away" or "2.3 km away" based on distance
Auto-Sort by Distance: Libraries automatically sorted nearest first
Recenter Button: Quick navigation back to your location
Auto-Center on Load: Map automatically centers when location permission granted
Enhanced Notifications: Toast messages show nearest library distance
Hydration Fix: Resolved React hydration errors with proper HTML structure
Deprecated API Cleanup: Removed open_now property warnings
Privacy-Preserving UI: Location status shows "Ready to find nearby libraries" instead of coordinates
User-Friendly Errors: Clear error messages for geolocation failures with specific guidance

News Feature Enhancements 📰

Politics Category Added: Complete category list now includes Politics filter
Functional Search: Enter key and search button now trigger API searches
Secure External Links: "Read Full Article" uses proper anchor tags with security attributes
Better UX: Loading states and clear user feedback

Community/College Finder Improvements 🎓

Real-Time Data: Disabled mock mode (MOCK_ENABLED = false) for live Reddit data
Data Source Tracking: Visual indicators show "Live from Reddit" or "Demo Data"
Fixed Reddit URLs: Proper post format generation for "View on Reddit" links
CORS Resolution: Server-side proxy eliminates browser CORS errors

Resume Evaluator Updates 📄

File Type Restriction: Only .txt, .doc, .docx accepted (PDF removed)
Clear Warnings: Updated UI with explicit file type guidance
Better Validation: Enhanced error messages for unsupported formats

Calendar Feature 📅

UI Text Update: Navigation button changed from "Today" to "Month" for clarity

Configuration & Documentation 📚

Environment Setup: Detailed .env configuration with API enablement links
Security Best Practices: Generic URLs without project-specific identifiers
Setup Instructions: Step-by-step Google Cloud Console guidance

New Features Added

1. College Recommendations System

📊 42 Colleges Database covering all major Indian entrance exams
🎯 Smart Filtering by exam type, rank, fees, location
📈 AI-Powered Ranking with score calculation
💬 Reddit Reviews Integration for authentic student feedback
🔍 Search & Filter colleges by name or exam

2. Reddit Reviews Integration

🔄 Server-Side API Proxy to bypass CORS restrictions
💬 5 Reviews Per College with realistic mock data
😊 Sentiment Analysis (Positive/Negative/Neutral)
🏷️ Topic Extraction (Placements, Faculty, Infrastructure, etc.)
⚡ Smart Caching (5-minute) and rate limiting
🎭 Mock Data System for consistent user experience

3. eBooks Library (Internet Archive)

📚 20M+ Free Books from Internet Archive
🔍 Advanced Search with filters (genre, language, format, year)
⭐ Bookmark System with localStorage persistence
📜 Search History tracking (last 20 searches)
🤖 AI Recommendations based on browsing patterns
📊 Three Tabs: Search Results, Bookmarks, Trending
🌈 Modern UI with purple/pink gradient theme

4. Firebase Fixes

🔒 Updated Security Rules for 5 new collections
✅ Fixed Permission Errors (activities, eventReminders, fcmTokens, cache, colleges)
🔄 Changed updateDoc to setDoc with merge for 6 functions
🛡️ Eliminated "No document to update" errors

5. Navigation Enhancements

📖 Added eBooks Link to desktop navigation
📱 Updated Mobile Menu with eBooks in tools section
🎨 Consistent UI/UX across all pages

�🌟 Overview

🎓 CareerLens - AI-Powered Career Guidance Platform

Mission: Empowering students and professionals with AI-driven career insights, personalized learning paths, and real-time industry data to bridge the gap between education and employment.

Problem We Solve: Students often struggle to find relevant courses, mentors, and career guidance tailored to their unique goals. CareerLens uses Google Cloud's Generative AI and real-time data aggregation to provide personalized career recommendations, skill gap analysis, and live industry insights—all in one platform.

✨ Complete Feature List

🎯 Career Management

1. Career Navigator

AI-powered career path recommendations
Personalized roadmaps based on skills and interests
Industry-specific guidance
Skill gap analysis with actionable steps
Integration with Gemini 2.5 Flash for intelligent suggestions

2. Career Graph Visualization

Interactive node-based career graph (React Flow)
GitHub-style 365-day activity heatmap
Skill network visualization
Progress tracking & milestones
AI-powered readiness score

3. Career Updates Feed

Latest industry news and trends
Personalized content recommendations
Real-time updates from multiple sources
Bookmark favorite articles
Share insights with community

📊 AI-Powered Tools

4. AI Career Insights (Gemini 1.5 Pro)

Comprehensive career analysis
Industry trends & predictions
Salary insights & comparisons
Job market demand analysis
Long-term career planning

5. AI Skills Recommender (620 lines)

Personalized skill development paths
Real-time skill demand analysis
Learning resource suggestions
Skill priority rankings
Progress tracking

6. AI Resume Optimizer

ATS-friendly resume generation
Resume scoring & analysis
Job-specific tailoring
Resume parser for existing resumes
PDF/DOCX support
Download & share resumes

7. AI Interview Preparation

Mock interview with conversational AI
Role-specific questions with model answers
Voice recognition support (planned)
Performance feedback & scoring
Industry-specific interview prep

8. AI Project Generator (580 lines)

Context-aware project recommendations
Complexity matching (beginner to advanced)
Implementation guides & tutorials
Technology stack suggestions
GitHub integration (planned)

9. AI Chat Assistant (Copilot)

Real-time career guidance
Technical problem-solving
Learning assistance
Code review & suggestions
Multi-turn conversations

🎓 Education & Learning

10. College Recommendations (42 Colleges)

Comprehensive college database (IITs, NITs, IIITs, BITS, etc.)
Advanced filtering (location, courses, fees, placements)
Real-time Reddit reviews integration
College comparison tool
Placement statistics & rankings
Campus photos & virtual tours

11. eBooks Library (20M+ Books)

Internet Archive integration
Multiple formats (PDF, EPUB, TXT)
Advanced search with filters
Bookmark management (localStorage)
Reading progress tracking
Genre-based discovery

12. Course Discovery

NPTEL integration (12,000+ courses)
Coursera course scraping
AWS Educate cloud training
Google Cloud Skills Boost
YouTube educational videos
Personalized recommendations

13. Certification Hub (450 lines)

25+ curated certifications
Industry-recognized credentials
Free & paid options
Progress tracking
Certificate verification

14. Learning Roadmaps

Technology-specific paths
Skill progression tracking
Resource recommendations
Time estimates & milestones
Community-driven content

📚 Resource Discovery

15. Library Finder

Google Maps API integration
Real-time location tracking
Distance calculation (Haversine formula)
Library search by city/area
Ratings & reviews (Google Places)
Photos & amenities
Directions & navigation

16. News Feed (NewsAPI)

Latest industry news articles
Indian & global coverage
Category filtering (Tech, AI, Career)
Article caching (5-min TTL)
Bookmark articles
Social sharing

17. Mentor Discovery

Google Custom Search integration
LinkedIn profile search
Industry expert discovery
Connection recommendations
Mentorship matching (planned)

🗓️ Productivity Tools

18. AI Calendar (Google Calendar API)

Event management & synchronization
AI event suggestions (Gemini-powered)
Smart reminders (Firebase Cloud Messaging)
Today's tasks widget
Streak tracking & productivity scores
Calendar integration across devices
Task completion tracking

19. English Language Helper

AI-powered language learning
Grammar correction
Pronunciation guidance
Vocabulary building
Conversation practice
IELTS/TOEFL prep

👤 Profile & Gamification

20. Intelligent Profile Management

Multi-tab profile editor (6 sections)
3D visual dashboard
Achievement tracking
Skill endorsements
Activity feed
Real-time Firebase sync
Gamified milestones

21. Skill Gap Analyzer

Current skills vs. target role comparison
Learning resource recommendations
Timeline estimation
Progress tracking
Certification suggestions

🌐 Community Features

22. College Reviews (Reddit Integration)

Real-time Reddit discussions
Server-side proxy (CORS bypass)
Sentiment analysis
Topic extraction
Mock data fallback
Community voting

23. Social Sharing

Share achievements
Post career milestones
Collaborative learning
Peer recommendations
Discussion forums (planned)

🎨 UI/UX Features

24. Premium Glassmorphism Design

Neon color scheme (Cyan #00E5FF, Purple #A57CFF, Emerald #00FFC6)
Animated mesh wave background
Smooth page transitions (Framer Motion)
Responsive design (mobile-first)
Dark mode optimized
Accessibility compliant (WCAG 2.1)

25. Interactive Components

shadcn/ui component library (40+ components)
Radix UI primitives
Custom animations
Loading skeletons
Toast notifications
Modal dialogs

⚙️ Technical Features

26. Performance Optimization

Server-Side Rendering (SSR)
Static Site Generation (SSG)
Image optimization (WebP, lazy loading)
Code splitting & dynamic imports
Edge functions (low latency)
CDN distribution

27. Caching Strategies

API response caching (Firestore, 5-min TTL)
localStorage persistence (bookmarks, preferences)
Service worker caching (planned)
Browser caching headers

28. Security & Privacy

Firebase Auth (Google OAuth 2.0)
JWT token authentication
Firestore security rules
HTTPS-only enforcement
API rate limiting
Input validation (Zod schemas)
XSS/CSRF protection

29. Real-Time Features

Firestore real-time listeners
Live data updates
Push notifications (FCM)
Activity feed updates
Collaborative editing (planned)

30. Background Jobs

Cloud Functions schedulers
Data refresh (every 24h)
Automated notifications
Analytics collection
Cache invalidation

📱 Mobile Features

31. Progressive Web App (PWA) - Planned

Offline support
Install to home screen
Push notifications
Background sync
App-like experience

📊 Analytics & Monitoring

32. Performance Monitoring

Firebase Performance Monitoring
Page load times
API response tracking
User engagement metrics
Error logging

33. User Analytics

Firebase Analytics
Event tracking
Conversion funnels
User behavior analysis
A/B testing (planned)

🏗 Complete Architecture

System Architecture Diagram

┌──────────────────────────────────────────────────────────────────────────────┐
│                            CLIENT LAYER                                      │
│  ┌─────────────────────────────────────────────────────────────────────────┐ │
│  │  Next.js 15.5.6 (React 18) + TypeScript + Tailwind CSS                  │ │
│  │  • Premium Glassmorphism UI (Neon Cyan/Purple/Emerald Theme)            │ │
│  │  • Framer Motion Animations + Mesh Wave Background                      │ │
│  │  • shadcn/ui Components + Radix UI Primitives                           │ │
│  │  • Responsive Design (Mobile-First)                                     │ │
│  └─────────────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────┬───────────────────────────────────────────┘
                                   │
                                   ▼
┌──────────────────────────────────────────────────────────────────────────────┐
│                         PRESENTATION LAYER                                   │
│  ┌──────────────────────┬──────────────────────┬─────────────────────────┐ │
│  │ 19+ Pages            │ 65+ Components       │ 14 Services             │ │
│  │ • Dashboard          │ • Career Navigator   │ • Reddit API            │ │
│  │ • Career Navigator   │ • AI Chat            │ • Internet Archive      │ │
│  │ • Career Graph       │ • Resume Builder     │ • College Finder        │ │
│  │ • AI Calendar        │ • Interview Prep     │ • Web Scraper           │ │
│  │ • Career Updates     │ • News Feed          │ • Google Search         │ │
│  │ • Colleges (42)      │ • Library Finder     │ • AI Summarizer         │ │
│  │ • eBooks (20M+)      │ • College Cards      │ • Calendar Service      │ │
│  │ • News Feed          │ • Book Search        │ • Profile Service       │ │
│  │ • Library Finder     │ • Profile Gamified   │ • News Service          │ │
│  │ • English Helper     │ • Bookmark Manager   │ • Library Service       │ │
│  └──────────────────────┴──────────────────────┴─────────────────────────┘ │
└──────────────────────────────────┬───────────────────────────────────────────┘
                                   │
                                   ▼
┌──────────────────────────────────────────────────────────────────────────────┐
│                          APPLICATION LAYER                                   │
│  ┌────────────────────────────────────────────────────────────────────────┐ │
│  │  API Routes (Server-Side Logic)                                        │ │
│  │  • /api/college-recommendations → College search & filtering           │ │
│  │  • /api/reddit-search → Reddit proxy (CORS bypass + mock data)        │ │
│  │  • /api/news → NewsAPI proxy with caching                             │ │
│  │  • /api/ebooks/archive/* → Internet Archive integration               │ │
│  │  • /api/courses/scrape → Real-time course scraping                    │ │
│  │  • /api/parse-resume → Resume parsing & analysis                      │ │
│  │  • /api/career-navigator → AI career recommendations                  │ │
│  │  • /api/ai/career-summary → Gemini AI summarization                   │ │
│  │  • /api/english-helper → AI language learning                         │ │
│  │  • /api/copilot/chat → AI chat assistant                              │ │
│  └────────────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────┬───────────────────────────────────────────┘
                                   │
                                   ▼
┌──────────────────────────────────────────────────────────────────────────────┐
│                        GOOGLE CLOUD PLATFORM                                 │
│  ┌─────────────────────────────────────────────────────────────────────────┐ │
│  │  Firebase Services (Backend as a Service)                               │ │
│  │  ┌────────────────┬─────────────────┬──────────────────────────┐       │ │
│  │  │ Authentication │ Firestore DB    │ Cloud Storage            │       │ │
│  │  │ • Google OAuth │ • Users         │ • Resume Files           │       │ │
│  │  │ • Email/Pass   │ • Profiles      │ • Profile Photos         │       │ │
│  │  │ • Session Mgmt │ • Reviews       │ • Assets                 │       │ │
│  │  │                │ • Colleges      │ • Background Images      │       │ │
│  │  │                │ • Cache         │                          │       │ │
│  │  │                │ • Activities    │                          │       │ │
│  │  └────────────────┴─────────────────┴──────────────────────────┘       │ │
│  │                                                                          │ │
│  │  ┌────────────────┬─────────────────┬──────────────────────────┐       │ │
│  │  │ App Hosting    │ Cloud Functions │ Cloud Messaging          │       │ │
│  │  │ • Next.js Deploy│ • Schedulers   │ • Push Notifications     │       │ │
│  │  │ • Auto-scaling │ • Background Jobs│ • FCM Tokens            │       │ │
│  │  │ • CDN          │ • Data Refresh  │ • Event Reminders        │       │ │
│  │  └────────────────┴─────────────────┴──────────────────────────┘       │ │
│  └─────────────────────────────────────────────────────────────────────────┘ │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────────┐ │
│  │  Google AI (Gemini)                                                     │ │
│  │  • Gemini 1.5 Pro → Career recommendations, summarization               │ │
│  │  • Gemini 2.5 Flash → Fast AI responses, chat, interview prep           │ │
│  │  • Vertex AI → Advanced AI workflows & model management                 │ │
│  │  • Context caching → Reduced latency & costs                            │ │
│  └─────────────────────────────────────────────────────────────────────────┘ │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────────┐ │
│  │  Google Cloud Services                                                  │ │
│  │  • Cloud Run → Serverless container deployment                          │ │
│  │  • BigQuery → Analytics & data warehousing (planned)                    │ │
│  │  • Cloud Storage → Asset hosting & backups                              │ │
│  │  • Cloud Functions → Background processing & cron jobs                  │ │
│  │  • Looker Studio → Data visualization dashboards (planned)              │ │
│  └─────────────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────┬───────────────────────────────────────────┘
                                   │
                                   ▼
┌──────────────────────────────────────────────────────────────────────────────┐
│                         EXTERNAL INTEGRATIONS                                │
│  ┌─────────────────────────────────────────────────────────────────────────┐ │
│  │  Google APIs                                                            │ │
│  │  • Custom Search API → Course discovery, mentor search                  │ │
│  │  • Maps API → Library finder (location tracking, directions)            │ │
│  │  • Places API → Library search, ratings, photos                         │ │
│  │  • Calendar API → Event management, sync                                │ │
│  │  • YouTube API → Educational video recommendations                      │ │
│  └─────────────────────────────────────────────────────────────────────────┘ │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────────┐ │
│  │  Third-Party APIs                                                       │ │
│  │  • Reddit JSON API → College reviews (server-side proxy)                │ │
│  │  • Internet Archive API → 20M+ free books search                        │ │
│  │  • NewsAPI.org → Latest news articles                                   │ │
│  │  • NPTEL API → Indian courses (IIT lectures)                            │ │
│  │  • Coursera API → Course scraping                                       │ │
│  │  • AWS Educate → Cloud computing courses                                │ │
│  │  • Google Cloud Skills Boost → GCP certifications                       │ │
│  └─────────────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────────────┘

                                   ▼

┌──────────────────────────────────────────────────────────────────────────────┐
│                          DATA FLOW                                           │
│                                                                              │
│  1. User Action → Client Component                                          │
│  2. Client → API Route (Server-Side)                                        │
│  3. API Route → Service Layer (Business Logic)                              │
│  4. Service → External APIs / Firebase / Gemini AI                          │
│  5. Response → API Route → Client → UI Update                               │
│                                                                              │
│  ✅ Server-Side Rendering (SSR) for SEO                                     │
│  ✅ Client-Side Navigation (CSR) for speed                                  │
│  ✅ Edge Functions for low latency                                          │
│  ✅ Caching strategies (Redis + localStorage)                               │
└──────────────────────────────────────────────────────────────────────────────┘

Architecture Highlights

Multi-Layer Design

Client Layer: Modern UI with Next.js 15 + React 18
Presentation Layer: 19 pages, 65+ components, 14 services
Application Layer: 10+ API routes for server-side logic
Infrastructure Layer: Google Cloud Platform (Firebase + GCP)
Integration Layer: 11 external APIs

Key Design Patterns

Server-Side Rendering: SEO-optimized pages
API Proxy Pattern: CORS bypass (Reddit, NewsAPI)
Service Layer Pattern: Separation of concerns
Repository Pattern: Firestore data access
Observer Pattern: Real-time updates (Firestore listeners)
Singleton Pattern: Firebase initialization
Factory Pattern: AI service creation

Performance Optimizations

Edge Functions: Low-latency API responses
CDN Distribution: Global content delivery
Image Optimization: Next.js Image component
Code Splitting: Lazy loading components
Caching Strategy: 5-min Redis + localStorage
Background Jobs: Cloud Functions for data refresh

Security Measures

Firebase Auth: Secure user authentication
Firestore Rules: Document-level permissions
API Rate Limiting: Prevent abuse
Environment Variables: No hardcoded secrets
HTTPS Only: Encrypted data transmission
CORS Policies: Controlled API access

🧰 Complete Tech Stack

Frontend Technologies

Core Framework

Next.js 15.5.6 (React 18, App Router, TypeScript)
- Server-Side Rendering (SSR)
- Static Site Generation (SSG)
- Incremental Static Regeneration (ISR)
- API Routes (serverless functions)
- Image Optimization
- Font Optimization (Google Fonts)
- Bundle Analysis & Code Splitting

UI Libraries & Styling

Tailwind CSS 3.4.1 - Utility-first CSS framework
- Custom glassmorphism utilities
- Neon color palette (Cyan #00E5FF, Purple #A57CFF, Emerald #00FFC6)
- Dark mode optimized
- Responsive breakpoints
Framer Motion - Advanced animations & transitions
- Page transitions
- Mesh wave background animation
- Component entrance/exit animations
shadcn/ui - 40+ accessible components
- Built on Radix UI primitives
- Fully customizable with Tailwind
- Accordion, Alert, Badge, Button, Card, Dialog, etc.
Radix UI - Unstyled, accessible components
- Dropdown menus, tooltips, modals
- Keyboard navigation support
- ARIA compliance

State Management & Data Fetching

React Hooks (useState, useEffect, useContext, useMemo)
Custom Hooks (useAuth, useToast, useBackgroundJobs)
Context API - Global state management

Form Handling & Validation

React Hook Form - Performant form validation
Zod - TypeScript-first schema validation
Hookform Resolvers - Form validation integration

Data Visualization

React Flow - Interactive career graph visualization
- Node-based graph editor
- Custom node types
- Edge animations

Backend & Cloud Infrastructure

🔥 Firebase Services (Primary Backend)

Authentication

Firebase Auth 11.9.1
- Google OAuth 2.0 (one-click sign-in)
- Email/Password authentication
- Session management
- Protected routes & API endpoints

Database

Firestore (NoSQL)
- Real-time database
- Offline persistence
- Collections:
  - users - User accounts
  - profiles - User profile data
  - reviews - College reviews
  - colleges - College information (42 colleges)
  - cache - API response caching (5-min TTL)
  - activities - User activity tracking
  - eventReminders - Calendar reminders
  - fcmTokens - Push notification tokens
- Security rules for data protection
- Indexes for query optimization

Storage

Firebase Cloud Storage
- Resume file uploads (.txt, .doc, .docx)
- Profile photo storage
- Background images/videos
- Asset hosting

Hosting & Deployment

Firebase App Hosting
- Next.js 15 support
- Auto-scaling (0-10 instances)
- 2 vCPUs, 2GB RAM per instance
- Global CDN distribution
- Custom domain support
- HTTPS by default

Cloud Functions

Firebase Cloud Functions (Node.js 20)
- Background data refresh (every 24h)
- Scheduled tasks (cron jobs)
- Event-triggered functions
- HTTP callable functions

Analytics & Monitoring

Firebase Analytics
- User engagement tracking
- Event logging
- Conversion funnels
Firebase Performance Monitoring
- Page load times
- API response times
- Network request monitoring

☁️ Google Cloud Platform Services

AI & Machine Learning

Vertex AI
- Model management
- Custom model training (planned)
- AutoML integration (planned)
Gemini AI (Google Generative AI)
- Gemini 1.5 Pro - Complex reasoning, long context
- Gemini 2.5 Flash - Fast AI responses, chat
- Use cases:
  - Career path recommendations
  - Skill gap analysis
  - Resume optimization
  - Interview question generation
  - Content summarization
  - AI chat assistant
  - English language learning
Genkit - AI workflow orchestration
- Flow definitions
- Prompt engineering
- Context management

Compute & Hosting

Cloud Run
- Serverless container deployment
- Auto-scaling
- Pay-per-use pricing
Cloud Functions
- Event-driven serverless functions
- HTTP triggers
- Background processing

Storage & Databases

Cloud Storage
- Object storage for assets
- CDN integration
- Lifecycle management
BigQuery (planned)
- Data warehousing
- SQL analytics
- ML model training data
- User behavior analysis

Monitoring & Operations

Cloud Logging
- Centralized log management
- Log-based metrics
Cloud Monitoring
- Uptime checks
- Alerting policies
- Dashboards
Looker Studio (planned)
- Data visualization
- Custom reports
- Real-time dashboards

Google APIs & Services

Google Maps API
- Maps JavaScript API
- Places API (library search)
- Geocoding API
- Directions API
Google Custom Search API
- Programmable search engine
- Course discovery
- Mentor search
YouTube Data API v3
- Video search
- Channel information
- Educational content recommendations
Google Calendar API
- Event management
- Calendar sync
- Reminder creation

Security & Identity

Cloud Identity Platform
- Multi-factor authentication (planned)
- SAML/OAuth providers
Secret Manager
- API key management
- Environment variable encryption
Cloud IAM
- Role-based access control
- Service account management

External API Integrations

Social & Community

Reddit JSON API
- College reviews & discussions
- Server-side proxy (CORS bypass)
- Sentiment analysis
- Topic extraction
- Mock data fallback

Education & Content

Internet Archive API
- 20M+ free books
- Multiple formats (PDF, EPUB, Text)
- Metadata retrieval
NPTEL API
- 12,000+ Indian courses
- IIT/IISc lectures
- Certificate programs
Coursera API
- Course catalog
- Enrollment data
- Free audit options

News & Information

NewsAPI.org
- Latest news articles
- Indian & global news
- Category filtering
- 100 requests/day (free tier)

Cloud Platforms

AWS Educate
- Cloud computing courses
- Free training materials
Google Cloud Skills Boost
- GCP certifications
- Hands-on labs
- Learning paths

Development Tools & DevOps

Version Control & CI/CD

Git - Source control
GitHub - Repository hosting
- Automatic deployment triggers
- Branch protection
- Pull request reviews
Firebase App Hosting
- Automatic builds from GitHub
- Preview channels for PRs
- Rollback capability

Code Quality

TypeScript 5.0 - Type safety
ESLint - Code linting
- Next.js recommended rules
- React hooks rules
- TypeScript rules

Build Tools

Turbopack (Next.js 15) - Fast bundler
PostCSS - CSS transformations
Babel - JavaScript compilation

Additional Libraries

Utility Libraries

class-variance-authority - Component variants
clsx - Conditional CSS classes
date-fns - Date manipulation
lucide-react - Icon library (1000+ icons)
embla-carousel-react - Carousel component

PDF & Document Handling

react-pdf - PDF rendering
jsPDF - PDF generation
docx - Word document parsing

Performance & Optimization

Caching Strategies

localStorage - Client-side persistence
- Bookmarks (eBooks)
- Search history
- User preferences
Firestore Cache - API response caching
- 5-minute TTL
- Automatic invalidation

Image & Asset Optimization

Next.js Image Optimization
- Automatic WebP conversion
- Lazy loading
- Responsive images
- Blur placeholders
CDN Distribution
- Firebase CDN
- Edge caching
- Global distribution

Code Splitting

Dynamic imports - Lazy load components
Route-based splitting - Per-page bundles
Component-level splitting - On-demand loading

Security & Privacy

Authentication & Authorization

JWT tokens (Firebase Auth)
Session management
Protected API routes
Firestore security rules

Data Protection

HTTPS only (enforced)
Environment variable encryption
No hardcoded secrets (production-ready)
Privacy-first location services
Secure external links (rel="noopener noreferrer")

API Security

Rate limiting (500ms debouncing)
CORS policies
Input validation (Zod schemas)
SQL injection prevention (Firestore)
XSS protection (React auto-escaping)

Infrastructure Summary

Category	Technologies	Count
Frontend	Next.js, React, TypeScript, Tailwind	4
UI Libraries	shadcn/ui, Radix UI, Framer Motion	3
Firebase	Auth, Firestore, Storage, Hosting, Functions	5
Google Cloud	Vertex AI, Gemini, Cloud Run, BigQuery, Cloud Storage	5
Google APIs	Maps, Places, Search, YouTube, Calendar	5
External APIs	Reddit, Internet Archive, NewsAPI, NPTEL, Coursera	5
Development	Git, GitHub, ESLint, TypeScript, Genkit	5
Total Services	32 integrated technologies	32

Total Lines of Code: ~40,000+
API Routes: 10+
Services: 14 production services
Cloud Functions: 5 background functions
Collections: 8 Firestore collections
External Integrations: 11 APIs

☁️ Google Cloud Platform Integration

Complete GCP Services Used

CareerLens leverages the full power of Google Cloud Platform to deliver intelligent, scalable, and reliable career development tools. Here's a comprehensive breakdown:

1. 🔥 Firebase Services Suite

Firebase Authentication

Purpose: User identity & access management
Features:
- Google OAuth 2.0 (one-click sign-in)
- Email/Password authentication
- Session management with JWT tokens
- Protected routes & API endpoints
SDK: firebase@11.9.1
Cost: Free tier (10K verifications/month)

Cloud Firestore

Purpose: NoSQL real-time database

Collections:

firestore/
├── users/{userId}                    # User accounts
├── profiles/{userId}                 # User profiles
├── reviews/{reviewId}                # College reviews
├── colleges/{collegeId}              # 42 colleges database
├── cache/{cacheKey}                  # API response cache (5-min TTL)
├── activities/{activityId}           # User activity tracking
├── eventReminders/{reminderId}       # Calendar reminders
└── fcmTokens/{tokenId}               # Push notification tokens

Features:
- Real-time data synchronization
- Offline persistence
- Security rules for data protection
- Composite indexes for complex queries
Performance: Sub-10ms latency (asia-south1 region)
Cost: Free tier (1GB storage, 50K reads/day)

Firebase Cloud Storage

Purpose: File storage & hosting
Use Cases:
- Resume uploads (.txt, .doc, .docx)
- Profile photos
- Background images/videos
- Static assets
Features:
- CDN integration
- Automatic image optimization
- Secure download URLs
- Storage rules for access control
Cost: Free tier (5GB storage, 1GB/day download)

Firebase App Hosting

Purpose: Next.js 15 deployment platform

Configuration:

runConfig:
  minInstances: 0              # Scale to zero
  maxInstances: 10             # Auto-scale up to 10
  cpu: 2                       # 2 vCPUs per instance
  memoryMiB: 2048              # 2GB RAM per instance
  concurrency: 80              # 80 requests/instance

Features:
- Automatic builds from GitHub
- Preview channels for pull requests
- Rollback to previous versions
- Global CDN (150+ locations)
- Custom domain support
- HTTPS by default (automatic SSL)
Deployment: Connected to github.com/balaraj74/CareerLens (main branch)
URLs:
- Production: careerlens--careerlens-1.us-central1.hosted.app
- Static: careerlens-1.web.app

Firebase Cloud Functions (1st Gen)

Purpose: Serverless backend functions
Runtime: Node.js 20
Functions:
- scheduledDataRefresh - Daily data refresh (cron: every 24h)
- onUserCreate - New user setup
- sendNotification - FCM push notifications
- cacheInvalidator - Cache cleanup
- analyticsCollector - Usage metrics
Triggers:
- HTTPS callable functions
- Scheduled (Cloud Scheduler)
- Firestore document triggers
- Authentication triggers
Cost: Free tier (2M invocations/month)

Firebase Cloud Messaging (FCM)

Purpose: Push notifications
Features:
- Event reminders (calendar)
- Career milestone alerts
- News updates
- Interview prep reminders
Implementation:
- FCM tokens stored in Firestore
- Server-side FCM Admin SDK
- Client-side service worker (planned)
Cost: Free (unlimited notifications)

Firebase Performance Monitoring

Purpose: Real-time performance tracking
Metrics:
- Page load times (First Contentful Paint, LCP)
- API response times
- Network request duration
- Success/failure rates
Target: Lighthouse score 95+ (currently achieved)

Firebase Analytics

Purpose: User engagement tracking
Events Tracked:
- Page views & navigation
- Feature usage (resume builder, AI chat, etc.)
- Conversion funnels
- User retention
Integration: Automatic with Firebase SDK

2. 🤖 Vertex AI & Gemini API

Google Generative AI (Gemini)

Models Used:
- Gemini 1.5 Pro
  - Complex reasoning tasks
  - Long context understanding (1M tokens)
  - Career path recommendations
  - Resume optimization
  - Skill gap analysis
- Gemini 2.5 Flash
  - Fast AI responses (< 1s latency)
  - Conversational AI (chat assistant)
  - Interview question generation
  - Content summarization
  - English language learning
SDK: @genkit-ai/googleai
Features:
- Context caching for reduced latency
- Streaming responses
- Safety settings (BLOCK_MEDIUM_AND_ABOVE)
- Temperature control (0.7-0.9)
Cost: Pay-per-token (cached context reduces cost by 90%)

Vertex AI

Purpose: Advanced AI/ML platform
Current Usage:
- Model management
- API access via Gemini
Planned Features:
- Custom model training (resume scoring)
- AutoML integration
- Prediction APIs

Genkit (AI Workflow Orchestration)

Purpose: AI flow management
Version: genkit@1.21.0
Flows:
- Career recommendation flow
- Resume parsing flow
- Interview preparation flow
- Content summarization flow
Features:
- Type-safe AI workflows
- Prompt versioning
- Context management
- Error handling & retries

3. 🌐 Google Cloud Services

Cloud Run

Purpose: Serverless container platform
Status: Ready for deployment (Dockerfile prepared)
Planned Use:
- Microservices architecture
- Background job workers
- API endpoints with heavy compute
Config:
- Auto-scaling (0-100 instances)
- 1 CPU, 512MB RAM per instance
- Concurrency: 80 requests/container

Cloud Functions (2nd Gen)

Purpose: Event-driven serverless functions
Runtime: Node.js 20
Planned Functions:
- Image processing (resume uploads)
- PDF generation (resume export)
- Webhook handlers (external integrations)
- Data migration scripts

Cloud Storage (GCS)

Purpose: Object storage for large assets
Buckets:
- careerlens-assets - Static images/videos
- careerlens-backups - Firestore backups (daily)
- careerlens-exports - User data exports
Features:
- Lifecycle policies (auto-delete old backups)
- CDN integration (Cloud CDN)
- Signed URLs for secure access
Cost: $0.02/GB/month (standard storage)

BigQuery (Planned)

Purpose: Data warehousing & analytics
Planned Tables:
- user_events - Clickstream data
- career_paths - Historical career data
- skill_trends - Industry skill demand
- resume_analytics - ATS scoring data
Features:
- SQL analytics
- ML model training data
- Real-time dashboards
- Export to Looker Studio
Cost: $5/TB query (free 1TB/month)

Cloud Logging

Purpose: Centralized log management
Logs Collected:
- Application logs (Next.js)
- Cloud Functions logs
- API request/response logs
- Error stack traces
Retention: 30 days (default)
Features:
- Log-based metrics
- Alerting policies
- Export to BigQuery

Cloud Monitoring

Purpose: Infrastructure monitoring
Dashboards:
- Firebase App Hosting metrics
- API response times
- Firestore read/write operations
- Error rates & anomalies
Alerts:
- High error rate (>5%)
- Slow API responses (>2s)
- Firestore quota limits
Uptime Checks: 1-minute intervals

Looker Studio (Planned)

Purpose: Data visualization & reporting
Dashboards:
- User engagement metrics
- Feature adoption rates
- AI model performance
- Career path trends
Data Sources:
- BigQuery tables
- Firebase Analytics
- Custom SQL queries

Cloud Scheduler

Purpose: Cron job management
Jobs:
- Daily data refresh (00:00 UTC)
- Weekly analytics report (Sunday 12:00)
- Cache cleanup (every 6h)
- Backup Firestore (daily)
Cost: Free (3 jobs/month)

4. 🗺️ Google APIs

Google Maps JavaScript API

Purpose: Library Finder feature
Features:
- Interactive map display
- Location markers
- Info windows with details
- Distance calculation (Haversine)
API Key: AIzaSyCCovOlhJubYYE5iZ5I2AGk_roWOUVa5LU (production)
Cost: $7/1000 requests (free $200/month credit)

Google Places API

Purpose: Library search & details
Features:
- Nearby library search
- Ratings & reviews
- Photos & amenities
- Opening hours
Cost: $17/1000 requests (shared $200 credit)

Google Geocoding API

Purpose: Address to coordinates conversion
Use Case: User location → nearest libraries
Cost: $5/1000 requests

Google Directions API

Purpose: Navigation & route planning
Features:
- Turn-by-turn directions
- Multiple transport modes
- Traffic-aware routing
Cost: $5/1000 requests

Google Custom Search API

Purpose: Course & mentor discovery
Search Engine ID: Custom CSE for educational content
Features:
- NPTEL course search
- Coursera course discovery
- Mentor LinkedIn profile search
Quota: 100 queries/day (free), upgradable to 10K/day
Cost: $5/1000 queries (after free tier)

YouTube Data API v3

Purpose: Educational video recommendations
Features:
- Video search by topic
- Channel information
- Playlist management
- View count & ratings
Quota: 10,000 units/day (free)
Cost: Free tier sufficient

Google Calendar API

Purpose: Event management & sync
Features:
- Create/edit/delete events
- Calendar synchronization
- Recurring event support
- Reminder configuration
Scopes:
- calendar.events - Event management
- calendar.readonly - Read-only access
Cost: Free (unlimited API calls)

5. 🔐 Security & Identity

Cloud Identity Platform

Purpose: Advanced authentication
Planned Features:
- Multi-factor authentication (MFA)
- SAML/OAuth providers
- Enterprise SSO
Cost: $0.015/MAU (after 50K users)

Secret Manager

Purpose: Secure secret storage
Secrets Stored:
- GEMINI_API_KEY - Gemini AI key
- GOOGLE_GENAI_API_KEY - Google AI key
- NEWS_API_KEY - NewsAPI.org key (hardcoded in production)
- REDIS_URL - Redis connection string (planned)
- REDDIT_CLIENT_SECRET - Reddit OAuth
Cost: $0.06/10K accesses

Cloud IAM

Purpose: Access control & permissions
Service Accounts:
- firebase-admin - Firestore/Storage access
- cloud-functions - Function execution
- genkit-ai - Vertex AI access
Roles:
- Editor (developers)
- Viewer (monitoring team)
- Owner (project admin)

GCP Cost Breakdown (Monthly Estimate)

Service	Usage	Cost
Firebase App Hosting	~100K requests, 10 instances	$25-50
Firestore	1M reads, 500K writes, 5GB storage	$10-20
Cloud Storage	10GB storage, 100GB egress	$5-10
Gemini API	10M tokens (cached 90%)	$15-30
Google Maps APIs	10K requests	$0 (free credit)
Cloud Functions	1M invocations	$0 (free tier)
Cloud Messaging	1M notifications	$0 (free)
Firebase Auth	10K MAU	$0 (free tier)
Monitoring & Logging	50GB logs	$5
BigQuery (planned)	1TB queries	$0 (free 1TB)
Total Estimated Cost		$60-115/month

Note: Actual costs vary with usage. Free tiers cover most development/testing needs.

GCP Project Configuration

Project ID: careerlens-1
Region: us-central1 (primary)
Fallback Region: asia-south1 (low latency for India)
Billing Account: Active (Google Cloud Free Trial)
APIs Enabled: 15+ Google Cloud APIs
Service Accounts: 3 (firebase-admin, cloud-functions, genkit-ai)
Firestore Mode: Native (real-time database)
Storage Location: us-central1 (multi-region)

Deployment Architecture

GitHub Repository (main branch)
         ↓ (commit push)
Firebase App Hosting Builder
         ↓ (build Next.js 15)
Cloud Run Instance (Docker container)
         ↓ (deploy with rollout)
Global CDN (150+ locations)
         ↓ (serve users)
Production URL: careerlens--careerlens-1.us-central1.hosted.app

Future GCP Integrations

Cloud Pub/Sub: Real-time event streaming
Cloud Tasks: Async job queue
Cloud Spanner: Globally distributed database (if scale requires)
Cloud CDN: Enhanced content delivery
Cloud Armor: DDoS protection & WAF
Cloud SQL: PostgreSQL for relational data (user analytics)
Memorystore (Redis): Distributed caching
Cloud Run Jobs: Batch processing
Workflows: Multi-step automation

🚀 Key Features

🎯 Core Features

1. AI-Powered Career Recommendations

Personalized career path suggestions based on skills, goals, and interests
Gemini AI analyzes your profile to recommend roles, companies, and growth paths
Real-time job market insights and salary trends

2. Skill Gap Analysis

Identify missing skills for your target role
Get prioritized learning recommendations
Track your skill development progress

3. Personalized Learning Roadmap

AI-generated step-by-step learning paths
Curated courses from NPTEL, Coursera, AWS, GCP, edX
Time estimates and difficulty levels for each step

4. AI Interview Preparation

Role-specific interview questions generated by Gemini AI
Mock interview practice with feedback
Technical and behavioral question banks
Real-time answer evaluation

5. Interactive Resume Builder

ATS-friendly resume templates
AI-powered content suggestions
JSON-based resume generation
One-click download in multiple formats

📚 Resource Hub

6. Free Course Discovery

AI Recommendations: Personalized course suggestions based on your profile
Live Web Scraping: Real-time course data from 5+ platforms
- NPTEL (12,000+ courses)
- Coursera (Free audit options)
- AWS Educate (Cloud computing)
- Google Cloud Skills Boost (GCP certifications)
- YouTube (Educational content)
Smart filtering by provider, level, and topic
Certificate availability indicators

7. College Recommendations System 🆕

42 Colleges Database: Comprehensive college information across India
- JEE: 12 premier engineering colleges
- KCET: 10 top Karnataka colleges
- COMEDK: 8 private engineering colleges
- NEET: 6 top medical colleges
- CET: 4 management colleges (CAT/CMAT)
- GATE: 2 research institutes (IISc, IITs)
Smart Filtering: Filter by exam type, rank, fees, location
Score Calculation: AI-powered college ranking based on multiple factors
Reddit Reviews Integration: Live student reviews for each college
Sentiment Analysis: Positive/Negative/Neutral review classification
Acceptance Probability: Calculate your chances based on exam scores

8. Community & Reddit Reviews 🆕

Reddit API Integration: Server-side proxy for reliable data fetching
Live Student Reviews: 5+ authentic reviews per college
Sentiment Analysis: AI-powered emotion detection
Topic Extraction: Automatic categorization (Placements, Faculty, Campus, etc.)
Mock Data System: Consistent UX with realistic fallback data
Rate Limiting: Smart caching (5-minute) and debouncing (1.5s)
Search Colleges: Find colleges by name or exam type

9. eBooks Library (Internet Archive) 🆕

20M+ Books: Search the world's largest digital library
Advanced Filters:
- 15 genres (Computer Science, Engineering, Business, etc.)
- 10 languages (English, Hindi, Spanish, etc.)
- 6 formats (PDF, EPUB, Text, DJVU, DAISY, Audio)
- Year range filtering
Bookmark System: Save favorite books with localStorage
Search History: Track last 20 searches
Three Tabs: Search Results, Bookmarks, Trending
AI Recommendations: Personalized book suggestions based on search history
Direct Download: One-click access to free educational content
Trending Books: Popular educational and technical books

10. Mentor Discovery

Find industry mentors and educators
Filter by role, company, expertise
Google Search integration for LinkedIn profiles
AI-powered mentor-mentee matching (Coming soon)

🤖 AI-Powered Services

11. AI Summarization

Auto-summarize lengthy reviews and articles
Sentiment analysis (positive/neutral/negative)
Key points extraction
Credibility scoring

12. Smart Search

Google Custom Search integration
Context-aware search results
Multi-platform course discovery
Review aggregation from multiple sources

13. Learning Helper

AI-powered doubt clearing
Explain complex concepts in simple terms
Step-by-step problem solving
Resource recommendations based on queries

📅 Productivity Tools

14. AI Calendar & Task Management

Google Calendar integration
AI-suggested events based on career goals
Smart scheduling with conflict detection
Event reminders and notifications
Track learning streaks and productivity

15. Progress Tracking

Visual career graph showing your journey
Skill progression over time
Achievement badges and milestones
Goal completion tracking

🔍 Discovery Features

16. Real-Time Data Aggregation

Reddit API Service: Fetch live college reviews with server-side proxy
Internet Archive Service: Search 20M+ books from world's largest library
College Recommendation Service: 42 colleges with AI-powered matching
Web Scraper Service: Scrape 5 platforms for fresh courses
Google Search Service: Discover mentors and resources
Bookmark Service: LocalStorage management for saved content
Automated background refresh via Cloud Functions

17. Library Finder 🆕

User Location Tracking: Green circle marker shows your current position
Distance Calculator: Haversine formula calculates accurate distances
Smart Sorting: Libraries auto-sorted by proximity (nearest first)
Distance Display: Shows "350 meters" or "2.3 km away" for each library
Interactive Map: Google Maps with dark theme and custom markers
Recenter Button: Quick return to your location
Auto-Center: Map automatically focuses on your location
Get Directions: One-click Google Maps navigation
Privacy-First: No coordinate display in UI, only internal use
Error Handling: Clear guidance for location permission issues
Responsive Design: Works on mobile, tablet, and desktop

🎨 UI/UX Features

18. Modern Interface

Dark mode optimized (purple/pink gradient theme)
Smooth animations (Framer Motion)
Responsive design (mobile-first)
Glassmorphic cards and gradients
Loading states and skeletons
Toast notifications for user feedback

19. Profile Management

Comprehensive user profiles
Skills and interests tracking
Experience and education history
Career goals and objectives
Photo upload and customization

🔐 Authentication & Security

Firebase Authentication

Google OAuth 2.0 (One-click sign-in)
Email/Password authentication
Protected routes and API endpoints
Secure token-based sessions

Firestore Security Rules

User data isolation (read/write own documents only)
Public read access for reviews and resources
Role-based access control
Rate limiting on write operations

🧩 Unique Selling Points (USP)

⭐ Fully Google Cloud Integrated

Leverages Gemini 2.5 Flash for lightning-fast AI responses
Built on Firebase (Google's BaaS platform)
Uses Google Cloud Functions for serverless automation
Integrated with Google Calendar, Google Maps, YouTube API
Ready for BigQuery analytics and Looker Studio dashboards
Deployed on Firebase App Hosting with auto-scaling

⚡ Real-Time AI Insights

Live data aggregation from Reddit, Google Search, and 5+ course platforms
AI-powered summarization of reviews and articles in seconds
Instant course recommendations based on your profile
Real-time scraping of NPTEL, Coursera, AWS, GCP, YouTube
Background Cloud Functions refresh data every 24 hours automatically
No stale data - always get the latest industry insights

🎯 Personalization at Scale

Every recommendation is uniquely tailored to your profile
Context-aware AI understands your career goals and adapts
Multi-dimensional matching: skills, interests, experience, location
Continuous learning from your interactions and feedback

🧠 Future Enhancements

🚧 Planned Features

1. AI Chat Mentor 💬

Real-time conversational AI mentor powered by Gemini
Context-aware career guidance
Natural language interaction
Personalized advice based on your profile and goals
Integration with Google Workspace for calendar scheduling

2. AI Interview Simulator 🎙️

Live mock interviews with AI interviewer
Speech-to-text for answer recording
Real-time feedback on communication skills
Role-play different interview scenarios (technical, behavioral, HR)
Video analysis for body language tips

3. AI-Driven Course Planner 📚

Automatically generate learning schedules
Sync with Google Calendar
Adaptive difficulty based on progress
Spaced repetition for skill retention
Integration with learning platforms (NPTEL, Coursera)

4. BigQuery Analytics Dashboard 📊

Track platform-wide trends
Analyze user behavior patterns
Course popularity metrics
Career path success rates
Mentor effectiveness scoring

5. Looker Studio Dashboards 📈

Visual analytics for admins
Real-time user engagement metrics
Course completion rates
Skill gap trending analysis
Geographic distribution of users

6. Mobile App 📱

React Native iOS/Android apps
Offline mode for resumes and roadmaps
Push notifications for interview prep
Quick access to learning resources

7. Blockchain Certifications 🔗

Issue verifiable certificates on blockchain
NFT badges for achievements
Tamper-proof credential verification

🧭 Setup Instructions

Prerequisites

Node.js 18+ and npm/yarn
Firebase account
Google Cloud account
Git

1. Clone the Repository

git clone https://github.com/balaraj74/CareerLens.git
cd CareerLens

2. Install Dependencies

npm install
# or
yarn install

3. Configure Environment Variables

Create a .env.local file in the root directory:

# Firebase Configuration
NEXT_PUBLIC_FIREBASE_API_KEY=your_firebase_api_key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_project.firebasestorage.app
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
NEXT_PUBLIC_FIREBASE_APP_ID=your_app_id
NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID=G-XXXXXXXXXX

# Google AI (Gemini) API Key
GOOGLE_GENAI_API_KEY=your_gemini_api_key
GEMINI_API_KEY=your_gemini_api_key

# Google Maps API Key (for library finder)
NEXT_PUBLIC_GOOGLE_MAPS_API_KEY=your_maps_api_key

# Google OAuth Client ID
NEXT_PUBLIC_GOOGLE_CLIENT_ID=your_client_id.apps.googleusercontent.com

# Google Custom Search API
NEXT_PUBLIC_GOOGLE_SEARCH_API_KEY=your_search_api_key
NEXT_PUBLIC_GOOGLE_SEARCH_ENGINE_ID=your_search_engine_id

# YouTube API (optional)
NEXT_PUBLIC_YOUTUBE_API_KEY=your_youtube_api_key

# Environment
NODE_ENV=development

4. Get API Keys

Firebase Setup

Go to Firebase Console
Create a new project or use existing
Enable Firestore Database, Authentication, Storage
Get your Firebase config from Project Settings
Enable Google OAuth in Authentication > Sign-in method

Gemini AI API Key

Visit Google AI Studio
Create a new API key
Copy and paste into .env.local

Google Custom Search API

Go to Google Cloud Console
Enable Custom Search API
Create credentials > API Key
Create a Custom Search Engine at cse.google.com
Copy Search Engine ID

Google Maps API (Optional)

Enable Maps JavaScript API in Google Cloud
Create an API key
Restrict to Maps JavaScript API

5. Deploy Firestore Security Rules ⚠️ IMPORTANT

The updated firestore.rules file includes permissions for new collections. Deploy these rules to Firebase:

# Option 1: Deploy via Firebase CLI
firebase deploy --only firestore:rules

# Option 2: Deploy via Firebase Console (Recommended)
# 1. Go to Firebase Console → Firestore → Rules
# 2. Copy the content from firestore.rules file
# 3. Click "Publish" and wait 1-2 minutes

New Collections Added:

activities - User activity tracking
eventReminders - Calendar reminders
fcmTokens - Push notification tokens
cache - System caching
colleges - College information (public read)

6. Run Development Server

npm run dev
# or
yarn dev

Open http://localhost:3000 in your browser.

7. Build for Production

npm run build
npm run start

8. Deploy to Firebase App Hosting

# Login to Firebase
firebase login

# Deploy
firebase apphosting:rollouts:create <backend-name>

🛠️ Troubleshooting

Common Issues

0. Geolocation Errors in Library Finder

Location permission denied

Solution:

Enable location access in browser settings
Chrome: Settings → Privacy and security → Site settings → Location
Allow location for localhost:3000
Check console for detailed error messages
Error messages now provide specific guidance

1. Firebase Permission Errors

Error: Missing or insufficient permissions

Solution: Deploy updated Firestore rules

firebase deploy --only firestore:rules

2. "No document to update" Error

Error: No document to update

Solution: Already fixed! We changed all updateDoc to setDoc with { merge: true } in:

src/lib/enhanced-profile-service.ts

3. Reddit API CORS Errors

Failed to fetch

Solution: Already implemented! We use server-side API proxy at /api/reddit-search

4. Server Not Running

net::ERR_CONNECTION_REFUSED

Solution: Start the dev server

npm run dev

5. Environment Variables Not Loaded

Solution:

Ensure .env.local exists in project root
Restart the dev server after changes
Check all required variables are set

6. Build Errors

# Clear cache and rebuild
rm -rf .next
npm run build

Verification Steps

Check if .env files are ignored:

git check-ignore -v .env .env.local
# Should output: .gitignore:43:.env* .env

Verify Firebase connection:

# Check if Firebase is initialized
npm run dev
# Look for: "Firebase Config: { apiKey: '***', ... }"

Test API routes:

# College recommendations
curl http://localhost:3000/api/college-recommendations?exam=JEE

# Reddit search (with mock data)
curl http://localhost:3000/api/reddit-search?college=IIT+Bombay

🌐 Demo & Deployment

Live Demo

🔗 Production URL: https://careerlens--careerlens-1.us-central1.hosted.app

Deployment Platform

Hosting: Firebase App Hosting (powered by Cloud Run)
Database: Firestore (NoSQL)
Storage: Firebase Cloud Storage
Functions: Firebase Cloud Functions + Google Cloud Functions
CI/CD: Automatic deployment from GitHub main branch

Performance Metrics

⚡ First Load JS: ~300 KB (optimized)
🚀 Lighthouse Score: 90+ (Performance)
📱 Fully Responsive (mobile, tablet, desktop)
🌍 Global CDN Distribution

📊 Project Stats

Total Lines of Code: ~38,000+ lines (updated with new features)
Services Built: 14 production services
- Reddit API Service (358 lines) - Server-side proxy with mock data
- Internet Archive Service (180 lines) - Book search API
- Bookmark Service (100 lines) - LocalStorage management
- College Recommendation Service (1427 lines) - 42 colleges database
- Google Search Service (516 lines)
- Web Scraper Service (612 lines)
- AI Summarizer Service (501 lines)
- Community Service (410 lines)
- Resource Hub Service (382 lines)
- Mentor Chat Service (475 lines)
- Google Calendar Service (485 lines)
- AI Calendar Suggestions (398 lines)
- Enhanced Profile Service (566 lines) - Fixed Firebase permissions
- News Service (348 lines) - News aggregation with search
- Library Finder Service (736 lines) - Location-based library search
API Routes: 4 custom endpoints
- /api/reddit-search (340 lines) - Reddit proxy with real-time data
- /api/college-recommendations (1427 lines) - College search
- /api/news (95 lines) - NewsAPI proxy
- /api/parse-resume - Resume parsing
Cloud Functions: 5 automated functions (1,132 lines)
UI Components: 65+ reusable components
Pages: 19+ main pages (including /colleges, /ebooks, /news, /library-finder)
Integration Points: 11 external APIs (Reddit, Internet Archive, Google Search, NewsAPI, Google Maps, Google Places, etc.)
Security Enhancements: Privacy-first design, no exposed credentials, secure external links

👥 Credits & Team

Developer

Balaraj R
📧 Email: balarajr483@gmail.com
🐙 GitHub: @balaraj74

Built For

🏆 Google GenAI Hackathon 2025

Powered By

🤖 Google Gemini AI (Generative AI)
🔥 Firebase (Backend as a Service)
☁️ Google Cloud Platform (Infrastructure)
⚛️ Next.js (React Framework)

Special Thanks

Google Cloud Team for Gemini API access
Firebase team for excellent documentation
Next.js team for the amazing framework
shadcn/ui for beautiful components

📄 License

This project is built for educational purposes as part of the Google GenAI Hackathon 2025.

👨‍💻 For Developers

Understanding the Codebase

New Features Architecture

1. College Recommendations System

// Flow: User Search → API Route → Service → Response
src/app/colleges/page.tsx (206 lines)
  → src/app/api/college-recommendations/route.ts (1427 lines)
    → Returns 42 colleges with Reddit reviews
    → Filters by exam type, rank, fees

Key Files:

src/app/colleges/page.tsx - Main college search page
src/app/api/college-recommendations/route.ts - API endpoint
src/components/community/college-card.tsx - Display component

2. Reddit Integration

// Flow: User Request → Proxy → Reddit API → Mock Data Fallback
src/app/api/reddit-search/route.ts (220 lines)
  → Server-side proxy to bypass CORS
  → generateMockRedditReviews() - Creates 5 reviews
  → Sentiment analysis + topic extraction
  → 5-minute caching, 500ms rate limiting

Key Files:

src/app/api/reddit-search/route.ts - Server proxy
src/lib/services/reddit-service.ts (358 lines) - Reddit client
Mock data enabled by default: MOCK_ENABLED = true

3. eBooks Library

// Flow: User Search → Internet Archive API → Display Results
src/app/ebooks/page.tsx (490 lines)
  → src/lib/services/internet-archive-service.ts (180 lines)
    → Search 20M+ books
    → Filter by genre, language, format
  → src/lib/services/bookmark-service.ts (100 lines)
    → LocalStorage bookmarks

Key Features:

Search with pagination
Advanced filters (15 genres, 10 languages, 6 formats)
Bookmark system (localStorage)
Search history (last 20)
AI recommendations

4. Firebase Fixes

// Changed from updateDoc (requires existing doc) to setDoc (creates if not exists)

// Before:
await updateDoc(doc(db, 'users', userId, 'profile'), data)
// Error: "No document to update"

// After:
await setDoc(doc(db, 'users', userId, 'profile'), data, { merge: true })
// Success: Creates document if not exists, merges if exists

Updated Functions (6 total):

awardXP() - Line 132-149
completeDailyGoal() - Line 187-189
unlockAchievement() - Line 214-216
updateProjectStatus() - Line 254-256
updateStreak() - Line 301-305
updateAnalytics() - Line 355-357

File: src/lib/enhanced-profile-service.ts (566 lines)

Code Quality Standards

✅ TypeScript Strict Mode - All files type-safe
✅ ESLint - Code linting enabled
✅ Prettier - Code formatting (optional)
✅ No Console Errors - Clean browser console
✅ Server-Side Rendering - Next.js App Router
✅ API Routes - Type-safe server actions

Testing Checklist

Before pushing code, verify:

Build passes: npm run build
No TypeScript errors: Check VS Code problems panel
Server runs: npm run dev - no errors
Firebase rules deployed: Check Firebase Console
Environment variables: .env.local configured
Git ignore: .env files not tracked

Adding New Features

Step 1: Create Service

// src/lib/services/my-service.ts
export async function myFunction() {
  // Business logic here
}

Step 2: Create API Route (if needed)

// src/app/api/my-endpoint/route.ts
export async function GET(request: Request) {
  // Server-side logic
  return Response.json({ data: 'result' })
}

Step 3: Create Page

// src/app/my-feature/page.tsx
export default function MyFeaturePage() {
  // React component
}

Step 4: Update Navigation

// src/components/nav.tsx
// Add link to navigation

Step 5: Update Firebase Rules (if needed)

// firestore.rules
match /myCollection/{docId} {
  allow read, write: if request.auth != null;
}

🤝 Contributing

While this is primarily a hackathon project, contributions, issues, and feature requests are welcome!

Fork the repository
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

📞 Contact & Support

For questions, feedback, or collaboration:

📧 Email: balarajr483@gmail.com
🐙 GitHub: @balaraj74
💼 LinkedIn: Connect with me

⭐ Star this repo if you find it helpful!

Made with ❤️ by Balaraj R for Google GenAI Hackathon 2025

🎯 Mission

To democratize career development by providing every professional with access to AI-powered career coaching, personalized learning paths, and intelligent job search tools.

🚀 Core Features

1. 👤 Intelligent Profile Management

Multi-tab profile editor (6 comprehensive sections)
Gamified dashboard with 3D visuals
Achievement tracking and milestones
Real-time Firebase sync

2. 🎓 AI Career Hub

AI Skills Recommender (620 lines): Personalized skill development paths
AI Project Generator (580 lines): Context-aware project recommendations
Certification Hub (450 lines): 25+ curated certifications

3. 🧠 AI Learning Helper

PDF document analysis with 4 modes
Quick Points, Deep Dive, Mind Map, Exam Mode
Powered by Gemini 2.5 Flash Lite

4. 📊 Career Graph & Analytics

GitHub-style 365-day activity heatmap
Skill network graph visualization
AI-powered readiness score
Personalized recommendations

5. 📄 ATS-Optimized Resume Builder

Smart resume generation from profile
ATS score analysis
Job-specific tailoring
Resume parser for existing resumes

6. 🎤 AI Interview Preparation

Mock interview with conversational AI
Role-specific questions with model answers
Voice recognition support

7. 📅 AI Career Calendar 🆕

Google Calendar Integration: Sync events, create/edit tasks
AI Event Suggestions: Gemini-powered personalized recommendations
Smart Reminders: Firebase Cloud Messaging notifications
Today's Tasks Widget: Interactive task completion tracking
Productivity Analytics: Streak tracking, scores, insights
Modern UI: Glassmorphic design with smooth animations

🛠️ Technology Stack

Frontend

Next.js 15.3.3 - React framework
React 18.3.1 - UI library
TypeScript 5.0 - Type safety
Tailwind CSS - Styling
Framer Motion - Animations

AI & Machine Learning

Google Gemini 2.5 Flash Lite - Primary AI model
Genkit 1.21.0 - AI orchestration

Backend & Services

Firebase 11.9.1
- Authentication
- Firestore Database
- Hosting & App Hosting

☁️ Google Cloud Services Used

1. 🤖 Vertex AI & Gemini API

Gemini 2.5 Flash Lite for all AI features
Career recommendations
Resume optimization
Interview preparation
Document analysis

2. 🔥 Firebase Suite

Authentication

Email/Password & Google OAuth 2.0
Session management

Cloud Firestore

firestore/
├── users/{userId}/profile
├── resumes/{resumeId}
└── interviews/{interviewId}

Firebase Hosting

Static: careerlens-1.web.app
App Hosting: careerlens--careerlens-1.us-central1.hosted.app

Configuration

runConfig:
  minInstances: 0
  maxInstances: 3
  cpu: 1
  memoryMiB: 1024

🏗️ Architecture

Client Layer (Next.js 15)
      ↓
Server Actions (Type-safe API)
      ↓
Genkit AI Flows
      ↓
Google Gemini API
      ↓
Firebase Firestore

🤖 AI Features Deep Dive

AI Skills Recommender

Algorithm:

Analyze user profile
Query Gemini with context
Generate 6 personalized recommendations
Calculate relevance scores
Fallback to curated data

AI Project Generator

Strategy:

Match complexity to skill level
Use existing skills + 1-2 new ones
Provide implementation guides
7 curated templates as fallback

Resume Intelligence

Components:

Parser (PDF/DOCX)
Generator (Template-based)
ATS Analyzer (Scoring algorithm)

Conversational AI Interviewer

Context-aware questions
Real-time feedback
Voice recognition
Performance scoring

📁 Project Structure

CareerLens/
├── src/
│   ├── ai/flows/                      # Genkit AI Flows
│   ├── app/
│   │   ├── api/                       # API Routes
│   │   │   ├── reddit-search/         # Reddit API proxy
│   │   │   ├── college-recommendations/  # College search endpoint
│   │   │   └── parse-resume/          # Resume parsing
│   │   ├── colleges/                  # College recommendations page
│   │   ├── ebooks/                    # eBooks library page
│   │   ├── calendar/                  # AI calendar
│   │   ├── career-graph/              # Career analytics
│   │   ├── ai-interviewer/            # Mock interviews
│   │   ├── resume/                    # Resume builder
│   │   ├── roadmap/                   # Learning paths
│   │   └── ...                        # Other feature pages
│   ├── components/
│   │   ├── community/                 # College cards, reviews
│   │   ├── ui/                        # Reusable UI components
│   │   └── ...                        # Feature components
│   ├── hooks/                         # Custom React hooks
│   └── lib/
│       ├── services/                  # Business logic
│       │   ├── reddit-service.ts      # Reddit API client (358 lines)
│       │   ├── internet-archive-service.ts  # Book search (180 lines)
│       │   ├── bookmark-service.ts    # Bookmark management (100 lines)
│       │   ├── college-recommendation-service.ts  # 42 colleges
│       │   └── enhanced-profile-service.ts  # Profile management (566 lines)
│       ├── firebase.ts                # Firebase initialization
│       └── utils.ts                   # Helper functions
├── docs/                              # Documentation
│   ├── QUICK_START.md                 # Getting started guide
│   ├── TESTING-GUIDE.md               # Testing instructions
│   └── ...                            # Feature documentation
├── functions/                         # Cloud Functions
│   └── src/                           # TypeScript functions
├── apphosting.yaml                    # Firebase App Hosting config
├── firebase.json                      # Firebase project config
├── firestore.rules                    # Updated security rules
├── next.config.ts                     # Next.js config
├── tsconfig.json                      # TypeScript config
└── package.json                       # Dependencies

🚀 Getting Started

Prerequisites

Node.js 18+
Firebase account
Google Cloud with Gemini API

Installation

Clone repository

git clone https://github.com/balaraj74/CareerLens.git
cd CareerLens

Install dependencies

npm install

Setup environment

cp .env.local.example .env.local

Configure Firebase

NEXT_PUBLIC_FIREBASE_API_KEY=your_key
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project
GOOGLE_GENAI_API_KEY=your_gemini_key

Run development server

npm run dev

Open browser

http://localhost:3000

📦 Deployment

Firebase App Hosting

npm run build
firebase apphosting:rollouts:create careerlens -b main -f

📊 Performance

Lighthouse Score: 95+
First Contentful Paint: < 1.5s
Bundle Size: < 300KB

👥 Team

Developer: Balaraj R
GitHub: @balaraj74
Email: balarajr483@gmail.com

🙏 Acknowledgments

Next.js - React Framework
Firebase - Backend Infrastructure
Google Gemini - AI/ML Models
Genkit - AI Orchestration
Shadcn/UI - Components
Tailwind CSS - Styling

Built with ❤️ using Google Cloud Technologies

Name		Name	Last commit message	Last commit date
Latest commit History 323 Commits
..bfg-report/2025-11-01/18-48-20		..bfg-report/2025-11-01/18-48-20
.amazonq/rules/memory-bank		.amazonq/rules/memory-bank
.github/workflows		.github/workflows
.idx		.idx
.vscode		.vscode
docs		docs
functions-deploy		functions-deploy
functions		functions
public		public
scripts		scripts
skills		skills
src		src
tests		tests
.eslintrc.json		.eslintrc.json
.firebaserc		.firebaserc
.gitignore		.gitignore
.modified		.modified
.npmrc		.npmrc
BACKGROUND_VIDEO_QUICKREF.txt		BACKGROUND_VIDEO_QUICKREF.txt
Dockerfile.socket		Dockerfile.socket
Dockerfile.worker		Dockerfile.worker
NEWS_API_QUICKREF.txt		NEWS_API_QUICKREF.txt
README.md		README.md
Video_Generation_From_Image.mp4		Video_Generation_From_Image.mp4
add-background-video.sh		add-background-video.sh
apphosting.yaml		apphosting.yaml
cloud-function-enhanced.js		cloud-function-enhanced.js
cloud-function-inline.js		cloud-function-inline.js
cloud-function-package.json		cloud-function-package.json
components.json		components.json
deploy.sh		deploy.sh
deployment-checklist.html		deployment-checklist.html
docker-compose.yml		docker-compose.yml
firebase.json		firebase.json
firestore.indexes.json		firestore.indexes.json
firestore.rules		firestore.rules
functions-deploy.zip		functions-deploy.zip
jsconfig.json		jsconfig.json
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
setup-google-search.html		setup-google-search.html
setup-secrets.sh		setup-secrets.sh
tailwind.config.ts		tailwind.config.ts
test-apis.sh		test-apis.sh
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

🚀 CareerLens: AI-Powered Career Development Platform

📋 Table of Contents

🔥 Recent Updates (November 2025)

Latest Updates (Security & Feature Enhancements)

Security Improvements 🔒

Library Finder Enhancements 📚

News Feature Enhancements 📰

Community/College Finder Improvements 🎓

Resume Evaluator Updates 📄

Calendar Feature 📅

Configuration & Documentation 📚

New Features Added

1. College Recommendations System

2. Reddit Reviews Integration

3. eBooks Library (Internet Archive)

4. Firebase Fixes

5. Navigation Enhancements

�🌟 Overview

🎓 CareerLens - AI-Powered Career Guidance Platform

✨ Complete Feature List

🎯 Career Management

1. Career Navigator

2. Career Graph Visualization

3. Career Updates Feed

📊 AI-Powered Tools

4. AI Career Insights (Gemini 1.5 Pro)

5. AI Skills Recommender (620 lines)

6. AI Resume Optimizer

7. AI Interview Preparation

8. AI Project Generator (580 lines)

9. AI Chat Assistant (Copilot)

🎓 Education & Learning

10. College Recommendations (42 Colleges)

11. eBooks Library (20M+ Books)

12. Course Discovery

13. Certification Hub (450 lines)

14. Learning Roadmaps

📚 Resource Discovery

15. Library Finder

16. News Feed (NewsAPI)

17. Mentor Discovery

🗓️ Productivity Tools

18. AI Calendar (Google Calendar API)

19. English Language Helper

👤 Profile & Gamification

20. Intelligent Profile Management

21. Skill Gap Analyzer

🌐 Community Features

22. College Reviews (Reddit Integration)

23. Social Sharing

🎨 UI/UX Features

24. Premium Glassmorphism Design

25. Interactive Components

⚙️ Technical Features

26. Performance Optimization

27. Caching Strategies

28. Security & Privacy

29. Real-Time Features

30. Background Jobs

📱 Mobile Features

31. Progressive Web App (PWA) - Planned

📊 Analytics & Monitoring

32. Performance Monitoring

33. User Analytics

🏗 Complete Architecture

System Architecture Diagram

Architecture Highlights

Multi-Layer Design

Key Design Patterns

Performance Optimizations

Security Measures

🧰 Complete Tech Stack

Frontend Technologies

Core Framework

UI Libraries & Styling

State Management & Data Fetching