Skip to content

amalick8/ForgeAI

BranchesTags

Repository files navigation

Forge: AI Career Accelerator

🚀 Live Demo

https://amalick8.github.io/ForgeAI/

About

Forge is a premium, AI-powered career acceleration platform for software engineers and students. It provides high-fidelity analysis of resumes, GitHub profiles, and LeetCode activity to help you identify gaps and land FAANG-level interviews.

Key Value Propositions

  • Know Your Readiness: Real-time assessment of your interview preparedness across multiple dimensions
  • Deep Technical Analysis: AI-powered insights on code quality, algorithm mastery, and resume impact
  • Actionable Feedback: Get specific improvements for your GitHub repos, resume bullets, and ATS compliance
  • Interview Preparation: Access to a curated interview vault for mastering common patterns

Features

🏠 Home Dashboard

  • Real-time readiness score aggregating GitHub, LeetCode, and resume metrics
  • Visual progress tracking
  • Quick access to all analysis tools

💻 GitHub Analyzer

  • Repository quality assessment
  • Code complexity analysis
  • README audit and recommendations
  • Contributor statistics and consistency scoring

🧮 LeetCode Analyzer

  • Problem-solving pattern mastery mapping
  • Algorithm category breakdown
  • Difficulty level progression
  • Semantic analysis of problem solutions

📄 Resume Analysis

  • ATS (Applicant Tracking System) keyword audit
  • Impact score calculation
  • Bullet point rewriting for maximum effect
  • Format and structure suggestions

✅ ATS Audit

  • Keyword matching against job descriptions
  • Compliance scoring
  • Formatting recommendations
  • Hidden requirements detection

🎓 Interview Vault

  • Curated problem library
  • Pattern-based categorization
  • Solution walkthroughs
  • Interview question database

⚙️ Settings & Profile Management

  • Account preferences
  • API key management
  • Analysis history
  • Export capabilities

Tech Stack

  • Frontend: React 19 + TypeScript
  • Build Tool: Vite
  • Styling: Tailwind CSS
  • Animations: Framer Motion
  • Routing: React Router v7
  • Icons: Lucide React
  • AI Engine: Google Gemini 3 Flash API
  • Package Manager: npm

Getting Started

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn
  • Google Gemini API key

Installation

  1. Clone the repository (if applicable)

    git clone <repository-url>
cd forge_-ai-career-accelerator

  2. Install dependencies

    npm install

  3. Set up environment variables Create a .env.local file in the root directory and add your Gemini API key:

    VITE_API_KEY=your_gemini_api_key_here

  4. Run the development server

    npm run dev

    The app will be available at http://localhost:5173 (or the port Vite assigns)

Build for Production

npm run build

The production-ready files will be in the dist/ directory.

Preview Production Build

npm run preview

Project Structure

forge_-ai-career-accelerator/
├── src/
│   ├── App.tsx                          # Main app component with routing
│   ├── geminiService.ts                 # Google Gemini API integration
│   ├── index.tsx                        # React entry point
│   ├── types.ts                         # TypeScript type definitions
│   ├── vite-env.d.ts                    # Vite environment types
│   │
│   ├── pages/                           # Marketing & auth pages
│   │   ├── LandingPage.tsx              # Homepage
│   │   ├── HowItWorks.tsx               # Product explanation
│   │   ├── Pricing.tsx                  # Pricing tiers
│   │   ├── LoginPage.tsx                # User login
│   │   ├── SignupPage.tsx               # User registration
│   │   ├── DemoPage.tsx                 # Demo mode
│   │   │
│   │   └── app/                         # Protected application pages
│   │       ├── AppHome.tsx              # Dashboard
│   │       ├── AppGitHub.tsx            # GitHub analyzer
│   │       ├── AppLeetCode.tsx          # LeetCode analyzer
│   │       ├── AppSemanticAnalysis.tsx  # Code pattern analysis
│   │       ├── AppResume.tsx            # Resume analyzer
│   │       ├── AppATS.tsx               # ATS audit tool
│   │       ├── AppVault.tsx             # Interview vault
│   │       └── AppSettings.tsx          # User settings
│   │
│   ├── index.html                       # HTML entry point
│   ├── metadata.json                    # App metadata
│   ├── package.json                     # Dependencies & scripts
│   ├── tsconfig.json                    # TypeScript configuration
│   └── vite.config.ts                   # Vite configuration

Pricing Tiers

Plan Price Features
Free $0/month GitHub basic scan, LeetCode stats, 1 Resume audit/month, Community support
Student $7/month Daily audit updates, Full bullet rewriter, ATS keyword audit, GitHub README audit
Pro $15/month Everything in Student + Interview vault access, Priority analysis, 1-on-1 career guidance

API Integration

Forge uses the Google Gemini 3 Flash API for AI-powered analysis:

  • Resume Analysis: Extracts ATS scores, impact assessments, and keyword matching
  • GitHub Analysis: Evaluates code quality, repository complexity, and portfolio strength
  • LeetCode Analysis: Maps algorithm problem-solving patterns and skill gaps
  • Content Generation: Provides actionable rewrite suggestions and improvement recommendations

Update your API key in .env.local to enable full functionality.

Available Routes

Public Routes

  • / - Landing page
  • /how-it-works - Product features & benefits
  • /pricing - Pricing page
  • /login - User login
  • /signup - User registration
  • /demo/* - Demo mode (read-only preview)

Protected Routes (Require Authentication)

  • /app/home - Dashboard
  • /app/github - GitHub analyzer
  • /app/leetcode - LeetCode analyzer
  • /app/leetcode/semantic-analysis - Pattern analysis
  • /app/resume - Resume analyzer
  • /app/ats - ATS audit
  • /app/interview-vault - Interview vault
  • /app/settings - Settings & profile

Development Tips

Hot Module Replacement

Vite provides instant HMR for fast development. Changes to React components reflect immediately without full page refreshes.

TypeScript Strict Mode

The project uses strict TypeScript checking for type safety. Ensure all types are properly defined before deployment.

Styling

Uses Tailwind CSS for responsive design. Customize theme in the component classes or extend tailwind.config.js if needed.

Component Animations

Framer Motion handles smooth page transitions and UI animations. The PageWrapper component in App.tsx wraps all routes with consistent entry/exit animations.

Troubleshooting

Port Already in Use

If port 5173 is in use, Vite will automatically try the next available port. Check the terminal output for the actual URL.

API Key Issues

Ensure your VITE_API_KEY environment variable is set correctly in .env.local. The app requires a valid Gemini API key for analysis features to work.

Build Errors

Clear the cache and reinstall dependencies:

rm -rf node_modules package-lock.json
npm install
npm run build

Contributing

Contributions are welcome! To contribute:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is proprietary and confidential. Unauthorized use, distribution, or modification is prohibited.

Support

For support, feature requests, or bug reports, please contact the team or open an issue in the repository.

2026 Addendum (Current Workspace Snapshot)

The sections above remain valid, and this addendum reflects the current file layout and runtime behavior as of February 19, 2026.

Current Top-Level Structure

Note: The current workspace is root-based (no src/ directory).

forge_-ai-career-accelerator/
├── .env.local                          # Local environment variables
├── App.tsx                             # Main app + routing and layouts
├── geminiService.ts                    # Google Gemini API integration
├── index.html                          # HTML entry point
├── index.tsx                           # React mount/bootstrapping
├── metadata.json                       # App metadata
├── package.json                        # Dependencies + scripts
├── tsconfig.json                       # TypeScript configuration
├── types.ts                            # Shared TypeScript types
├── vite.config.ts                      # Vite configuration
│
└── pages/
      ├── LandingPage.tsx                 # Marketing homepage
      ├── HowItWorks.tsx                  # Product explanation
      ├── Pricing.tsx                     # Pricing page
      ├── LoginPage.tsx                   # Authentication login
      ├── SignupPage.tsx                  # Authentication signup
      ├── DemoPage.tsx                    # Demo-related page/component
      ├── Dashboard.tsx                   # Dashboard-style page/component
      ├── GithubAnalyzer.tsx              # Standalone analyzer page/component
      ├── LeetCodeAnalyzer.tsx            # Standalone analyzer page/component
      ├── ResumeAnalyzer.tsx              # Standalone analyzer page/component
      ├── InterviewVault.tsx              # Standalone vault page/component
      │
      └── app/
            ├── AppHome.tsx                 # In-app dashboard
            ├── AppGitHub.tsx               # In-app GitHub analyzer
            ├── AppLeetCode.tsx             # In-app LeetCode analyzer
            ├── AppSemanticAnalysis.tsx     # In-app semantic analysis
            ├── AppResume.tsx               # In-app resume analysis
            ├── AppATS.tsx                  # In-app ATS audit
            ├── AppVault.tsx                # In-app interview vault
            └── AppSettings.tsx             # In-app settings

Routing Runtime Notes (Current)

  • The app uses HashRouter in App.tsx, so browser URLs are hash-based in production/static hosting contexts.
  • Public marketing/auth routes remain:
    • /, /how-it-works, /pricing, /login, /signup
  • Demo routes are mounted under /demo/* with app-like navigation:
    • /demo/home, /demo/github, /demo/leetcode, /demo/leetcode/semantic-analysis, /demo/resume, /demo/ats, /demo/interview-vault, /demo/settings
  • Authenticated routes are mounted under /app/*:
    • /app/home, /app/github, /app/leetcode, /app/leetcode/semantic-analysis, /app/resume, /app/ats, /app/interview-vault, /app/settingsf

Component Inventory Clarification

  • The pages/app/* components are the primary routed application surfaces in the current App.tsx setup.
  • Additional standalone page files (for example Dashboard.tsx, GithubAnalyzer.tsx, LeetCodeAnalyzer.tsx, ResumeAnalyzer.tsx, and InterviewVault.tsx) exist in pages/ and can support alternate flows, modular development, or future route expansions.

Built with ❤️ to accelerate your tech career | Forge - AI Career Accelerator

About

Forge is a minimalist AI-powered career audit platform that analyzes GitHub, LeetCode, resumes, and ATS readiness to show software engineers exactly where they stand and what to fix.

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages