Merge pull request #14 from devfolioco/new-feature

New feature

Author: veesesh

content/docs/guide/devfolio-mcp.mdx

@@ -0,0 +1,135 @@
+---
+title: Devfolio MCP
+description: Learn about Devfolio MCP (Model Context Protocol) integration.
+---
+
+<Callout title="Announcement" type="info">
+Builders, meet the Devfolio MCP Server (Beta).
+
+Pull your profile. Fetch your hackathons. Draft a submission, all from the comfort of your AI client.
+</Callout>
+
+## 🤔 What is MCP?
+
+**MCP** stands for **Model Context Protocol** - a protocol that securely streams relevant personal or app-specific data to AI models, helping them respond with deeper context and awareness.
+
+In this case, it allows you to connect your Devfolio account to any MCP-compatible AI tool (like Cursor, VS Code extensions, or Claude) using a simple JSON configuration. This means the AI can understand things like your Devfolio profile, projects, and hackathon activity **only if you allow it**.
+
+<Callout title="Want to dive deeper?" type="info">
+Check this out → [Devfolio MCP Explainer](https://nsb.dev/devfolio-mcp-explainer)
+</Callout>
+
+<iframe
+  width="100%"
+  height="400"
+  src="https://drive.google.com/file/d/1LHIWX9uWOmXrJK_dnY0rLRf8Qa4ya76p/preview"
+  title="Devfolio MCP Demo"
+  frameBorder="0"
+  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+  allowFullScreen
+/>
+
+---
+
+## 🧠 Unlock Devfolio's MCP AI — Step-by-Step Guide
+
+<Callout title="Beta Access Required" type="warning">
+This feature is currently available for Beta Users Only
+</Callout>
+
+---
+
+### ✨ Step 1: Enter
+
+Head to [devfolio.co](https://devfolio.co/) and click on your avatar in the **top-right corner**. From the dropdown, click **Account Settings**.
+
+<img src="/assets/mcp-step1.webp" alt="Account Settings" />
+
+---
+
+### 🧪 Step 2: Join the Beta Club
+
+In the **left sidebar**, find the tab labeled **Beta**. Click it, and hit **Join [Devfolio Beta](https://devfolio.co/settings/beta)**.
+
+<Callout title="Welcome to the experimental zone" type="info">
+You're now part of the experimental zone. No lab coats required.
+</Callout>
+
+<img src="/assets/mcp-step2.webp" alt="Join Beta" />
+
+---
+
+### 🤖 Step 3: Find the "MCP" Gateway
+
+Once you've joined the Beta program, a new tab magically appears just below — called **MCP**. Click it: [https://devfolio.co/settings/mcp](https://devfolio.co/settings/mcp)
+
+<Callout title="What is Devfolio MCP?" type="info">
+Devfolio MCP = Devfolio's Model Context Protocol Server.
+</Callout>
+
+<img src="/assets/mcp-step3.webp" alt="MCP Gateway" />
+
+---
+
+### 🔐 Step 4: Configure the MCP
+
+Inside the MCP tab:
+
+- Generate your **API Key**
+- Copy the auto-generated **JSON config**
+
+<Callout title="Security Warning" type="error">
+Your MCP API key is sensitive — like a password. Anyone with access can act on your behalf. If compromised, revoke it and generate a new one right away.
+</Callout>
+
+---
+
+### 🧩 Step 5: Connect an AI Agent
+
+Take your JSON config and paste it into a compatible MCP AI client like Cursor or any other that supports streamable HTTP MCP servers.
+
+- **Open Your IDE**
+  - Launch your preferred editor (VS Code, Cursor, etc.).
+  - Make sure the MCP-compatible plugin/extension is installed.
+- **Open the Command Palette**
+  - Press `Cmd + Shift + P` (Mac) or `Ctrl + Shift + P` (Windows/Linux).
+  - Type: `MCP` → select `Add MCP Server` (or equivalent).
+- **Paste Your Config**
+  - Paste the JSON config you copied from Devfolio MCP Tab.
+  - It should look like this:
+
+```json
+{
+  "mcpServers": {
+    "devfolio": {
+      "url": "https://mcp.devfolio.co/mcp?apiKey=XXXX-XXXX-XXXX-XXXX-XXXX"
+    }
+  }
+}
+```
+
+<Callout title="What's happening?" type="info">
+You're essentially plugging your AI into your Devfolio universe.
+</Callout>
+
+<img src="/assets/mcp-step5.webp" alt="Cursor IDE configured with Devfolio MCP" />
+<p align="center"><i>Example: Cursor IDE configured with Devfolio MCP</i></p>
+
+---
+
+### 💬 Step 6: Talk to Your Devfolio AI!
+
+Here are some good sample questions to ask the AI:
+
+- What is my username?
+- Analyze and summarize the prizes for the `hackathonName` hackathon.
+- Which prizes from the hackathon are most relevant to my project?
+- Analyze my project, and create a submission for the `hackathonName` hackathon.
+- Update the tagline of my project `projectName` to be more impactful.
+
+<Callout title="Success!" type="info">
+🎉 Hola! You now have an AI buddy that knows your Devfolio activity.
+</Callout>
+
+<img src="/assets/mcp-step6.webp" alt="AI interaction example" />
+

content/docs/guide/meta.json

@@ -10,6 +10,7 @@
     "linking-your-ethereum-wallet",
     "settings",
     "keyboard-accessibility",
+    "devfolio-mcp",
 
     "---👨‍💻 Devfolio for Hackers---",
     "start-your-devfolio-hacker-experience-here",

content/docs/guide/organizer-dashboard/meta.json

@@ -8,6 +8,7 @@
     "emails-tab",
     "admin-tab",
     "team-tab",
+    "projects-tab",
     "additional-tab",
     "update-tab"
   ]

content/docs/guide/organizer-dashboard/projects-tab.mdx

@@ -0,0 +1,57 @@
+---
+title: Projects Tab
+description: Manage and review all project submissions for your hackathon in one place.
+---
+
+## Projects Tab
+
+The Projects Tab allows you to view, manage, and review all project submissions made by participants during your hackathon.
+
+<Callout title="Accessing the Projects Tab" type="info">
+You can access this tab from `https://org.devfolio.co/<hackathon_slug>/projects`
+</Callout>
+
+<img src="/assets/Projects Tab.gif" alt="Projects Tab Overview" />
+
+---
+
+## Key Features
+
+### Search Projects
+
+Quickly find specific projects by searching for:
+- Project name
+- Username
+- Team name
+
+### Filter and Sort
+
+**Filter by Status:**
+- All projects
+- Published projects (visible on microsite)
+- Draft projects (not yet published)
+
+**Sort by:**
+- Project Name
+- Status
+- Published Date
+
+**Order:**
+- Ascending
+- Descending
+
+### Export Projects
+
+Export all project data to CSV format for easy analysis and record-keeping.
+
+<img src="/assets/export-projects-csv.webp" alt="Export Projects to CSV" />
+
+### View on Microsite
+
+Access a direct link to view published projects on your hackathon's public microsite. The **View Projects** button redirects to `https://<hackathon_slug>.devfolio.co/projects`
+
+<img src="/assets/view-projects-microsite.webp" alt="View Projects on Microsite" />
+
+<Callout title="Note" type="warning">
+Only **published** projects are visible on the microsite. Draft projects remain private until the teams publish them.
+</Callout>

content/docs/guide/organizer-dashboard/review-tab.mdx

@@ -1,17 +1,16 @@
 ---
 title: Review Tab
-description: The Overview Tab helps you accept, reject, or waitlist applications as per your hackathon guideline.
+description: The Review Tab helps you accept, reject, or waitlist applications as per your hackathon guideline.
 ---
 
 import { Tabs, Tab } from "fumadocs-ui/components/tabs";
 
 <Tabs items={["Online Mode", "Offline and Online with Application Review Mode"]}>
   <Tab value="Online Mode">
-    <p>
-      In <code>Online</code> mode, you can see a list of hackers with their respective status. You can filter out the list by Country or City depending on the nature of your request.
-    </p>
+    In <code>Online</code> mode, you can see a list of hackers with their respective status. You can filter out the list by Country or City depending on the nature of your request.
 
-    <p>The <strong>status of the applicant</strong> can be:</p>
+    The <strong>status of the applicant</strong> can be:
+    
     <ul>
       <li><code>Profile Submitted</code>: They have only applied to your hackathon</li>
       <li><code>Project Submitted</code>: They have applied as well as submitted their project to your hackathon</li>
@@ -22,9 +21,7 @@ import { Tabs, Tab } from "fumadocs-ui/components/tabs";
   </Tab>
 
   <Tab value="Offline and Online with Application Review Mode">
-    <p>
-      Here, you can review individual and team profiles to extend invitations to them to attend your hackathon (accept), decline their application (reject), or waitlist (apply/reject later) them. You can apply various filters to help you in the process.
-    </p>
+    Here, you can review individual and team profiles to extend invitations to them to attend your hackathon (accept), decline their application (reject), or waitlist (apply/reject later) them. You can apply various filters to help you in the process.
 
     <img src="/assets/image (275).webp" alt="Offline/Review mode view" />
     <p align="center"><i>Review Tab – Application Review Mode</i></p>
@@ -61,6 +58,37 @@ import { Tabs, Tab } from "fumadocs-ui/components/tabs";
 <img src="/assets/image (269).webp" alt="Application view" />
 <p align="center"><i>View individual application details</i></p>
 
+---
+
+## Google Sheet Integration
+
+<Callout title="Paid Feature" type="info">
+This feature is available for paid hackathons only.
+</Callout>
+
+### Sync to Google Sheets
+
+Live syncs the hacker application data to your Google Sheet. Data syncs in real-time as new hackers register or update their application, keeping your team always up-to-date with the latest information.
+
+### Access Control
+
+- Only organizers added to the team in the dashboard have **edit access** to the sheet
+- Everyone else with the link can **view** the data
+
+### How to Set Up
+
+1. Click the **Connect Sheet** button in the Review tab
+2. Wait for the status to show **Connected**
+3. Click **Open Sheet** to view your synced application data
+
+<Callout title="Where to Access This Feature" type="info">
+Navigate to `https://org.devfolio.co/<hackathon-slug>/review` to find the Google Sheet Integration options.
+</Callout>
+
+<img src="/assets/google-sheet-integration.webp" alt="Google Sheet Integration - Access at https://org.devfolio.co/<hackathon-slug>/review" />
+<p align="center"><i>Google Sheet Integration setup and access</i></p>
+
+---
 
 ## Steps to Accept a Participant
 

content/docs/guide/organizer-judging.mdx

@@ -43,7 +43,7 @@ Projects are evaluated based on the following criteria:
       <li>
         <strong>Add Judges:</strong>
         <div>
-          Ensure judges are added in the <a href="../organizers/setup/judges.md">speakers and judges</a> tab on the organizer dashboard.
+          Ensure judges are added in the <a href="/docs/guide/setting-up-your-hackathon/lineup-tab">lineup</a> tab on the organizer dashboard.
         </div>
       </li>
       <li>
@@ -88,7 +88,7 @@ Projects are evaluated based on the following criteria:
   <ul className="list-disc pl-4 space-y-4">
     <li>
       <strong>Add Judges:</strong> Ensure judges are added in the{" "}
-      <a href="../organizers/setup/judges.md">speakers and judges</a> tab.
+      <a href="/docs/guide/setting-up-your-hackathon/lineup-tab">lineup</a> tab.
     </li>
     <li>
       <strong>Set Judging Duration:</strong> Set the 'Judging start' and
@@ -118,7 +118,7 @@ Projects are evaluated based on the following criteria:
       <li>
         <strong>Add Judges:</strong>
         <div>
-          Ensure judges are added in the <a href="/docs/guide/setting-up-your-hackathon/judges-tab">speakers and judges</a> tab.
+          Ensure judges are added in the <a href="/docs/guide/setting-up-your-hackathon/lineup-tab">lineup</a> tab.
         </div>
       </li>
       <li>

content/docs/guide/setting-up-your-hackathon/application-tab.mdx

@@ -13,6 +13,12 @@ To help you save time, Devfolio provides you with built-in fields that are commo
   The fields selected here are marked as mandatory! If you want to make them optional, you can proceed to add them as a custom question.
 </Callout>
 
+<Callout title="GitHub OAuth Connect" type="info">
+  Enable GitHub OAuth to allow participants to securely connect their GitHub accounts during the application process. This helps verify repository ownership, automatically fetch relevant profile details, and streamline project submissions.
+
+We recommend enabling this if your hackathon requires a GitHub repository for project submissions
+</Callout>
+
 Here's how it will look when the hacker fills out the application for your hackathon.
 
 <img src="/assets/image (64).webp" alt="Hacker Application View" />

content/docs/guide/setting-up-your-hackathon/index.mdx

@@ -31,8 +31,8 @@ description:  A step-by-step guide to configuring every aspect of your hackathon
     href="/docs/guide/setting-up-your-hackathon/prizes-tab"
   />
   <Card
-    title="🧑‍⚖️ Judges Tab"
-    href="/docs/guide/setting-up-your-hackathon/judges-tab"
+    title="🎤 Lineup Tab"
+    href="/docs/guide/setting-up-your-hackathon/lineup-tab"
   />
   <Card
     title="🤝 Partner Tab"