Skip to content

harmandeeppal/nextjs-tailwind-project

 
 

Repository files navigation

AI Mock Interview Generator

A modern, responsive web application built with Next.js and Tailwind CSS that generates personalized mock interviews based on job roles. Perfect for job seekers preparing for their dream positions.

✨ Features

  • Role-Based Interview Generation: Enter any job role and get customized interview questions
  • Comprehensive Skills Assessment: View required technical and soft skills for each role
  • Interactive UI: Clean, modern interface with smooth transitions
  • Responsive Design: Works perfectly on desktop, tablet, and mobile devices
  • Popular Roles: Quick selection of common job positions
  • Real-time Generation: Instant mock interview creation with loading states

🚀 Tech Stack

  • Framework: Next.js 15.4.6 with App Router
  • Frontend: React 19.1.0 + TypeScript
  • Styling: Tailwind CSS v4
  • UI Components: Custom component library
  • Development: ESLint + TypeScript strict mode
  • Deployment: Ready for Vercel

📁 Project Structure

src/
├── app/                    # Next.js App Router
│   ├── layout.tsx         # Root layout
│   ├── page.tsx           # Home page
│   ├── globals.css        # Global styles
│   └── favicon.ico
├── components/            # React components
│   ├── ui/               # Reusable UI components
│   │   ├── Button.tsx
│   │   ├── Card.tsx
│   │   └── Input.tsx
│   └── InterviewGenerator.tsx
└── lib/
    └── utils.ts          # Utility functions

🛠️ Getting Started

Prerequisites

  • Node.js 18+
  • npm, yarn, or pnpm

Installation

  1. Clone the repository

    git clone <repository-url>
    cd nextjs-tailwind-project
  2. Install dependencies

    npm install
    # or
    yarn install
    # or
    pnpm install
  3. Run the development server

    npm run dev
    # or
    yarn dev
    # or
    pnpm dev
  4. Open your browser Navigate to http://localhost:3000

🎯 How to Use

  1. Enter Your Target Role: Type in the job position you're preparing for (e.g., "Frontend Developer", "Data Scientist")

  2. Generate Interview: Click the "Generate Mock Interview" button or press Enter

  3. Review Questions: Study the role-specific interview questions organized by category:

    • Technical Questions
    • Behavioral Questions
    • Role-Specific Scenarios
  4. Study Required Skills: Review the comprehensive skills breakdown:

    • Technical Skills
    • Soft Skills
    • Industry Knowledge
  5. Practice: Use the questions to practice your responses and assess your skill readiness

🎨 UI Components

The application includes a custom component library:

  • Button: Multiple variants (default, secondary, outline, ghost) and sizes
  • Card: Flexible card components with header, content, and footer
  • Input: Styled form inputs with focus states
  • InterviewGenerator: Main interview display component

🚀 Deployment

Deploy to Vercel (Recommended)

  1. Push to GitHub

    git add .
    git commit -m "Initial commit"
    git push origin main
  2. Deploy to Vercel

    • Connect your GitHub repository to Vercel
    • Vercel will automatically detect Next.js and configure build settings
    • Your app will be live in minutes!

Manual Deployment

npm run build
npm run start

🔧 Available Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run start - Start production server
  • npm run lint - Run ESLint

🛣️ Roadmap

  • Add AI-powered question generation via OpenAI API
  • Implement user accounts and interview history
  • Add practice session timer and scoring
  • Include company-specific interview questions
  • Add video practice recording feature
  • Implement skill gap analysis
  • Add interview tips and best practices
  • Create mobile app version

🤝 Contributing

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

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments


Ready to ace your next interview? Start practicing now! 🎯

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 95.9%
  • JavaScript 2.1%
  • CSS 2.0%