Baseline-Checker

• 

  Folder Structire

• 

  Installation

• 

  Usage

• 

• 

  PDF REPORT

• 

  PDF report 2

💡 Inspiration

Modern web development moves at lightning speed ⚡. Keeping track of which features are widely supported across browsers is tedious and time-consuming. We wanted a tool that automatically identifies outdated or non-baseline web features, so developers can focus on writing modern, future-proof code without guesswork.

🛠️ What it does

Baseline Checker is a Python CLI tool that scans your web project directories, detects legacy or experimental web features, and generates professional reports in multiple formats: JSON, CSV, DOCX, and PDF.

It: ✅ Highlights baseline vs. non-baseline usage ✅ Helps developers adopt modern standards confidently ✅ Provides reports that are developer-friendly and stakeholder-ready

🔧 How we built it

Language & Tools → Python 3.8+, Rich, tqdm, pandas, python-docx, ReportLab, fpdf

Structure → CLI-based tool with a modular scanning engine + multi-format report generator

Scanning Logic → Recursively parses project files, skips irrelevant dirs (like node_modules), and matches features against a curated baseline dataset (JSON)

Reporting → Creates clean, professional reports for developers, managers, and teams

🚧 Challenges we ran into

Efficiently scanning large projects without slowing down ⚡

Handling file permission issues and inaccessible folders gracefully 🛡️

Packaging the tool as both a CLI and a distributable PyPI package 📦

Ensuring accurate detection of frontend frameworks + feature usage 🎯

🏆 Accomplishments that we’re proud of

✅ Fully automated baseline scanning for web projects

✅ Multi-format reporting (JSON, CSV, DOCX, PDF)

✅ Robust CLI with progress bars + rich colored output

✅ Graceful handling of errors & partial report generation even on interruptions

📚 What we learned

Designing a scalable CLI tool for large codebases 🏗️

Integrating Python packages for reporting + visualization 📊

Best practices for PyPI packaging + distribution 🚀

Real-world handling of file I/O, logging, and exceptions 📝

🚀 What’s next for Baseline Checker

🔍 Add detection for more frontend frameworks & libraries

📊 Build an interactive web dashboard for visual scan results

⚡ Optimize performance for extremely large projects

💡 Add automated recommendations for replacing non-baseline features

✨ With Baseline Checker, developers save time ⏳, reduce errors ❌, and confidently adopt the latest web standards 🌍.

🕒 Project Timeline Clarification

While the core idea and some early experimentation for Baseline Checker existed prior to August 7, 2025, the current version submitted for the #WhatsMyBaseline campaign was newly developed and significantly expanded after August 7, 2025. Between August and October 2025, we:

Rebuilt the project architecture into a fully modular CLI

Added multi-format reporting (JSON, CSV, DOCX, PDF)

Integrated Rich, tqdm, pandas, and ReportLab for better UI and reporting

Created a curated baseline dataset (JSON) for feature detection

Packaged the tool for PyPI distributionv

This submission represents a new, enhanced, and production-ready version created specifically for the #WhatsMyBaseline campaign.

Built With

• colorama
• fpdf
• pandas
• python
• python-package-index
• web-features-json-data