🚀 TestGen AI – AI-Powered Test Case Generation Agent

TestGen AI is a state-of-the-art test case generator designed to create high-coverage test suites instantly. Utilizing the power of Google Gemini API, TestGen AI scans your source code, requirements specs, or API endpoints to construct standard, copy-paste ready assertions spanning multiple testing frameworks (Jest, Mocha, PyTest, Supertest, Cypress, Playwright, etc.).

---

⚡ Live Deployments

• Frontend Dashboard: https://ai-test-case-generation-agent.vercel.app
• Backend API Gateway: https://ai-test-case-generation-agent-5gnq.vercel.app

---

✨ Features

• Unit Assertion Builder: Builds standard assertions verifying method behaviors, success states, and input checks.
• Integration Pipelines: Simulates multi-step workflow logic covering databases, API routers, and services.
• Vulnerability Scanner: Tests boundary validation checks, SQL Injection safety, cross-site scripting risks, and headers.
• Edge Cases & Boundaries: Verifies empty payloads, zero limits, null pointer references, and extreme sizing.
• Performance Benchmarking: Sets expectations for response latencies, payload throughput, and limits.
• Dark Mode UI: Sleek, glassmorphism-based web interface built with Next.js, featuring glowing mesh gradients, progressive thinking sequences, and copyable results blocks.

---

🛠️ Technology Stack

Frontend

• Core Framework: React 19 & Next.js 15 (App Router)
• Styling: Tailwind CSS & Vanilla CSS transitions
• Icons: Lucide React
• Client Routing: Next.js App Router static optimization

Backend

• Core Environment: Node.js (ES Modules)
• Routing Framework: Express.js
• AI Core: Google Gemini SDK (@google/generative-ai)
• Security & Utilities: CORS, dotenv, nodemon

---

📁 Repository Structure & Files

Here is the complete folder and file tree of the project:

.
├── backend/                                # Node.js Express REST API server
│   ├── controllers/                        # Handlers for API endpoints
│   │   └── generateController.js           # Receives prompts and manages generation responses
│   ├── middleware/                         # Middleware interceptors
│   │   └── errorMiddleware.js              # Standard Express error handler
│   ├── routes/                             # API path routes definitions
│   │   └── generateRoutes.js               # Route mapping for POST /api/generate
│   ├── services/                           # Logic connecting to Google Gemini APIs
│   │   └── geminiService.js                # Core LLM processing and response schema mapping
│   ├── utils/                              # Helper functions for the backend
│   │   └── promptBuilder.js                # Builds and formats structured system prompts
│   ├── .env                                # Backend environment configuration variables
│   ├── package.json                        # Backend package and script setup
│   ├── server.js                           # Server boot entry point, CORS settings, health checks
│   └── vercel.json                         # Serverless configuration rules for Vercel
│
├── frontend/                               # Next.js SPA Web Client
│   ├── app/                                # App Router views and layouts
│   │   ├── favicon.ico                     # Next.js tab logo file
│   │   ├── globals.css                     # Global stylesheets, fonts, animations, layout styles
│   │   ├── layout.tsx                      # Root App Router layout enclosing Navbar/Footer
│   │   ├── page.tsx                        # Main dashboard, templates grid, feature summaries
│   │   ├── privacy/                        # Privacy policy route
│   │   │   └── page.tsx                    # Privacy Policy page details
│   │   └── terms/                          # Terms of Service route
│   │       └── page.tsx                    # Terms of Service page details
│   ├── components/                         # Reusable UI component modules
│   │   ├── EmptyState.tsx                  # Component displayed when no tests are generated
│   │   ├── ExportButtons.tsx               # Handles PDF/JSON actions
│   │   ├── Footer.tsx                      # Custom footer with links and admin contact
│   │   ├── Hero.tsx                        # Mesh gradient header and floating title transitions
│   │   ├── InputArea.tsx                   # Prompt textarea area and form submit controls
│   │   ├── Loading.tsx                     # Progressive 0-99% thinking sequencer UI
│   │   ├── Navbar.tsx                      # Premium top navigation header
│   │   ├── OutputCard.tsx                  # Code viewer with syntax highlight and copy functionality
│   │   ├── ResultSection.tsx               # Outer boundary managing active output cards
│   │   ├── SampleTemplates.tsx             # Clickable grid examples for fast prompts loading
│   │   └── StatsSection.tsx                # Viewport count-up numbers displaying test statistics
│   ├── hooks/                              # React custom state hooks
│   │   └── useGenerate.ts                  # Integrates frontend UI states with backend API calls
│   ├── public/                             # Public static assets folder
│   │   └── logo.png                        # Main app branding logo image file
│   ├── services/                           # API communication helpers
│   │   └── api.ts                          # Defines base fetch instances with fallback values
│   ├── types/                              # TypeScript type interfaces definitions
│   │   └── testResult.ts                   # Typing interface for AI test suite outputs
│   ├── utils/                              # Helper utilities
│   │   ├── copyText.ts                     # Handles secure clipboard copying
│   │   ├── downloadJson.ts                 # Triggers instant local file JSON downloads
│   │   └── exportPDF.ts                    # Dynamic PDF report builder
│   ├── .env.local                          # Frontend local build environments configuration file
│   ├── next-env.d.ts                       # Next.js TypeScript definitions compiler file
│   ├── next.config.ts                      # Configuration rules for Next.js routing/headers
│   ├── package.json                        # Frontend packages, TS types, next scripts configuration
│   ├── postcss.config.mjs                  # PostCSS styling pipeline config file
│   ├── tailwind.config.ts                  # Design tokens, custom themes, and core color setup
│   └── tsconfig.json                       # TypeScript compiler strict mode settings
│
├── .gitignore                              # Defines version control ignored resources
└── README.md                               # Repository documentation guide

---

⚙️ Local Development Setup

Follow these steps to run the application locally on your computer.

Prerequisites

• Node.js (v18 or higher)
• npm package manager
• A Google Gemini API Key (Get one from Google AI Studio)

---

Step 1: Configure & Start the Backend

1. Navigate to the backend directory:

   cd backend

2. Install the backend dependencies:

   npm install

3. Create a .env file in the backend/ directory:

   PORT=5000
   GEMINI_API_KEY=your_gemini_api_key_here
   GEMINI_MODEL=gemini-1.5-flash

4. Start the backend development server:

   npm run dev

   The backend will boot up on http://localhost:5000.

---

Step 2: Configure & Start the Frontend

1. Navigate to the frontend directory:

   cd ../frontend

2. Install the frontend dependencies:

   npm install

3. Create a .env.local file in the frontend/ directory to configure endpoints:

   NEXT_PUBLIC_API_URL=http://localhost:5000

4. Run the frontend development server:

   npm run dev

   Open http://localhost:3000 in your browser to view the TestGen AI dashboard.

---

🔌 API Documentation

1. Health Status

Check the status of the server.

• Endpoint: GET /health
• Response:

  {
    "status": "OK",
    "timestamp": "2026-05-25T08:52:00.000Z"
  }

2. Generate Test Suite

Send specifications/code and receive a fully generated, multi-category test suite.

• Endpoint: POST /api/generate
• Headers: Content-Type: application/json
• Body:

  {
    "prompt": "Create an integration test suite for a node.js Express user register route that checks email validations and password hash storage."
  }

• Response:

  {
    "unitTests": "...",
    "integrationTests": "...",
    "edgeCases": "...",
    "securityTests": "...",
    "performanceTests": "..."
  }

---

📞 Administrator & Contact Details

• Admin Name: Vijayapandian T
• Email Support: Vijayapandian.T
• GitHub Profile: Vijayapandian.T
• Git Repository: Vijayapandian.T