Skip to content

ChetanbirSingh/FitCheck

Repository files navigation

🧪 FitCheck: AI-Powered Portfolio Reviewer

📘 Table of Contents

Project Description

Scope and Functionality

FitCheck is a web application designed to provide AI-powered code reviews for GitHub repositories. Users select a reviewer persona (e.g., Mentor, Recruiter, Senior Developer) and get real-time, markdown-formatted feedback tailored to that perspective. The application supports multiple frontend frameworks and allows users to select specific files for review.

Motivation

The motivation behind FitCheck was to help developers — especially students and job seekers — receive clear, relevant, and contextual feedback on their code. It aims to simulate real-world code reviews in a fast, automated way.

Screenshots or Demo

Home

Persona Select

Techstack Select

Enter Url

AI Feedback

Technology Stack

  • Next.js
  • React
  • TypeScript
  • TailwindCSS
  • ShadCN UI
  • OpenAI SDK
  • SWR
  • Framer Motion

Future Implementations/Improvements

  • Export reviews as PDFs
  • Integrate resume reviewer module
  • Add support for backend languages (Node, Python, etc.)

🐞 Known Bugs

All previously known bugs have been resolved or are no longer relevant based on recent updates.

📬 Submit a bug or view open issues

Installation and Setup

Prerequisites

  • OpenAI API Key (required)
  • Github API Key (required)

Setup Instructions

git clone https://github.com/ChetanbirSingh/fitcheck
cd fitcheck

# Copy the example env file and rename it
cp .env.example .env.local

# Open .env.local and add your OpenAI and GitHub API keys

npm install
npm run dev

Detailed User Manual

  1. Choose a reviewer persona (Mentor, Recruiter, etc.)
  2. Select a tech stack (React, Next.js, HTML/CSS, etc.)
  3. Paste a GitHub repository URL (public repos only)
  4. Select files you want reviewed
  5. Hit submit — feedback streams in real-time

Each persona tailors the tone and focus of the review:

  • Mentor: Growth and learning tips
  • Recruiter: Hireability and red flags
  • Senior Dev: Code architecture and practices
  • UI/UX Designer: Visual critique
  • Peer: Friendly suggestions

Credits and Acknowledgments

About

FitCheck is an AI-powered code review tool that analyzes GitHub repos based on tech stack and role, delivering tailored feedback to improve code quality and job alignment.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors