GitHub Copilot Workshop - NBA Sports Application

Welcome to the comprehensive GitHub Copilot Workshop! This hands-on workshop will teach you to leverage AI-powered development through a real NBA sports application built with Next.js 14 (Frontend) and Python Flask (Backend).

❗Note: No mastery of JavaScript, Python, or Next.js is needed - AI will generate most of the code for you in this exercise. Even if you are not very familiar, it’s a great opportunity to leverage AI to quickly learn popular frameworks.

🎯 Workshop Objectives

By the end of this workshop, you’ll master:

• Core Copilot Features: Chat interactions, completions, and role prompting
• Advanced Workflows: Agent mode, Vision capabilities, and code optimization
• Specialized Integration: MCP servers and automated workflows
• Best Practices: Error handling, testing, and documentation with AI assistance

📋 Prerequisites

Required Software

1. GitHub Copilot License: Active GitHub Copilot license (paid tier, not the free version)
2. IDE Setup: Install and update GitHub Copilot & GitHub Copilot Chat extensions in your IDE
3. Authentication: Login to GitHub Copilot and verify both code completions and chat work
4. Frontend Runtime: Install Node.js & npm. Verify with:

   node -v
   npm -v
   

5. Backend Runtime: Install Python 3.8+ & pip. Verify with:

   python --version
   pip --version
   

Optional for Advanced Features

• Docker (for MCP server tasks)
• GitHub Personal Access Token (for MCP integration)

🚀 Quick Start

This section provides a quick overview. For detailed setup, see Task 0.

1. Clone the repository

   git clone 
   cd GitHubCopilotWorkshop
   

2. Set up the Backend (Python Flask)

   cd backend
   python -m venv venv
   
   # On Windows:
   venv\Scripts\activate
   
   # On macOS/Linux:
   source venv/bin/activate
   
   pip install -r requirements.txt
   python app.py
   

   Backend will run on http://localhost:8080

3. Set up the Frontend (Next.js) - In a new terminal

   # From the root directory
   cd frontend
   npm install
   
   # Create .env.local file with:
   echo "NEXT_PUBLIC_API_URL=http://localhost:8080" > .env.local
   
   npm run dev
   

   Frontend will run on http://localhost:3000

4. Open the application Navigate to http://localhost:3000 in your browser

🏀 Application Overview

GitHub Copilot NBA Companion - Your dedicated NBA companion! This app brings you:

• 📊 Live NBA Results: Real-time game scores and statistics
• 🎯 Player Information: Comprehensive player stats and profiles
• 🏟️ Stadium Information: NBA venues and facility details
• 👨‍🏫 Coach Management: NBA coaches and their achievements