Are we modules yet? Not even close, lol.

This website tracks C++20 modules support across popular libraries. Completed (✅) projects are kept first. Within each status group, projects with GitHub data are ranked by stars, followed by projects using vcpkg port revision counts as fallback, then projects with neither metric in their original order. Users can switch to vcpkg-first sorting, which reverses the primary and fallback metrics while retaining the status-first rule.

How Projects Are Counted

Total C++ Projects:

  vcpkg packages (baseline)
- Excluded C libraries (pure C, can't use modules)
+ External projects (notable C++ projects not in vcpkg)
= Total C++ projects tracked

Completed Projects (with modules support):

  vcpkg packages with ✅ status (from vcpkg_overrides.yml)
+ External projects with ✅ status (from external_projects.yml)
= Total completed

Note: Only packages that exist in vcpkg can be overridden via vcpkg_overrides.yml. Projects not in vcpkg must be added to external_projects.yml.

Data Files

Auto-generated (data/generated/ - DO NOT EDIT):

• vcpkg_packages.yml - Generated from vcpkg repository
• github_stars.yml - Cached star counts for GitHub repositories

Manual (data/):

• vcpkg_overrides.yml - Override vcpkg package metadata (must exist in vcpkg)
• external_projects.yml - Projects not in vcpkg
• excluded_c_libraries.yml - C libraries to exclude from tracking

Output (data/):

• progress.yml - Merged result displayed on website

YAML Fields

Example entry in vcpkg_overrides.yml:

ports:
- name: fmt
  import_statement: fmt              # Module import name (e.g., `import fmt;`)
  modules_support_date: 2022-10-11   # Date modules added (ISO 8601: YYYY-MM-DD)
  status: ✅
  current_min_cpp_version: 11
  tracking_issue: "https://github.com/fmtlib/fmt/pull/3134"

Note: Most projects don't have a modules tracking issue. If one doesn't exist, please create one so we can track it here.

Status Legend

• ❔ Unknown - Help wanted!
• ✅ Full support
• ⚙️ Work in progress
• ⚠️ Issue reported
• ❌ No support planned

Dependencies

1. Hugo Extended
   • 🪟 winget install Hugo.Hugo.Extended
   • 🐧🍏 GitHub releases
2. Python 3 via uv
   • 🪟 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   • 🐧🍏 curl -LsSf https://astral.sh/uv/install.sh | sh

Contributing

Edit vcpkg package status: data/vcpkg_overrides.yml
Add external projects: data/external_projects.yml

Generate merged data:

uv run tools/generate_github_stars.py
uv run tools/merge_vcpkg_package_list_progress.py
uv run tools/compute_completion_status.py
hugo serve  # Preview changes

The star generator uses GitHub GraphQL when GITHUB_TOKEN or GH_TOKEN is set. Without a token it uses the public ecosyste.ms repository metadata service, follows GitHub repository redirects, and uses the public GitHub REST API only for live repositories missing from the mirror. Repositories are detected from GitHub homepages and tracking issues; set github_repository: owner/repository in an override or external-project entry when neither points to the canonical repository.

To retry only repositories that are still missing from an existing cache, run uv run tools/generate_github_stars.py --only-missing.

Regenerate vcpkg data (optional):

uv run tools/generate_vcpkg_package_list.py

Project Structure

data/
├── vcpkg_overrides.yml       # Manual: vcpkg package overrides
├── external_projects.yml     # Manual: non-vcpkg projects
├── excluded_c_libraries.yml  # Manual: C libraries to exclude
├── progress.yml              # Output: merged result for website
└── generated/
    ├── vcpkg_packages.yml    # Auto-generated from vcpkg (DO NOT EDIT)
    └── github_stars.yml      # Auto-generated GitHub star cache
tools/
├── generate_vcpkg_package_list.py      # Fetches vcpkg data
├── generate_github_stars.py            # Fetches GitHub star counts
├── merge_vcpkg_package_list_progress.py # Merges all data → progress.yml
└── compute_completion_status.py        # Generates historical stats
layouts/partials/
├── progress-table.html       # Table component
├── progress-plot.html        # Chart component
└── home-content.html         # Home page content
content/
├── tools.md
├── documents.md
└── examples.md