Skip to content

2. The dashboard ​

What needs attention, across all the projects, in one table:

console
$ fobis ecosystem dashboard --no-ci
Project  Branch  Tree   Upstream  Version / tag    Unreleased           CI       Drift  Pins
-------  ------  -----  --------  ---------------  -------------------  -------  -----  -----------------------
core     master  clean  in sync   v1.0.0 / v1.0.0  1 (minor -> v1.1.0)  unknown  0      -
mathx    master  clean  in sync   v1.0.0 / v1.0.0  1, none to release   unknown  0      core stale
app      master  clean  in sync   v1.0.0 / v1.0.0  0                    unknown  0      mathx stale, core stale
ColumnSays
Treeuncommitted changes
Upstreamcommits not pushed, or not pulled
Version / tagthe project's version (its VERSION file, else a literal fobos [project] version), and the latest tag
Unreleasedcommits since the tag, and the release they call for, from their Conventional Commits types: core has a feat (a minor bump); mathx only a docs commit, which releases nothing
CIthe GitHub Actions result at HEAD (--no-ci skips the query, as here: the demo is not on GitHub)
Driftboilerplate files that differ from FoBiS's templates (chapter 5)
Pinsthe dependencies whose locked commit is behind the dependency's head: mathx and app still build against the core of their last fetch

The same facts for a script, --json (one object per project):

console
$ fobis ecosystem dashboard --no-ci --json | head -40
{
  "generated": "2026-10-14T07:40:20",
  "projects": [
    {
      "name": "core",
      "path": "~/eco/core",
      "slug": "",
      "branch": "master",
      "head": "c3b0b47c7baf7e9829850d56422b49edb28c04c7",
      "dirty": 0,
      "ahead": 0,
      "behind": 0,
      "fetched": true,
      "version": "v1.0.0",
      "tag": "v1.0.0",
      "unreleased": 1,
      "releasable": 1,
      "bump": "minor",
      "next_version": "v1.1.0",
      "pushed": true,
      "ci": "unknown",
      "drift": 0,
      "pins": [],
      "errors": [],
      "state": "unreleased"
    },
    {
      "name": "mathx",
      "path": "~/eco/mathx",
      "slug": "",
      "branch": "master",
      "head": "fae4cf37304e82904e1bb9f6a09fea5b2f46ff9f",
      "dirty": 0,
      "ahead": 0,
      "behind": 0,
      "fetched": true,
      "version": "v1.0.0",
      "tag": "v1.0.0",
      "unreleased": 1,
      "releasable": 0,

and as a web page with the dependency graph, --format html (opened in the browser without --no-open):

console
$ fobis ecosystem dashboard --no-ci --format html --no-open -o dashboard.html && ls -s --block-size=K dashboard.html
Dashboard written to ~/eco/dashboard.html
16K dashboard.html

the HTML dashboard

fobis ecosystem graph and dashboard

The demo ecosystem of this track: core, mathx, app.

What you learned

fobis ecosystem dashboard, terminal, JSON and HTML; what each column means. The HTML themes and colours are in the ecosystem guide.

Next: 3. Acting on every project.