aiinterview-frontend

This repository contains the frontend for the Palantir AI Interview Mentor platform, built using React, TypeScript, and Vite. The frontend allows users to practice mock interviews, review past performance, upload resumes, and interact with an AI-driven interview agent. The platform is tightly integrated with a secure backend and Palantir Foundry, which handles all data storage, intelligent automation, and analytics.

---

Table of Contents

• Overview
• Features
• Architecture
• Demo
• Getting Started
• Connecting to the Backend
• Palantir Integration
• Available Scripts
• Project Structure
• Notes

---

Overview

The AI Interview Mentor frontend provides a user interface for:

• Practicing mock technical interviews with a conversational AI agent
• Uploading and parsing resumes
• Reviewing detailed dashboards and analytics about interview performance
• Receiving personalized practice plans and tasks after interviews
• Browsing history of all previous interviews and feedback

All sensitive operations and persistent data are managed on the backend and within Palantir Foundry via secure API calls. The frontend never handles or stores Palantir credentials directly.

---

Features

• Mock Interview Sessions: Start interactive interviews with an AI agent that adapts to the provided job description.
• Resume Upload: Submit structured resume data to improve the quality of interview questions and feedback.
• Personalized Dashboard: Visualize interview scores, strengths, weaknesses, and progress metrics.
• Practice Plans: Receive actionable feedback and tasks to improve interview skills, generated by Palantir AIP logic.
• Interview History: Browse all past interviews, their scores, feedback, and assigned tasks.
• Authentication: Secure login and signup, with JWT-based session handling.

---

Architecture

• Frontend: React + TypeScript (Vite), with modular components, hooks, and modern state management.
• Backend: All API calls are proxied through a lightweight backend (see @manas-1404/aiinterview-backend), which interacts with Palantir Foundry via the Ontology SDK and protects all secrets.
• Palantir Foundry: All user data, interview sessions, resume info, and analytics are stored and processed in Foundry, with automation and logic implemented on the Palantir platform.
• Environment-based Configuration: The backend API URL is configured via environment variables.

---

Demo

Dashboard

This page shows the dashboard of the Ai-Interviewer application. The dashboard metrics and information are computed using Palantir AIP Logic and automations.

---

Practice Plan & Previous Interviews

This page shows the practice plan and the practice tasks after the interview. All the information and tasks are generated with the help of Palantir AIP Agents, AIP Logic and automations.

---

Getting Started

Prerequisites

• Node.js (v18 or higher recommended)
• npm or yarn

Installation

1. Clone this repository:

   git clone https://github.com/manas-1404/aiinterview-frontend.git
   cd aiinterview-frontend

2. Install dependencies:

   npm install
   # or
   yarn install

3. Set up environment variables:

   • Create a .env file in the root directory.
   • Add the following line, replacing the URL with your backend server address:

     VITE_BACKEND_URL=http://localhost:8000
     

     The backend server must be running and accessible for the frontend to function. See below for backend setup.

---

Connecting to the Backend

All API calls (authentication, resume upload, interview agent, dashboard, etc.) are made to a backend server (see @manas-1404/aiinterview-backend). The backend:

• Serves as a secure proxy for all Palantir Foundry operations
• Prevents exposure of any Palantir secrets to the client or browser
• Requires valid Palantir Foundry dev tier access to run

To get started:

1. Clone and set up the backend as described in its README.
2. Ensure your .env in this frontend repo points to the backend URL.
3. Start both backend and frontend servers.

---

Palantir Integration

• All user data, interview sessions, resume details, practice plans, and analytics are stored in Palantir Foundry.
• The frontend communicates only with the backend, which uses the Palantir Ontology SDK to read/write data.
• No Palantir credentials are ever handled by the frontend.
• Palantir automations and AIP agents generate practice plans, evaluate interviews, and handle analytics.

---

Available Scripts

• npm run dev — Starts the Vite development server on http://localhost:5173
• npm run build — Builds the app for production
• npm run preview — Serves the production build locally

---

Project Structure

• src/api/ — All API utilities for communicating with the backend server
• src/routes/ — Page-level components (Dashboard, Interview Session, File Upload, etc.)
• src/components/ — Reusable UI and functional components
• src/types/ — TypeScript type definitions for API data and internal state

---

Notes

• You must have the backend server running in order to use this frontend.
• The backend server requires Palantir dev tier access and valid credentials.
• If you encounter issues, ensure the backend is accessible and all API endpoints are reachable from the frontend.
• All persistent data and logic are managed in Palantir Foundry.
• This project does not expose, handle, or store any Palantir credentials in the browser or client code.

---