Ideathon 2025 - AI-Powered Project Starter Kit

Welcome to the Ideathon 2025 starter repository! This kit is designed specifically for 1st-year students to help you turn your innovative ideas into real-world full-stack applications using the power of Artificial Intelligence and Google Technologies.

Even if you have little to no coding experience, this repository provides the structure and instructions to let an AI assistant (like Gemini) write the code for you. Your job is to come up with a great idea and guide the AI!

📂 Repository Structure

• submission/: Contains the idea-submission-form.md. This is where you describe your project idea.
• ai-instructions/: Contains specific guides for Google technologies (Firebase, Maps, Gemini, etc.) and the master prompt for the AI.
• project/: This is where your actual application code will be generated by the AI.

🛠️ How to Use This Kit

Follow these simple steps to build your project:

Step 1: Define Your Idea

1. Navigate to the submission/ folder.
2. Open idea-submission-form.md.
3. Fill in your Team Details, Problem Statement, and Project Idea.
4. Choose a Google Technology you want to use (e.g., Google Maps, Firebase, Gemini AI).

Step 2: Choose Your Technology

1. Go to the ai-instructions/ folder.
2. Find the markdown file that matches your chosen technology (e.g., firebase.md, google-maps.md).
3. If your technology isn't listed, you can use TEMPLATE.md to create a custom guide or just let the AI know what you want to use.

Step 3: Prompt the AI

You will now use an AI coding assistant (like Google Gemini, Cursor, Windsurf, or ChatGPT) to build your app.

1. Open your AI chat interface.
2. Copy & Paste the following content into the chat in this order:
   • The content of ai-instructions/prompt.txt (This sets the rules for the AI).
   • The content of your filled-out submission/idea-submission-form.md.
   • The content of the specific technology guide you chose (e.g., ai-instructions/firebase.md).

Example Prompt to AI:

"Here are the instructions for my project. First, read the general AI instructions [Paste prompt.txt content]. Next, here is my project idea [Paste filled idea-submission-form.md]. Finally, here are the requirements for the technology I want to use [Paste firebase.md content]. Please generate the project in the 'project' folder."

Step 4: Build & Run

1. The AI will generate code files inside the project/ folder.
2. Follow the README.md file that the AI generates inside the project/ folder for instructions on how to install dependencies and run your app.
3. You might need to set up API keys (e.g., for Google Maps or Firebase). The AI will tell you how to do this in a .env file.

📚 Available Technology Guides

We have included ready-to-use guides for:

• Firebase (ai-instructions/firebase.md): For databases, authentication, and hosting.
• Google Maps (ai-instructions/google-maps.md): For maps and location services.
• Google Gemini AI (ai-instructions/google-ai-gemini.md): For building chatbots and AI assistants.
• Google Auth (ai-instructions/google-auth.md): For user sign-in/sign-up.

Want to use something else? (e.g., Google Sheets API, YouTube API)? You can create your own guide using ai-instructions/TEMPLATE.md!

🌟 Tips for Success

• Be Specific: The more details you provide in the idea-submission-form.md, the better the AI can build your project.
• Ask Questions: If the AI generates code you don't understand, ask it to explain! (e.g., "How do I run this?" or "What does this file do?").
• Iterate: It's okay if the first version isn't perfect. Ask the AI to make changes (e.g., "Change the background color to blue" or "Add a login page").
• Have Fun! This is your chance to build something amazing.

---

Happy Coding!