L'Amigo is a browser extension engineered for competitive programmers and software engineering candidates to monitor peer performance and automate personal progress management. By integrating directly into LeetCode, Codeforces, and CodeChef environments, L'Amigo enables users to track friend activity, perform detailed statistical comparisons, and maintain an automated repository of their own solved problems on GitHub.

The extension utilizes a MutationObserver to modify both LeetCode and Codeforces Document Object Models (DOM) in real-time, providing immediate access to peer tracking tools.

• Dynamic Action Buttons: Injects "Track with L'Amigo" and "Compare with Me" utilities directly into LeetCode user profiles.
• CF College Standings Tab: Injects a custom "COLLEGE STANDINGS" tab into Codeforces standings (/contest/*/standings) showing team links, points, penalties, and member matches.
• Organization Bookmarking Controls: Adds bookmark buttons on organization rankings (/ratings/organization/*) and profiles to scrape and sync members in local storage.
• CF Profile Shortcuts: Injects quick-add + tracker buttons next to user handles across rankings, standings, and comments pages for direct identity pairing.
• Rating-based Heatmap toggle: Injects a toggle checkbox inside Codeforces profile activity graph headers (._UserActivityFrame_header) to recolor graph squares based on difficulty.

The extension popup serves as a centralized interface for monitoring your tracked friends.

• Individual Performance Cards: Provides a granular view of total solved problems, difficulty breakdowns (Easy, Medium, Hard), and current activity streaks.
• Visual Pattern Analysis: Uses Recharts to render SVG-based distribution charts, helping users identify their peers' solving habits.
• Submission History: Extracts and displays the five most recent accepted problems for each tracked friend, including direct links to problem statements.
• Problem Recommendations Engine: Curates and suggests the most popular problems your friends are solving. Includes deep filtering by platform (LeetCode/Codeforces), difficulty, and Codeforces rating ranges.
• Global Activity Feed: A unified, chronological timeline of all recent problem solves across platforms, eliminating the need to check individual profiles.

The extension popup features a massive full-page dashboard interface (accessible via the Layout icon) for deep insights into your group's performance.

• Leaderboard Tab: Ranks your friends using three distinct modes: Power Score (combining peak normalized rating & difficulty-weighted solves), Peak Mastery (cross-platform rating normalization), and Total Solved.
• Sheets Tracker: Curated selection of 50+ problem sheets (Striver A2Z, CP-31, NeetCode, CSES) tightly integrated with LeetCode/Codeforces API to automatically check off completed problems. Includes friend avatar clusters showing who solved each problem.
• Contest Hub: A dense, brutalist chronological list view of upcoming live contests across LeetCode, Codeforces, and CodeChef. Includes 1-click Google Calendar integration and Chrome alarm reminders.
• Rating History & Analytics: Multi-platform rating trajectory charts for any tracked friend, along with a granular Contest Performance Log detailing rating deltas, win rates, and recent battle history.

The extension features a fully-functional Monaco-based code editor integrated directly into the dashboard.

• Multi-Language Compiler: Write, compile, and execute code in C++, Python, Java, and JavaScript.
• Remote Execution Engine: Integrates with the Wandbox compiler API for blazing-fast remote code execution without a local backend.
• Developer Experience: Includes features like syntax highlighting, code folding, dark/light themes, and custom font sizing (powered by the same engine as VS Code).

L'Amigo natively supports concurrent tracking across three major competitive programming platforms:

• LeetCode: GraphQL pipelines with advanced submission verdict tracking (Accepted, WA, TLE) via leetcode-monitor.ts.
• Codeforces: Direct REST API integration for global ratings, ranks, and live verdicts via codeforces.ts.
• CodeChef: Real-time extraction of global ratings, divisions, and solved problem counts via codechef.ts.

The Comparison module allows users to perform deep-dive analytics by selecting multiple friends for side-by-side evaluation.

• Topic Proficiency: Analyzes public solve data to identify a user's top five mastered topics (e.g., Dynamic Programming, Graph Theory) with detailed breakdown tables.
• Competitiveness Index: Compares Contest Ratings, Global Rankings, and Programming Languages in a unified grid.
• Interactive Metrics: Highlights highest performers across different statistical categories and visualizes shared solve overlaps using a dynamic heatmap grid.

L'Amigo automates the preservation of the user's solved problem library by synchronizing accepted submissions with a dedicated GitHub repository.

• Incremental Sync Algorithm: The service worker implements a state-check mechanism that compares local submission records with the remote repository tree to ensure only new or modified solutions are pushed, minimizing API traffic and avoiding rate-limiting.
• Static File Generation: Solutions are converted from raw submission data into structured source files with appropriate naming conventions and file extensions based on the runtime environment (e.g., .cpp, .py, .go).
• Flexible Authentication Support: Supports both Personal Access Tokens (PATs) stored exclusively in local browser storage and GitHub Device Flow OAuth Authentication (Verification Link + User Code authorization) for secure, seamless onboarding.

• Framework: React 18 (Functional Components, Hooks)
• Programming Language: TypeScript (Strict Mode)
• Data Visualization: Recharts (SVG)
• Bundler: Webpack 5 with Hot Module Replacement (HMR) capabilities
• Storage System: Chrome Storage Local API (Asynchronous)
• Style Engine: Vanilla CSS with CSS Variables for dynamic Dark Mode implementation.
• API Interfaces: LeetCode GraphQL, Codeforces REST, CodeChef Scraper, GitHub REST API v3

1. Ingestion: Data is fetched client-side directly from LeetCode servers via secure GraphQL queries.
2. Processing: Raw JSON responses are transformed into normalized Friend Objects within the extension's service layer.
3. Persistence: Objects are serialized and stored in chrome.storage.local.
4. Synchronization: Solutions are pushed via encrypted HTTPS requests to api.github.com.
5. Security: All credentials (GitHub PATs) are obfuscated within local storage. No telemetry or analytics data is ever transmitted to any third-party infrastructure.

The easiest way to install L'Amigo is directly from the Chrome Web Store:

1. Click the badge above or visit the Chrome Web Store page
2. Click "Add to Chrome"
3. Confirm the installation when prompted
4. The L'Amigo icon will appear in your browser toolbar

This method is recommended for users who wish to utilize L'Amigo without maintaining a local development environment.

1. Navigate to the official L'Amigo GitHub repository and access the Releases section.
2. Download the distribution package: lamigo-v1.6.3.zip.
3. Extract the ZIP archive contents to a persistent local directory.
4. Open the Google Chrome browser and navigate to chrome://extensions/.
5. Activate Developer mode using the toggle in the upper-right corner.
6. Click the Load unpacked button and select the directory containing the extracted release files.

Use this method if you intend to contribute to the codebase or utilize the most recent unreleased features.

1. Clone the repository and navigate to the project root:

   git clone https://github.com/FTS18/l-amigo.git
   cd l-amigo

2. Install the required dependencies:

   npm install

3. Generate the production distribution using the build pipeline:

   npm run build

4. Open chrome://extensions/ in the browser and ensure Developer mode is active.
5. Click Load unpacked and choose the dist/ directory generated in the previous step.

The codebase is structured into specialized modules to facilitate development scalability:

• src/content: Logic for LeetCode/Codeforces DOM manipulation, submission monitoring, and page styling injections.
• src/background: Service worker for periodic data synchronization, alarm management, and auto-reload integrations.
• src/popup: React-based architecture for the main user dashboard, compare stats modal, onboarding flow, and configuration settings.
• src/services: Abstraction layer for API communications (LeetCode, Codeforces, CodeChef, GitHub) and internal data storage management.
• website: Source for the product landing page and promotional assets.

For more detailed information, please refer to:

• Contributing Guidelines
• Changelog
• Privacy Policy

L'Amigo includes built-in keyboard shortcuts for power users:

• Collaborative Communities: Implementation of optional peer-to-peer data sharing for private community leaderboards.
• Advanced Submission Filter: Capability to filter peer submissions by programming language or specific timeframes.
• Custom Rating Milestones: Set up custom notifications when tracked friends cross major rating tiers (e.g., Expert, Master) on Codeforces.

L'Amigo is licensed under the MIT License. Commercial use, modification, and distribution are permitted provided that the original copyright and license notice are included in all copies or substantial portions of the software.