LaunchMate 🚀

AI-Powered Project Setup Assistant for Visual Studio Code

LaunchMate is an intelligent VS Code extension that analyzes your project and provides step-by-step guided setup instructions using Google Gemini AI. Say goodbye to confusing README files and hello to interactive, personalized onboarding!

✨ Features

🤖 AI-Powered Analysis - Uses Google Gemini to intelligently understand your project structure
📋 Step-by-Step Guidance - Interactive webview with clear, actionable setup instructions
🎨 Modern Dark UI - Beautiful, easy-to-navigate interface with smooth animations
🔧 Multi-Stack Support - Works with Node.js, Python, Java, C#, Ruby, PHP, Go, Rust, C/C++ and more
🔐 Secure API Key Management - Your own Gemini API key, securely stored in settings
💡 Smart Detection - Automatically identifies if your project needs setup or is ready to use
⚡ Fast & Efficient - Quick project scanning with minimal overhead

📦 Installation

From VS Code Marketplace (Recommended)

Open VS Code
Click the Extensions icon in the sidebar (or press Ctrl+Shift+X)
Search for "LaunchMate"
Click Install

🚀 Quick Start

Step 1: Get Your Gemini API Key

Visit Google AI Studio
Sign in with your Google account
Click "Create API Key"
Copy the generated key (starts with AIza...)

💡 Note: Gemini API is FREE to use with generous limits!

Step 2: Configure the Extension

Open VS Code
Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac)
Type: "LaunchMate: Set Gemini API Key"
Paste your API key
Press Enter

Alternative: Set via Settings

Go to Settings → Extensions → LaunchMate
Enter your API key in the "Gemini API Key" field

Step 3: Run LaunchMate

Open any project folder in VS Code
Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac)
Type: "Start LaunchMate"
Press Enter
Follow the interactive setup steps!

🛠️ Supported Tech Stacks

Language/Framework	Detected Files	Setup Support
Node.js/JavaScript	`package.json`	✅ npm/yarn install
Python	`requirements.txt`, `setup.py`	✅ pip install
Java	`pom.xml`, `build.gradle`	✅ Maven/Gradle
C#/.NET	`.csproj`, `.sln`	✅ NuGet restore
Ruby	`Gemfile`	✅ Bundle install
PHP	`composer.json`	✅ Composer install
Go	`go.mod`	✅ Go modules
Rust	`Cargo.toml`	✅ Cargo build
C/C++	`CMakeLists.txt`, `Makefile`	✅ Build setup

And many more! The AI adapts to any project structure.

📖 Usage Examples

Example 1: Node.js Project

1. Run: npm install
2. Create .env file with: PORT=3000
3. Run: npm run dev

Example 2: Python Project

1. Create virtual environment: python -m venv venv
2. Activate: source venv/bin/activate (Linux/Mac) or venv\Scripts\activate (Windows)
3. Install dependencies: pip install -r requirements.txt
4. Run: python app.py

Example 3: Ready-to-Use Project

✅ Your project appears to be ready to use! No additional setup steps are required.

⌨️ Commands

Command	Description
`Start LaunchMate`	Launch the project setup wizard
`LaunchMate: Set Gemini API Key`	Configure or update your Gemini API key

⚙️ Configuration

Access settings via: File → Preferences → Settings → Extensions → LaunchMate

Setting	Type	Description	Default
`launchmate.geminiApiKey`	string	Your Google Gemini API key	`""`

🔒 Privacy & Security

✅ Your API key is stored locally in VS Code settings
✅ No API keys are shared or transmitted to third parties
✅ Only project file names and structures are sent to Gemini API
✅ No source code is transmitted unless explicitly in config files
✅ You control your own API key and usage

🐛 Troubleshooting

"LaunchMate requires a Gemini API key"

Solution: Run LaunchMate: Set Gemini API Key command and enter your key.

"Gemini API analysis failed"

Solutions:

Check your internet connection
Verify your API key is valid
Ensure you haven't exceeded Gemini API rate limits

Extension doesn't start