How to contribute

Improve one useful fact at a time.

New models and corrections arrive through pull requests. You do not need to rewrite the app to make the catalog better.

  1. 01

    Check the catalog

    Search for an existing entry and open an issue if the proposed change needs discussion.

  2. 02

    Edit models.json

    Add or update one focused entry, including primary sources and an honest verification status.

  3. 03

    Run the checks

    Validate the data, lint the project, typecheck it, run tests, and build the app.

  4. 04

    Open a pull request

    Explain what changed, why it is accurate, and which sources support the claim.

Before your PR

npm install
npm run validate:data
npm run lint
npm run typecheck
npm test
npm run build

Data quality rules

  • Use primary sources whenever possible.
  • Separate hosted-service privacy from local-use privacy.
  • Do not infer quality from popularity or marketing claims.
  • Use needs_review when a claim is uncertain.
  • Update last_verified only after checking sources.