Help #

Publishing a package #

Pub isn't just for using other people's packages. It also allows you to share your packages with the world. If you have a useful project and you want others to be able to use it, use the pub publish command. supports the following search expressions:

Scoring #

NOTE: The Pub scoring model is under development, and is subject to change.

For each package, this site displays an overall score, calculated from scores for the package's popularity, health, and maintenance.

Popularity #

The popularity score—representing how often a package is used—is derived from download statistics. Although this score is based on actual download counts, it compensates for automated tools such as continuous builds that fetch the package on each change request.

How can you improve your popularity score?

Create useful packages that others need and love to use.

Health #

The health score is based on static analysis of the package with dartanalyzer:

(*) Percents are applied with cumulative multiplication. For example: 2 errors and 1 warning will get a score of 53, because: (0.75^2 * 0.95 = 0.534375).

How can you improve your health score?

Run dartanalyzer (or flutter analyze in case of Flutter), and fix the items it returns (especially errors and warnings, hints barely decrease the health score).

Use analysis_options.yaml to specify further linter rules, enable default rules Google uses, and make sure you fix all warnings and errors before publishing. Here's an example analysis_options.yaml:

# Defines a default set of lint rules enforced for
# projects at Google. For details and rationale,
# see
include: package:pedantic/analysis_options.yaml

# For lint rules and documentation, see
# Uncomment to specify additional rules.
# linter:
#   rules:
#     - camel_case_types

# analyzer:
#   exclude:
#     - path/to/excluded/files/**

Maintenance #

The maintenance score reflects how tidy and up-to-date a package is. A package starts with 100 points, which is then then subtracted deductions based on a long list of detailed checks. In summary, the main components that influence this score are:

How can you improve your maintenance score?

Click your package's overall score to see the Analysis page, which has suggestions for improving the package's score. Fix them, and release at least one new version every year to keep your maintenance score up.

Pub site uses pana to create maintenance suggestions. To get suggestions before publishing, run pana locally (using --source path), or validate your package against the list of checks manually.

Overall score #

The overall score is a weighted average of the individual scores:

You can find the overall score either near the top of the package's page or to the right of your package in any listing on this site.

Ranking #

Default listings use composite scoring to sort packages. The score is based on the overall score, and if applicable, the platform specificity and the text match score is also factored in.

Each package's overall score is visible at the side of the results, regardless of the sort order.