Discover, analyze, and build amazing projects with comprehensive GitHub insights
WhatToBuild is an platform that helps developers discover, analyze, and understand open-source projects. Whether you're looking for inspiration, trying to understand complex codebases, or comparing developer profiles, WhatToBuild provides comprehensive insights to accelerate your development journey.
- Discovery: Find relevant repositories based on concepts and ideas
- Project Idea Generation: Get AI-generated project suggestions with tech stacks
- Relevance Scoring: Advanced algorithms rank projects by relevance to your query
- Technology Filtering: Search by programming languages and frameworks
- Code Structure Analysis: Understand project architecture and file organization
- Technology Stack Detection: Automatic identification of frameworks, libraries, and tools
- Dependency Mapping: Visualize project dependencies and relationships
- File Content Summarization: AI-powered summaries of key source files
- Contributor Insights: Analyze team composition and contribution patterns
- Profile Analytics: Compare GitHub profiles side-by-side
- Contribution Patterns: Analyze coding activity and project diversity
- Repository Quality: Evaluate star counts, fork ratios, and project impact
- Language Expertise: Compare programming language proficiency
- Activity Metrics: Track commits, issues, and collaboration patterns
- Instant Draft: Analyze your GitHub repository to generate a high‑quality README in seconds
- Flexible Input: Use
owner/repoor a full GitHub URL - Personalization: Add optional notes to steer tone, structure, and highlights
- Live Preview: Edit Markdown with a GitHub‑flavored live preview side‑by‑side
- AI Refine: Improve sections, wording, and structure via Google Gemini
- One‑Click Actions: Copy, download, or create a PR to update
README.mdin your repo - Private Repos: Use a personal access token in-session for secure access
- Architecture Diagrams: Generate visual representations of project structure
- Dependency Graphs: Interactive visualization of project dependencies
- Technology Stack Charts: Visual breakdown of technologies used
- Contribution Heatmaps: Timeline visualization of developer activity
- Good First Issues: Find beginner-friendly contribution opportunities
- Bounty Issues: Discover paid contribution opportunities
- Language-Specific Search: Filter by programming languages
- Project Categorization: Browse projects by type and domain
- Next.js 15.4.5 - React framework with App Router
- React 19.1.0 - Modern UI library with latest features
- TypeScript - Type-safe development (98.2% of codebase)
- Tailwind CSS 4.1.11 - Utility-first styling
- Framer Motion - Smooth animations and transitions
- Radix UI - Accessible component primitives
- Lucide React - Beautiful icon library
- React Icons - Additional icon sets
- Chart.js & Recharts - Data visualization
- React Three Fiber - 3D graphics and animations
- Google Generative AI - AI-powered analysis and summaries
- GitHub API - Repository data and insights
- Mermaid - Diagram generation
- ESLint - Code linting and quality
- Autoprefixer - CSS vendor prefixes
- PostCSS - CSS processing
- Node.js 18+
- npm, yarn, pnpm, or bun
- GitHub API access (for full functionality)
- Clone the repository
git clone https://github.com/NiladriHazra/WhatToBuild.git
cd WhatToBuild- Install dependencies
npm install
# or
yarn install
# or
pnpm install
# or
bun install- Set up environment variables
cp .env.example .env.localAdd your API keys to .env.local:
GITHUB_TOKEN=your_github_token_here
GOOGLE_AI_API_KEY=your_google_ai_key_here- Run the development server
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev- Open your browser Navigate to http://localhost:3000 to see the application.
- Visit the homepage and enter a concept or technology
- Browse AI-generated project ideas and relevant repositories
- Use filters to refine results by language, stars, or activity
- Click "Analyze" on any repository or enter a GitHub URL
- Explore file structure, dependencies, and code summaries
- View technology stack and architectural insights
- Navigate to the Compare section
- Enter two GitHub usernames
- Review detailed comparison metrics and visualizations
- Select "Visualize" for any repository
- Generate interactive diagrams and dependency graphs
- Export diagrams for documentation
WhatToBuild/
├── app/ # Next.js App Router pages
│ ├── analyze/ # Repository analysis
│ ├── compare/ # Developer comparison
│ ├── search/ # Project search
│ ├── visualize/ # Architecture visualization
│ └── api/ # API routes
├── components/ # React components
│ ├── Hero/ # Landing page sections
│ ├── ui/ # Reusable UI components
│ └── page/ # Page-specific components
├── lib/ # Utility functions
│ ├── github.ts # GitHub API integration
│ ├── gemini.ts # AI service integration
│ └── utils.ts # Helper functions
├── config/ # Configuration files
└── public/ # Static assets
We welcome contributions! Here's how to get started:
- Fork the repository
- Create a feature branch
git checkout -b feature/amazing-feature
- Make your changes
- Commit with conventional commits
git commit -m "feat: add amazing feature" - Push to your branch
git push origin feature/amazing-feature
- Open a Pull Request
- Follow TypeScript best practices
- Use conventional commit messages
- Add tests for new features
- Update documentation as needed
This project is licensed under the MIT License - see the LICENSE file for details.
- GitHub API for providing comprehensive repository data
- Google Generative AI for powering intelligent analysis
- Vercel for seamless deployment and hosting
- Next.js Team for the amazing framework
- Open Source Community for inspiration and tools
- Language Composition: 98.2% TypeScript, 1.7% CSS, 0.1% JavaScript
- Dependencies: 40+ production packages
- Components: Modular, reusable architecture
- Performance: Optimized with Next.js 15 features
- Live Demo: what-to-build.niladri.tech
- Repository: github.com/NiladriHazra/WhatToBuild
- Issues: Report bugs or request features
Built with ❤️ by Niladri Hazra
⭐ Star this repo if you find it helpful!
