An intelligent AI-powered code review platform that automatically analyzes GitHub pull requests and provides comprehensive feedback, suggestions, and risk assessments. Built with Next.js, this application integrates with GitHub to streamline the code review process using advanced AI models.

• 🤖 Automated Code Reviews: Leverage AI (Google Gemini & OpenAI) to automatically review pull requests
• 🔐 GitHub Integration: Seamless authentication and repository synchronization
• 📊 Dashboard Analytics: Visualize review statistics, activity heatmaps, and risk scores
• 🎯 Risk Assessment: Intelligent scoring system to identify potential issues
• 💬 Inline Comments: AI-generated comments posted directly to GitHub PRs
• 🔄 Background Processing: Asynchronous review processing using Inngest
• 🌙 Dark Mode: Built-in theme support for comfortable viewing
• 📱 Responsive Design: Works seamlessly across desktop and mobile devices

• Framework: Next.js 16 with App Router
• Language: TypeScript
• Database: PostgreSQL with Prisma ORM
• Authentication: Better Auth with GitHub OAuth
• AI Models: Google Gemini API & OpenAI API
• Background Jobs: Inngest
• API Layer: tRPC for type-safe APIs
• Styling: Tailwind CSS with Radix UI components
• State Management: TanStack Query (React Query)
• Animations: Framer Motion & React Spring

Before you begin, ensure you have the following installed:

• Node.js 20.x or higher
• pnpm (recommended) or npm
• PostgreSQL database
• GitHub OAuth App credentials
• Google Gemini API key or OpenAI API key

Create a .env file in the root directory with the following variables:

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/aicodereviewer"

# Authentication
BETTER_AUTH_SECRET="your-secret-key-here"
BETTER_AUTH_URL="http://localhost:3000"

# GitHub OAuth
GITHUB_CLIENT_ID="your-github-client-id"
GITHUB_CLIENT_SECRET="your-github-client-secret"

# AI API Keys (use at least one)
GOOGLE_GEMINI_API_KEY="your-gemini-api-key"
OPENAI_API_KEY="your-openai-api-key"

# Inngest
INNGEST_EVENT_KEY="your-inngest-event-key"
INNGEST_SIGNING_KEY="your-inngest-signing-key"

1. Clone the repository:

   git clone https://github.com/yourusername/aicodereviewer.git
   cd aicodereviewer

2. Install dependencies:

   pnpm install

3. Set up the database:

   pnpm db:generate
   pnpm db:push

4. Run the development server:

   pnpm dev

5. In a separate terminal, run Inngest dev server:

   pnpm inngest:dev

6. Open http://localhost:3000 in your browser to see the application.

• pnpm dev - Start the Next.js development server
• pnpm inngest:dev - Start the Inngest development server
• pnpm build - Build the application for production
• pnpm build:full - Generate Prisma client and build the application
• pnpm start - Start the production server
• pnpm lint - Run ESLint for code quality checks
• pnpm db:push - Push database schema changes to the database
• pnpm db:generate - Generate Prisma Client

1. Authentication: Users sign in with their GitHub account
2. Repository Sync: The app syncs accessible GitHub repositories
3. Webhook Integration: GitHub webhooks trigger reviews on new pull requests
4. AI Analysis: Pull requests are analyzed using AI models (Gemini/OpenAI)
5. Review Generation: AI generates comprehensive feedback with risk scores
6. Comment Posting: Reviews are automatically posted back to GitHub
7. Dashboard: Users can view all reviews, statistics, and activity

The application uses PostgreSQL with the following main models:

• User: User accounts with GitHub authentication
• Repository: Synced GitHub repositories
• Review: AI-generated code reviews with status tracking
• Session: User session management
• Account: OAuth account information

aicodereviewer/
├── prisma/              # Database schema and migrations
├── src/
│   ├── app/            # Next.js app router pages
│   │   ├── (auth)/     # Authentication pages
│   │   ├── (dashboard)/# Dashboard and repository pages
│   │   └── api/        # API routes and webhooks
│   ├── components/     # React components
│   ├── constant/       # Constants and configuration
│   ├── hooks/          # Custom React hooks
│   ├── lib/            # Utility libraries
│   └── server/         # Server-side code (tRPC routers, Inngest functions)
└── package.json

When a pull request is opened or updated, the system:

• Fetches the diff and file changes from GitHub
• Analyzes code patterns, potential bugs, and best practices
• Generates inline comments with suggestions
• Calculates a risk score based on complexity and potential issues

The dashboard provides:

• Overview of all reviewed pull requests
• Activity heatmap showing review frequency
• Statistics including total reviews, risk scores, and success rates
• Quick access to repository management

Uses Inngest for reliable background job processing:

• Asynchronous PR analysis to avoid blocking
• Retry logic for failed reviews
• Status tracking (PENDING → PROCESSING → COMPLETED/FAILED)

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/your-feature
3. Commit your changes: git commit -m 'Add your feature'
4. Push to the branch: git push origin feature/your-feature
5. Open a pull request

This project is private and proprietary.

For issues or questions, please open an issue in the GitHub repository.