🧭 Compass: The AI-Native Career Operating System

Navigate your future with Compass. 🧭

---

🚀 What is Compass?

Compass is a sophisticated 4-year career tracking and skill development platform designed specifically for Computer Science students specializing in:

• Artificial Intelligence & Machine Learning (AI/ML)
• Data Science
• AI Security

Unlike ordinary to-do or habit trackers, Compass functions as a Career Operating System.

It bridges the gap between:

• Academic requirements (JNTUH R25 syllabus)
• Industry expectations (Roadmap.sh-aligned roles)

Compass uses Generative AI to:

• Validate real understanding (not fake progress)
• Generate truthful, role-specific resumes
• Simulate technical, behavioral, and system design interviews

---

🌟 Key Capabilities

🧠 1. The Neural Roadmap Tracker

A dynamic, adaptive 4-year roadmap engine aligned to real careers.

Role Alignment

Filter the roadmap instantly for:

• AI Engineer
• Data Scientist
• Data Analyst
• AI Security Officer
• Full Stack Developer

The Socratic Validator

You cannot simply check off critical skills.

When marking a High-Priority task as complete:

• Gemini AI intercepts
• Acts as a strict professor
• Asks a conceptual question
• Progress is allowed only after correct reasoning

Knowledge Graph View

• Switch between list view and interactive node-based graphs
• Visualize dependencies between skills
• Understand why a topic exists, not just what it is

---

🎓 2. Academic Command Center

Built specifically for JNTUH R25 Regulations.

Neural Synthesis

Click the ✨ Sparkle icon on any syllabus unit to generate:

• A 2-sentence executive summary
• 3 likely exam short-answer questions
• A creative mnemonic for memory retention

Interactive Timetable

• Zoomable & pannable canvas
• Upload your class schedule
• Touch & gesture support

Credit Tracking

• Visual semester-wise credit progress
• Clear graduation visibility

---

🤖 3. The AI Suite

A collection of specialized AI agents powered by the Gemini API.

Linguahub (IELTS Trainer)

• Vocabulary of the Day (high-band words)
• Context verification
• AI-generated usage checks

6-Pillar Daily Mission

Daily challenges across:

• Listening (Text-to-Speech)
• Reading
• Writing
• Grammar
• Vocabulary
• Comprehension

AI Evaluator

• Grades written answers
• Aligned to IELTS Band 7+ criteria

Interview Coach

Simulated interviews in three modes:

• Behavioral – STAR method evaluation
• Technical – deep concept checking
• System Design – architecture scalability questions

Resume Architect

• Paste a Job Description (JD)
• AI scans your actual completed roadmap
• Generates truthful, metric-driven bullet points
• No fake skills, no hallucinated experience

GitFolio

• Automatically writes professional README.md files
• Based on project description and tech stack

---

⚡ 4. Productivity & Gamification

Focus Engine

• Built-in Pomodoro timer
• Zen Mode with procedural Brownian noise
• Picture-in-Picture (PiP) support Timer floats over your IDE while you code

Gamification Economy

• Earn Star Points (XP) for completed tasks

• Lose XP for missed daily routines

• Star Shop

  • Visual themes (Cyberpunk, Minimal)
  • Utility buffs (Streak Freeze)

Zero-Backend Architecture

• 100% browser-based
• Uses localStorage
• No servers, no tracking, no data leakage

---

🤝 5. Partner Ecosystem

AcademiaMarket Integration

Direct gateway to AcademiaMarket, a peer-to-peer marketplace for:

• Academic micro-tasks
• University collaborations
• Student-to-student services

---

🛠️ Technical Architecture

Compass is built as a Client-Side SPA for maximum privacy and zero latency.

Component	Technology	Description
Framework	React 19 (Vite)	Fast refresh and component-based UI
Language	TypeScript	Strong typing for complex data
Styling	Tailwind CSS	Utility-first styling with animations
AI Layer	@google/genai	Gemini Flash / Pro models
Persistence	LocalStorage	Hook-based state with JSON
Charts	Recharts	Skill gap radar analysis
Icons	Lucide React	Lightweight SVG icons

---

🚀 Getting Started

Prerequisites

• Node.js v18 or higher
• Google Gemini API Key (free from Google AI Studio)

Installation

git clone https://github.com/aruchith08/compass.git
cd compass
npm install

Run Development Server

npm run dev

Build for Production

npm run build

---

📂 Project Structure

compass/
├── public/
├── src/
│   ├── components/
│   │   ├── Dashboard.tsx
│   │   ├── Tracker.tsx
│   │   ├── Linguahub.tsx
│   │   ├── MockInterview.tsx
│   │   ├── SyllabusViewer.tsx
│   │   ├── PomodoroTimer.tsx
│   │   └── ...
│   ├── services/
│   │   ├── ai.ts
│   │   └── api.ts
│   ├── data/
│   ├── types.ts
│   ├── App.tsx
│   └── main.tsx
└── index.html

---

📖 Usage Guide

Onboarding

• Welcome to the Career OS
• Enter your Gemini API Key (optional)
• AI features activate instantly once enabled

Roadmap Management

• Use the Role Filter to hide irrelevant skills
• Click tasks for deep conceptual insight
• High-priority tasks trigger Socratic Validation

Academic Tools

• Go to Dashboard → Syllabus Viewer
• Click any unit → Neural Synthesis
• Get instant exam-focused study aids

Focus Engine

• Select Focus / Break modes
• Enable Zen Mode
• Use Picture-in-Picture while coding

---

🛡️ Privacy & Security

• No cloud database
• No backend servers
• No tracking
• 100% local-only data storage
• API key is sent directly to Google
• Clearing browser storage resets all progress

---

🤝 Contributing

Contributions are welcome.

git checkout -b feature/AmazingFeature
git commit -m "Add AmazingFeature"
git push origin feature/AmazingFeature

Open a Pull Request 🚀

---

📄 License

Distributed under the MIT License. See LICENSE for details.

---

👨‍💻 Author

Ruchith Alokam AI Engineer & Full Stack Developer GitHub: https://github.com/aruchith08

---

Compass is not a planner. It is a system that builds careers. 🧭