npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

faf-grid

v0.1.0

Published

Inspect any package.json or GitHub repo through the FAF GRID — a debugging UI at mcpaas.live/grid. CLI wrapper that fetches the canonical text view.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

wolfejam.devwolfejam.dev

Keywords

gridpackage.jsondependenciesdepsdebuggingaudittsafafnpmmcpaascli

Readme

faf-grid

FAF GRID

Inspect any package.json through the FAF GRID — a debugging UI at mcpaas.live/grid.

The badge above is faf-grid grading itself. Click it. The format that grades others has to grade itself first.

npx faf-grid react

That prints the canonical grid for react@* straight to your terminal — the same structural debug surface live at mcpaas.live/grid?npm=react, in plain text, parseable.

What does it do?

Two questions, two views, one URL primitive:

| View | Question | What you see | |---|---|---| | Structural (default) | What's declared in package.json? What's missing? | 6 blocks (identity, distribution, scripts, dependencies, engines, signals) of ~33 slots — filled or empty | | TSA (--tsa) | Of what's declared, what's actually used? | Each declared dep classified as CORE / ACTIVE / DORMANT by counting actual imports in source |

Empty cells stay empty. Sparse stays sparse. We print what we see — no padding, no "coming soon."

Usage

# Default — FAF skill grid (the periodic table)
npx faf-grid

# An npm package
npx faf-grid lodash
npx faf-grid @types/node
npx faf-grid request                # deprecated — banner surfaces honestly

# A GitHub repo
npx faf-grid facebook/react
npx faf-grid Wolfe-Jam/faf-cli

# TSA view — declared vs actually used (JS/TS only)
npx faf-grid lodash --tsa
npx faf-grid Wolfe-Jam/faf-cli --tsa

# Open in browser instead of printing
npx faf-grid react --open

Why a CLI for a URL-based tool?

The actual rendering lives at mcpaas.live/grid. This CLI is a thin wrapper that fetches the canonical text view and prints it.

Two surfaces. One source of truth. The URL stays the canonical view (browser-shareable, link-unfurl friendly, embeddable as README badges). The CLI gives you the same data piped into a terminal, into a PR description, into an email — anywhere the URL can't reach.

# Pipe the grid into your PR description
gh pr create --body "$(npx faf-grid react)"

# Watch your repo's TSA view in CI
npx faf-grid Wolfe-Jam/your-repo --tsa

Output format

Plain Markdown. Each block becomes a ## section followed by a slot table:

# 🌐 GRID — [email protected]

**Source:** npm  ·  **Canonical:** https://registry.npmjs.org/react/19.2.5
**Slots:** 33  ·  **Filled:** 11  ·  **Empty:** 22  ·  **Warn:** 1

## identity
| Slot | Value | Filled |
|---|---|---|
| `name` | `react` | ✓ |
| `version` | `19.2.5` | ✓ |
| `license` | `MIT` | ✓ |
| `author` | — |   |
| `funding` | — |   |
...

Format: application/vnd.faf-grid (IANA candidate sister to the registered application/vnd.faf+yaml).

Installation

# One-off (recommended)
npx faf-grid <pkg>

# Or install globally
npm install -g faf-grid
faf-grid react

Embed a badge

Add this to any repo's README to show its grid score live:

[![FAF GRID](https://mcpaas.live/grid/badge?npm=YOUR_PKG)](https://mcpaas.live/grid?npm=YOUR_PKG)

Each click takes the reader to the live grid for your package. The badge updates automatically when the underlying data changes.

License

MIT — see LICENSE.

FAF defines. MD instructs. AI codes.