CareerTwin AI 🚀

The Autonomous Career Digital Twin & Engineering Velocity OS

CareerTwin AI creates a high-fidelity digital twin of a software engineer's skills, analyzes the exact structural gap between their current state and target dream role (e.g., Senior Full-Stack → Staff Distributed Systems & AI Architect), and generates autonomous 3-month sprints, curated portfolio blueprints, and 24/7 AI mentor intelligence.

---

🏛️ System Architecture

flowchart TD
    subgraph Client ["Frontend Architecture (React 18 + Vite + Tailwind CSS)"]
        A["Hero & Neural Mesh Canvas"] --> B["Command Palette (Cmd+K)"]
        B --> C["Dashboard & Readiness Gauge"]
        C --> D["AI Career Gap Diagnostic"]
        C --> E["Skill Radar Matrix (Recharts)"]
        C --> F["Dynamic Sprints & Roadmap"]
        C --> G["Systems Portfolio Engine"]
        C --> H["24/7 AI Twin Mentor Chat"]
    end

    subgraph Service ["Backend Intelligence Engine (Express & Node.js)"]
        I["REST API Gateway & Middlewares"]
        J["Deterministic Career Engine"]
        K["Dual Storage Layer (MongoDB + In-Memory)"]
    end

    subgraph Intelligence ["AI Layer (Google Gemini 1.5)"]
        L["Semantic Gap Extractor"]
        M["System Design Interview Simulator"]
        N["Resume Roaster & Compensation Scripting"]
    end

    Client <-->|REST JSON & JWT| Service
    Service <-->|Structured Prompts| Intelligence

Loading

---

✨ Key Features & Capabilities

1. 🌌 Luxury Linear / Raycast Visual Aesthetic

• Dark Mode First Palette: Deep obsidian backgrounds (#090A0F), soft graphite panels, neon violet accents, and electric cyan highlights.
• Micro-Interactions: Synthesized Web Audio sound feedback, interactive particle mesh background, specular glassmorphic highlights, and celebratory confetti triggers.
• Global Command Palette (Cmd+K / Ctrl+K): Rapid keyboard navigation across roadmaps, skills, projects, and instant AI mentor prompts.

2. ⚡ Autonomous AI Career Gap Diagnostic

• Analyzes candidate background across years of experience, current stack proficiencies, target ambition, and available weekly study hours.
• Computes Career Readiness Score (0-100%), Projected Time Horizon, and Total Compensation Upside.
• Categorizes strengths vs critical gaps calibrated to hiring bars at companies like Stripe, OpenAI, Datadog, and Google.

3. 🎯 Multi-Axis Skill Radar & Delta Severity Matrix

• Dynamic Recharts Radar & Bar Visualizations comparing current abilities against target staff requirements.
• Tactical Sprint Action Blueprints for closing critical deficits (e.g. Raft consensus, SIMD vector search, LSM trees).

4. 🚀 3-Month Dynamic Sprints Roadmap

• 3-Tier hierarchy: Monthly Milestones, Weekly Sprints, and Daily High-Impact Tasks.
• Interactive checkboxes with instant score recalculation, progress bars, and JSON export capabilities.

5. 🛠️ Curated Systems Portfolio Blueprints

• Real-world distributed systems and AI infrastructure projects (e.g., AuraRaft, HyperVector, NexusGateway) designed to bypass traditional recruiter keyword screens.
• Includes complete architecture specifications, hiring manager appeal summaries, and GitHub implementation milestones.

6. 🧠 24/7 AI Career Twin & Principal Mentor

• Powered by Google Gemini 1.5 with quick action prompts:
  • 🎯 Roast My Resume for Staff Level
  • ⚡ Mock 45-Minute System Design Interview
  • 💼 Staff Compensation Negotiation Script
  • 🚀 Master Raft in 2 Weeks Blueprint

7. 🛡️ 1-Click Recruiter Sandbox

• Instant exploration mode pre-seeded with high-profile Staff candidate telemetry, eliminating friction for recruiters, investors, and hiring managers.

---

📂 Project Structure

careertwin-ai/
├── backend/
│   ├── src/
│   │   ├── controllers/       # Auth, Analysis, Roadmap, Projects, Mentor, Analytics
│   │   ├── middleware/        # JWT & 1-Click Demo authorization
│   │   ├── routes/            # REST API endpoints (/api/*)
│   │   ├── services/          # Gemini AI client & Dual Mongo/Memory store
│   │   └── server.js          # Express app entrypoint
│   ├── .env.example
│   └── package.json
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   │   ├── common/        # GlassCard, Button, Badge, ScoreRing, CommandPalette, Particles
│   │   │   ├── landing/       # HeroTwinVisualizer & Trajectory Simulator
│   │   │   └── layout/        # Navbar, Sidebar, Footer
│   │   ├── context/           # AuthContext, CareerContext, SoundContext
│   │   ├── pages/             # Landing, Auth, Dashboard, Analysis, SkillGap, Roadmap, Projects, Mentor, Analytics
│   │   ├── services/          # API abstraction layer
│   │   ├── styles/            # Tailwind CSS & glassmorphic shader rules
│   │   ├── App.jsx            # Application Router
│   │   └── main.jsx           # Root Provider Injection
│   ├── index.html
│   ├── tailwind.config.js
│   ├── vite.config.js
│   └── package.json
├── package.json               # Root scripts for concurrent execution
└── README.md                  # Venture Documentation

---

🚀 Quick Start Guide

Prerequisites

• Node.js: v18.0+ (Tested on v26.8)
• NPM: v9.0+

Installation

1. Clone and install dependencies:

   git clone https://github.com/careertwin/careertwin-ai.git
   cd careertwin-ai
   npm run install:all

2. Configure Environment Variables (Optional): Copy backend/.env.example to backend/.env:

   PORT=5000
   NODE_ENV=development
   JWT_SECRET=careertwin_super_secret_jwt_key_2025_venturesaas
   # Optional: Provide real Gemini API Key, or leave empty for autonomous career engine
   GEMINI_API_KEY=
   # Optional: MongoDB URI, or leave empty for zero-config high-performance In-Memory store
   MONGODB_URI=

3. Start Fullstack Environment Concurrently:

   npm run dev

   • Frontend App: http://localhost:5173
   • Backend API: http://localhost:5000
   • API Health Check: http://localhost:5000/api/health

---

🌐 Production Deployment Guide

Deploying Frontend to Vercel

1. Set the Root Directory to frontend.
2. Build Command: npm run build
3. Output Directory: dist
4. Environment Variables:
   • VITE_API_URL: Your backend URL (e.g. https://careertwin-backend.onrender.com)

Deploying Backend to Render / Railway

1. Set the Root Directory to backend.
2. Build Command: npm install
3. Start Command: npm start
4. Environment Variables:
   • PORT: 5000
   • JWT_SECRET: Generate a secure 32+ character key
   • GEMINI_API_KEY: Your Google Gemini API key
   • MONGODB_URI: (Optional) MongoDB Atlas Connection String

---

🛡️ License

Distributed under the MIT License. Developed with pride by the CareerTwin AI Engineering Team.