🚀 GSoC Planner & Assistant

The ultimate toolkit for students aiming to crack Google Summer of Code.

Live Demo · Report Bug · Request Feature

---

📖 Overview

GSoC Planner is a premium, frontend-first application designed to streamline the research and preparation process for Google Summer of Code aspirants. Unlike generic lists, this tool provides AI-driven insights, probability predictions, and real-time data to help you choose the right organization.

It operates entirely client-side using comprehensive local datasets and live API integrations, ensuring a fast and privacy-focused experience.

✨ Key Features

🔍 Discovery & Analysis

• Organization Explorer: Browse a curated list of top open-source organizations with advanced filtering (Technology, Category, Year).
• AI Predictor 🤖: A custom algorithm that calculates your acceptance probability based on an organization's history, slot consistency, and tech stack popularity.
• Smart Comparison: Compare two organizations side-by-side to evaluate their stats, community size, and active repositories.

🛠️ Proposal Toolkit

• Proposal Generator: Access real-world accepted proposal examples and use our structured, "fill-in-the-blanks" templates for various domains (Web, AI/ML, Systems, etc.).
• Markdown Preview: Write and preview your proposal in real-time with GitHub-flavored markdown support.
• Guide: Step-by-step timeline and advice for the entire GSoC period (May - August).

⚡ Smart Assistant

• Context-Aware Chatbot: Ask questions like "Show me beginner Python orgs" or "Explain the tech stack of KDE".
• Live GitHub Stats: Fetches the latest repository data (stars, forks, open issues) directly from GitHub.
• Resource Finder: Instantly finds tutorials and documentation for requested technologies.

🎨 Premium Experience

• Glassmorphism UI: A sleek, modern interface with dark mode, subtle gradients, and glass effects.
• Interactive Visualizations: Charts and graphs to visualize organization trends over the years.
• Favorites System: Save your target organizations to a personalized list for quick access.

🚀 Getting Started

Prerequisites

• Node.js (v16 or higher)
• npm or yarn

Installation

1. Clone the repository

   git clone https://github.com/bhanu2006-24/GSOC-planner.git
   cd GSOC-planner

2. Install dependencies

   npm install

3. Start the development server

   npm run dev

4. Open the app Visit http://localhost:5173 in your browser.

📂 Project Structure

src/
├── chatbot/           # AI Logic & Chatbot UI
│   ├── apis/          # Mock & Real API integrations (GitHub, Wiki, etc.)
│   └── smartPredictor.js # Local intent classification engine
├── components/        # Reusable UI components (Navbar, Toast, Cards)
├── data/              # Local datasets (master_orgs.json, templates, etc.)
├── pages/             # Main application views
│   ├── DataExplorer.jsx  # Advanced table view
│   ├── Guide.jsx         # Proposal generator & timeline
│   ├── OrgDetails.jsx    # Organization deep-dive modal
│   └── ...
├── predictor/         # Prediction engine logic
└── styles/            # Tailwind & CSS variables

🛠️ Tech Stack

• Frontend: React 18, Vite
• Styling: TailwindCSS, HeadlessUI, Custom CSS Animations
• Utilities:
  • react-markdown: For rendering proposal previews.
  • framer-motion: For smooth layout transitions.
  • chart.js: For statistical visualizations.
• Data Source: Custom scraped datasets combined with live GitHub API calls.

🤝 Contributing

Contributions are welcome! Whether it's adding new proposal examples, improving the AI predictor, or fixing bugs.

1. Fork the Project
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

Distributed under the MIT License. See LICENSE for more information.

---

Built with ❤️ for the Open Source Community