# TypeCellOS/BlockNote — health index 81/100 (Good)

> Inspection of the public repository TypeCellOS/BlockNote by inspect.software. It holds a health index of 81 out of 100, placing it in the Good band. The index is a signal derived from publicly visible practice, not a warranty, a security audit, or an endorsement, and it is independent of payment.

- Repository: https://github.com/TypeCellOS/BlockNote
- Report page: https://inspect.software/software/TypeCellOS/BlockNote
- Full JSON report: https://inspect.software/api/repositories/TypeCellOS/BlockNote/report
- Badge: https://raw.githubusercontent.com/inspect-software/badges/main/v1/t/TypeCellOS/BlockNote.svg
- Inspected: 2026-07-27
- Methodology: metrics 1.13.0, report schema 0.27.0 (https://inspect.software/methodology.md)

## Category summary

| Category | Weight | Index | Band |
|---|---|---|---|
| Vitality | 22% | 99/100 | Excellent |
| Community & Adoption | 18% | 87/100 | Excellent |
| Sustainability & Governance | 24% | 72/100 | Good |
| Engineering Quality | 20% | 80/100 | Good |
| Security | 16% | 64/100 | Moderate |
| AI Readiness | not counted | 74/100 | Good |

## Repository facts

| Field | Value |
|---|---|
| Description | A React Rich Text Editor that's block-based (Notion style) and extensible. Built on top of Prosemirror and Tiptap. |
| Homepage | https://www.blocknotejs.org/ |
| Primary language | TypeScript |
| Stars | 10,015 |
| Forks | 758 |
| Created | 2022-03-02 |
| Last push | 2026-07-26 |
| Latest release | v0.52.1 |
| Commits (last year) | 583 |
| Bus factor | 2 |
| Topics | block-based, editor, javascript, notion, prosemirror, react, rich-text-editor, tiptap, typescript, wysiwyg, yjs, notion-editor |

## Published packages

| Registry | Package | Latest | Monthly downloads |
|---|---|---|---|
| npm | @blocknote/core | 0.52.1 | 1,719,015 |
| npm | @blocknote/react | 0.52.1 | 1,666,410 |
| npm | @blocknote/xl-ai | 0.52.1 | 52,870 |
| npm | @blocknote/shadcn | 0.52.1 | 472,319 |
| npm | @blocknote/ariakit | 0.52.1 | 75,145 |
| npm | @blocknote/mantine | 0.52.1 | 1,125,311 |
| npm | @blocknote/code-block | 0.52.1 | 79,782 |
| npm | @blocknote/server-util | 0.52.1 | 303,787 |

## Vitality — 99/100 (Excellent)

Is the project alive — is code being written and are releases shipping? Weight: 22% of the overall index.

### Development activity — 98/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Push recency | met | 36 / 36 | last push 0 days ago |
| Commit cadence | partial | 33.9 / 36 | 49/52 weeks with commits |
| Commit volume | met | 18 / 18 | 583 commits in the last year |
| OpenSSF Scorecard: Maintained | met | 10 / 10 | 30 commit(s) and 11 issue activity found in the last 90 days -- score normalized to 10 |

### Release discipline — 100/100 (Excellent)

Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ships releases | met | 27 / 27 | 100 releases published |
| Release recency | met | 36 / 36 | latest release 6 days ago |
| Release cadence | met | 27 / 27 | a release every ~10.5 days |
| OpenSSF Scorecard: Signed-Releases | excluded | 0 / 10 | no releases found |

### Abandonment — 100/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Project is still maintained | met | 100 / 100 | last human commit 6 days ago |

## Community & Adoption — 87/100 (Excellent)

Does the project have users, downloads, attention, and a welcoming setup for contributors? Weight: 18% of the overall index.

### Popularity & adoption — 93/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Stars | met | 60 / 60 | 10,015 stars |
| Forks | partial | 24 / 25 | 758 forks |
| Watchers | partial | 9 / 15 | 43 watchers |

### Community health — 71/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 22.5 / 22.5 | — |
| License | partial | 16.9 / 22.5 | license file present, not a recognized license |
| CONTRIBUTING guide | met | 18 / 18 | — |
| Code of conduct | not met | 0 / 13.5 | — |
| Issue template | not met | 0 / 7.2 | — |
| PR template | met | 6.3 / 6.3 | — |

### Ecosystem adoption (downloads) — 100/100 (Excellent)

Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Monthly downloads | met | 80 / 80 | 5,494,639 downloads/month across npm |
| Registry dependents | excluded | 0 / 20 | not reported by this ecosystem |

## Sustainability & Governance — 72/100 (Good)

Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep? Weight: 24% of the overall index.

### Maintainer resilience (bus factor) — 64/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Bus factor | partial | 25.2 / 54 | 2 contributor(s) cover half of all commits |
| Commit distribution | partial | 15.7 / 22.5 | top contributor authored 30% of commits |
| Contributor breadth | met | 13.5 / 13.5 | 98 contributors |
| OpenSSF Scorecard: Contributors | met | 10 / 10 | project has 6 contributing companies or organizations |

### Issue & PR responsiveness — 76/100 (Good)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Issue resolution | partial | 42.6 / 46.8 | 91% of issues closed |
| PR acceptance | partial | 30.7 / 38.2 | 1097/1367 decided PRs merged |
| OpenSSF Scorecard: Code-Review | partial | 3 / 15 | Found 6/21 approved changesets -- score normalized to 2 |

### Ownership & stewardship — 57/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Ownership backing | met | 30 / 30 | organization-owned |
| Verified domain | not met | 0 / 20 | — |
| Owner reach | partial | 14.5 / 25 | 102 followers of TypeCellOS |
| Track record | partial | 12.5 / 25 | 5 public repos, account ~3 yr old |

### Package maintenance — 100/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Published & resolvable | met | 25 / 25 | 8 package(s) on npm |
| Publish recency | met | 35 / 35 | latest publish 6 days ago |
| Version history | met | 20 / 20 | 157 published versions |
| Not deprecated | met | 20 / 20 | active, not deprecated or yanked |

## Engineering Quality — 80/100 (Good)

Are baseline engineering and documentation practices in place? Weight: 20% of the overall index.

### Engineering practices — 66/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| CI workflows | met | 24 / 24 | 6 workflow(s) |
| Tests present | met | 24 / 24 | — |
| Linter config | not met | 0 / 16 | — |
| Pre-commit hooks | not met | 0 / 9.6 | — |
| .editorconfig | not met | 0 / 6.4 | — |
| OpenSSF Scorecard: CI-Tests | partial | 18 / 20 | 12 out of 13 merged PRs checked by a CI test -- score normalized to 9 |

### Documentation — 100/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| README | met | 30 / 30 | — |
| Documentation directory | met | 25 / 25 | — |
| Documentation / homepage site | met | 15 / 15 | https://www.blocknotejs.org/ |
| Repository description | met | 10 / 10 | — |
| Topics | met | 10 / 10 | 12 topics |
| Wiki | met | 10 / 10 | — |

## Security — 64/100 (Moderate)

Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure? Weight: 16% of the overall index.

### Security posture — 55/100 (Moderate)

Excluded from scoring (no data or not applicable): Packaging, Signed-Releases. Remaining weights renormalized.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Binary-Artifacts | met | 7.5 / 7.5 | no binaries found in the repo |
| Branch-Protection | partial | 2.2 / 7.5 | branch protection is not maximal on development and all release branches |
| CI-Tests | partial | 2.2 / 2.5 | 12 out of 13 merged PRs checked by a CI test -- score normalized to 9 |
| CII-Best-Practices | not met | 0 / 2.5 | no effort to earn an OpenSSF best practices badge detected |
| Code-Review | partial | 1.5 / 7.5 | Found 6/21 approved changesets -- score normalized to 2 |
| Contributors | met | 2.5 / 2.5 | project has 6 contributing companies or organizations |
| Dangerous-Workflow | met | 10 / 10 | no dangerous workflow patterns detected |
| Dependency-Update-Tool | met | 7.5 / 7.5 | update tool detected |
| Fuzzing | not met | 0 / 5 | project is not fuzzed |
| License | partial | 2.2 / 2.5 | license file detected |
| Maintained | met | 7.5 / 7.5 | 30 commit(s) and 11 issue activity found in the last 90 days -- score normalized to 10 |
| Packaging | excluded | 0 / 5 | packaging workflow not detected |
| Pinned-Dependencies | partial | 4 / 5 | dependency not pinned by hash detected -- score normalized to 8 |
| SAST | partial | 4 / 5 | SAST tool is not run on all commits -- score normalized to 8 |
| Security-Policy | not met | 0 / 5 | security policy file not detected |
| Signed-Releases | excluded | 0 / 7.5 | no releases found |
| Token-Permissions | not met | 0 / 7.5 | detected GitHub workflow tokens with excessive permissions |
| Vulnerabilities | not met | 0 / 7.5 | 125 existing vulnerabilities detected |

### Dependency advisories — 100/100 (Excellent)

Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the npm:@blocknote/core@0.52.1 runtime dependency closure — what installing the published package pulls in — 36 packages. Reachability is not analyzed.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Direct dependencies free of known advisories | met | 35 / 35 | no direct dependency carries a known advisory |
| Indirect dependencies free of known advisories | met | 25 / 25 | no indirect dependency carries a known advisory |
| No advisories left outstanding | excluded | 0 / 40 | no advisory carries a publication date |

### Malicious dependencies — 100/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| No dependency reported as a malicious package | met | 100 / 100 | no dependency is reported as a malicious package |

### High-Risk Jurisdiction Exposure — 100/100 (Excellent)

Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Policy exposure multiplier | met | 100 / 100 | no confirmed policy-scope location match |

## AI Readiness — 74/100 (Good)

How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score.

### Agent context & guidance — 85/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Agent instructions | met | 45 / 45 | AGENTS.md, CLAUDE.md |
| Machine-readable docs (llms.txt) | not met | 0 / 15 | — |
| Legible commit history | met | 40 / 40 | 94 of 97 human commits state their intent (structured subject or explanatory body) |

### Verify loop (build / test / typecheck) — 69/100 (Moderate)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| One-command bootstrap | not met | 0 / 18 | — |
| Automated tests | met | 22 / 22 | — |
| Lint / format config | not met | 0 / 11 | — |
| Static type checking | met | 11 / 11 | docs/tsconfig.json, examples/01-basic/01-minimal/tsconfig.json, examples/01-basic/02-block-objects/tsconfig.json, examples/01-basic/03-multi-column/tsconfig.json, examples/01-basic/04-default-blocks/tsconfig.json, examples/01-basic/05-removing-default-blocks/tsconfig.json, examples/01-basic/06-block-manipulation/tsconfig.json, examples/01-basic/07-selection-blocks/tsconfig.json, examples/01-basic/08-ariakit/tsconfig.json, examples/01-basic/09-shadcn/tsconfig.json, examples/01-basic/10-localization/tsconfig.json, examples/01-basic/11-custom-placeholder/tsconfig.json, examples/01-basic/12-multi-editor/tsconfig.json, examples/01-basic/13-custom-paste-handler/tsconfig.json, examples/01-basic/14-editor-scrollable/tsconfig.json, examples/01-basic/15-shadowdom/tsconfig.json, examples/01-basic/16-read-only-editor/tsconfig.json, examples/01-basic/17-no-trailing-block/tsconfig.json, examples/01-basic/testing/tsconfig.json, examples/02-backend/01-file-uploading/tsconfig.json, examples/02-backend/02-saving-loading/tsconfig.json, examples/02-backend/03-s3/tsconfig.json, examples/02-backend/04-rendering-static-documents/tsconfig.json, examples/03-ui-components/01-ui-elements-remove/tsconfig.json, examples/03-ui-components/02-formatting-toolbar-buttons/tsconfig.json, examples/03-ui-components/03-formatting-toolbar-block-type-items/tsconfig.json, examples/03-ui-components/04-side-menu-buttons/tsconfig.json, examples/03-ui-components/05-side-menu-drag-handle-items/tsconfig.json, examples/03-ui-components/06-suggestion-menus-slash-menu-items/tsconfig.json, examples/03-ui-components/07-suggestion-menus-slash-menu-component/tsconfig.json, examples/03-ui-components/08-suggestion-menus-emoji-picker-columns/tsconfig.json, examples/03-ui-components/09-suggestion-menus-emoji-picker-component/tsconfig.json, examples/03-ui-components/10-suggestion-menus-grid-mentions/tsconfig.json, examples/03-ui-components/11-uppy-file-panel/tsconfig.json, examples/03-ui-components/12-static-formatting-toolbar/tsconfig.json, examples/03-ui-components/13-custom-ui/tsconfig.json, examples/03-ui-components/14-experimental-mobile-formatting-toolbar/tsconfig.json, examples/03-ui-components/15-advanced-tables/tsconfig.json, examples/03-ui-components/16-link-toolbar-buttons/tsconfig.json, examples/03-ui-components/17-advanced-tables-2/tsconfig.json, examples/03-ui-components/18-drag-n-drop/tsconfig.json, examples/03-ui-components/19-suggestion-menus-grouping-ordering/tsconfig.json, examples/03-ui-components/20-portal-elements/tsconfig.json, examples/04-theming/01-theming-dom-attributes/tsconfig.json, examples/04-theming/02-changing-font/tsconfig.json, examples/04-theming/03-theming-css/tsconfig.json, examples/04-theming/04-theming-css-variables/tsconfig.json, examples/04-theming/05-theming-css-variables-code/tsconfig.json, examples/04-theming/06-code-block/tsconfig.json, examples/04-theming/07-custom-code-block/tsconfig.json, examples/05-interoperability/01-converting-blocks-to-html/tsconfig.json, examples/05-interoperability/02-converting-blocks-from-html/tsconfig.json, examples/05-interoperability/03-converting-blocks-to-md/tsconfig.json, examples/05-interoperability/04-converting-blocks-from-md/tsconfig.json, examples/05-interoperability/05-converting-blocks-to-pdf/tsconfig.json, examples/05-interoperability/06-converting-blocks-to-docx/tsconfig.json, examples/05-interoperability/07-converting-blocks-to-odt/tsconfig.json, examples/05-interoperability/08-converting-blocks-to-react-email/tsconfig.json, examples/05-interoperability/09-blocks-to-html-static-render/tsconfig.json, examples/05-interoperability/10-static-html-render/tsconfig.json, examples/06-custom-schema/01-alert-block/tsconfig.json, examples/06-custom-schema/02-suggestion-menus-mentions/tsconfig.json, examples/06-custom-schema/03-font-style/tsconfig.json, examples/06-custom-schema/04-pdf-file-block/tsconfig.json, examples/06-custom-schema/05-alert-block-full-ux/tsconfig.json, examples/06-custom-schema/06-toggleable-blocks/tsconfig.json, examples/06-custom-schema/07-configuring-blocks/tsconfig.json, examples/06-custom-schema/08-non-editable-block/tsconfig.json, examples/06-custom-schema/draggable-inline-content/tsconfig.json, examples/06-custom-schema/react-custom-blocks/tsconfig.json, examples/06-custom-schema/react-custom-inline-content/tsconfig.json, examples/06-custom-schema/react-custom-styles/tsconfig.json, examples/07-collaboration/01-partykit/tsconfig.json, examples/07-collaboration/02-liveblocks/tsconfig.json, examples/07-collaboration/03-y-sweet/tsconfig.json, examples/07-collaboration/04-electric-sql/tsconfig.json, examples/07-collaboration/05-comments/tsconfig.json, examples/07-collaboration/06-comments-with-sidebar/tsconfig.json, examples/07-collaboration/07-ghost-writer/tsconfig.json, examples/07-collaboration/08-forking/tsconfig.json, examples/07-collaboration/09-comments-testing/tsconfig.json, examples/07-collaboration/10-suggestion-multi-editor/tsconfig.json, examples/07-collaboration/11-versioning-yjs13/tsconfig.json, examples/07-collaboration/12-multi-doc-versioning/tsconfig.json, examples/07-collaboration/13-versioning-yjs14/tsconfig.json, examples/07-collaboration/14-suggestion-gallery/tsconfig.json, examples/08-extensions/01-tiptap-arrow-conversion/tsconfig.json, examples/08-extensions/02-versioning/tsconfig.json, examples/09-ai/01-minimal/tsconfig.json, examples/09-ai/02-playground/tsconfig.json, examples/09-ai/03-custom-ai-menu-items/tsconfig.json, examples/09-ai/04-with-collaboration/tsconfig.json, examples/09-ai/05-manual-execution/tsconfig.json, examples/09-ai/06-client-side-transport/tsconfig.json, examples/09-ai/07-server-persistence/tsconfig.json, examples/vanilla-js/react-vanilla-custom-blocks/tsconfig.json, examples/vanilla-js/react-vanilla-custom-inline-content/tsconfig.json, examples/vanilla-js/react-vanilla-custom-styles/tsconfig.json, packages/ariakit/tsconfig.json, packages/code-block/tsconfig.json, packages/core/tsconfig.json, packages/dev-scripts/tsconfig.json, packages/mantine/tsconfig.json, packages/react/tsconfig.json, packages/server-util/tsconfig.json, packages/shadcn/tsconfig.json, packages/xl-ai-server/tsconfig.json, packages/xl-ai/tsconfig.json, packages/xl-docx-exporter/tsconfig.json, packages/xl-email-exporter/tsconfig.json, packages/xl-multi-column/tsconfig.json, packages/xl-odt-exporter/tsconfig.json, packages/xl-pdf-exporter/tsconfig.json, playground/tsconfig.json, shared/tsconfig.json, tests/nextjs-test-app/tsconfig.json, tests/tsconfig.json, tsconfig.json |
| Reproducible environment | met | 10 / 10 | Dockerfile, lockfile |
| Demonstrated agent practice | met | 10 / 10 | 31 of the last 100 commits agent-authored or agent-credited |
| Automated maintenance | met | 8 / 8 | 3 of the last 100 commits are automated dependency updates |
| OpenSSF Scorecard: Pinned-Dependencies | partial | 8 / 10 | dependency not pinned by hash detected -- score normalized to 8 |

### Code legibility for models — 100/100 (Excellent)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| Type-checkable code | met | 45 / 45 | TypeScript (statically typed) |
| Manageable file sizes | partial | 54.9 / 55 | 3/1660 source files over 60KB |

### Machine-readable interfaces — 40/100 (At risk)

| Criterion | Status | Points | Detail |
|---|---|---|---|
| API schema (OpenAPI/GraphQL/proto) | not met | 0 / 40 | — |
| MCP server | not met | 0 / 20 | — |
| Runnable examples | met | 40 / 40 | examples |

## Collection warnings

- Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token

## What this report is

inspect.software measures public repositories against a single published, versioned methodology and reports the result as a 1–100 health index. Findings are signals derived from what is visible in public repository data — they are not a security audit, a warranty, or an endorsement, and no result depends on payment.

- Methodology, formulas and weights: https://inspect.software/methodology.md
- What a result does and does not claim: https://inspect.software/wiki/signals-not-warranties.md
- Rating bands: https://inspect.software/wiki/scoring-bands.md
- Corrections: https://inspect.software/contact.md
- Index of all documents: https://inspect.software/llms.txt