
Health check for React Native and Expo apps: A–E ratings for security, store rules, crashes
Health check for React Native and Expo apps: A–E ratings for security, store rules, crashes, upgrades and accessibility. Works with GitHub Actions and SonarQube. npx nativekeel
·
Health check for React Native and Expo apps. Will your app survive the next upgrade, pass the store and stay safe? One command, no install, no account:
npx nativekeel upgrade # go/no-go for the newest React Native / Expo, with file and line
npx nativekeel # full health check: upgrade, store rules, crashes, security, accessibilityNo terminal handy? Paste your package.json at nativekeel.com/check: the same dependency checks and upgrade plan, run in your browser.
Works with GitHub Actions (a quality gate comment on every pull request), SonarQube (findings in your existing projects and quality gate) and AI coding agents (MCP server for Claude Code, Codex and Cursor). Several apps? npx nativekeel fleet puts them on one page.
What's new in 0.1.134: NativeKeel recognizes the Kotlin helper used in patched Track Player modules and reports a separate Android playback crash path when the service uses a legacy React Native host that the app no longer provides. Reports also explain what the Stability grade measures and when Firebase access rules could not be checked. Recent releases added the expo-camera orientation lock to the Android 16 note, the target SDK check for managed Expo apps, a check for UIScene setups that lose the deep link that launches the app, a list of 30 libraries that still call APIs React Native removed, npx nativekeel upgrade (a go/no-go for the newest React Native / Expo), known malware anywhere in the lockfile's dependency tree, and detection of the actively exploited Metro dev-server flaw CVE-2025-11953. Every check is tuned on 1,100+ open-source React Native and Expo projects, with recently updated ones added every week, to keep false alarms out (measured accuracy). All releases →
Summary 4 critical · 4 high · 6 medium · 6 low
Security (OWASP MASVS) crypto 1 · network 1 · code 1 · 7 finding categories; not a compliance verdict
Start here
1. Revoke the AWS access key ID in src/App.js:6 at the provider today.
2. Set targetSdkVersion = 36 and compileSdkVersion = 36 in android/build.gradle.
3. Replace @react-native-community/push-notification-ios: no New Architecture support, unmaintained.npx nativekeel security . --html security.html --fail-on highReview secrets, credential leaks, backend access rules, unsafe code execution, transport and dependency risks in one report. New flow/configuration findings show where the input enters, where it is used, what an attacker would need, and how to verify the fix. --offline keeps the scan offline and skips online advisory checks. No source code is uploaded.
Keys added at build time. An EXPO_PUBLIC_ value set in EAS or a CI secret never appears in the repository, so no source scan can see it, yet it ships in the app. NativeKeel also opens the built app and scans the JavaScript bundle inside it, plain JavaScript or Hermes bytecode: APKs and AABs under android/app/build/outputs, eas build --local results, committed bundles, and any APK, AAB or IPA you pass with --artifact app.apk (the GitHub Action's artifact input, after your build step).
This is source analysis, not a live attack or a security certificate. Security checks and scope · Mobile flow details · Native Android details.
Upgrade
Store
targetSdk, permissions Google Play restricts (photo/video, all files, background location, app installs, SMS), 16 KB memory pages (it also opens your built APK/AAB and checks every native library), the iOS privacy manifest and SDKs too old to have one, missing Info.plist usage descriptions, sign-up without account deletion, social login without Sign in with Apple, and release builds signed with the debug key.Crashes
react-native-worklets, mixed @react-native-firebase/* or @react-navigation/* majors, a second copy of React or React Native inside a dependency, Kotlin modules that cannot load through the New Architecture interop layer, AppDelegate setups that crash in Release, camera/photos/location access without the Info.plist text iOS requires, imports of APIs removed from React Native core (AsyncStorage, Picker, ViewPropTypes, …) or deprecated for removal (ImageBackground, SafeAreaView), and traps learned from real upgrades.Security, grouped by OWASP MASVS
service_role keys, private keys, .env values compiled into the bundle, Expo extra/EXPO_PUBLIC_/eas.json secrets, signing keys and passwords.UIFileSharingEnabled) that exposes an unencrypted MMKV, expo-sqlite or Realm database (they live in Documents by default on iOS), passwords that flow into crash reports, analytics, databases or plain AsyncStorage (followed through variables), auth tokens in unencrypted storage, Android backups that copy them.NSAllowsArbitraryLoads, plain-HTTP API calls, user-installed CAs in release.Math.random for nonces and salts.myapp:// URL scheme.These are static checks: they catch the common, detectable mistakes, not everything a penetration test of the running app and backend would.
Performance
npx nativekeel bundle reads the source map a release build already wrote (Android: android/app/build/generated/sourcemaps/react/release/, Expo: npx expo export --dump-sourcemap) and measures how much of the shipped code is your app and each package, and which packages are bundled twice. --base old.map compares two builds: what was added, removed or grew. Nothing is built or run; the normal scan picks the map up too.lodash/moment imports, referenced images over 500 KB, JSON over 300 KB imported into the JavaScript bundle (every language's translations, Lottie animations), and selector allocation patterns. Confirm the actual components, release output and runtime behavior before changing them; these checks do not measure frame rate, startup time or savings.
AccessibilityhitSlop, text and placeholders whose color and background (both set in the code) fall below WCAG contrast, text fields with no label or placeholder, and text scaling turned off for the whole app. Text.defaultProps is flagged too: React 19 (React Native 0.78+) ignores it in JSX, so app-wide fonts and font-scaling limits silently stop applying. Only React Native's own touchables and inputs are checked; custom components, focus order and color contrast still need a test with a screen reader.npx nativekeel improve /path/to/app --offline
npx nativekeel improve /path/to/app --offline --out IMPROVE.mdExisting security, stability, performance, store and dependency findings become an ordered plan with reasons, applicability conditions, actions, verification and recovery. Exposed credentials get containment instructions. Apparently unused dependencies are review candidates: direct, transitive, dynamic, native and generated consumers must be considered before removal. Performance signals are not measurements.
Use --json for structured output or MCP improve_app. Malware findings block execution-dependent actions. Unknown runtime, backend, accessibility and reliability coverage stays explicit. This adds a decision layer over existing checks, not new vulnerability detectors. See scope and next modules.
npx nativekeel [path] # report
npx nativekeel plan --out UPGRADE.md # step-by-step upgrade plan
npx nativekeel --html report.html # shareable HTML report
npx nativekeel --markdown pr.md # summary for a pull request comment
npx nativekeel --sarif nk.sarif # GitHub code scanning
npx nativekeel --sonar nk-sonar.json # SonarQube external issues
npx nativekeel --json # machine-readable output
npx nativekeel --fail-on high # exit 1 on high or critical (default: critical)
npx nativekeel --offline # no network at all, local checks only
npx nativekeel --verbose # list every outdated package
npx nativekeel fleet ~/clients # every app in a folder side by sideEverything is free. The scan exits with code 1 when it finds a critical issue, so it can gate CI.
nativekeel plan turns the report into ordered work: stop leaks, set up a safety net of UI flows, fix crash risks, meet store deadlines, close security gaps, replace blocking packages, switch on the New Architecture at the right point, then upgrade React Native (or the Expo SDK) in small, reviewable hops with links to the Upgrade Helper diffs and the library versions each hop needs. Performance fixes and routine updates come last.
# .github/workflows/nativekeel.yml
name: NativeKeel
on: [pull_request]
permissions:
contents: read
security-events: write # only needed with sarif: true
jobs:
health:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- uses: actions/setup-node@v7
with: { node-version: 20 }
- run: npm ci
- uses: AlicanAkyol/nativekeel@v0
with:
fail-on: critical
baseline: .nativekeel-baseline.json # optional
sarif: true # findings inline in the PRThe report is added to the job summary. To also keep one comment on each pull request up to date with what that pull request adds or fixes, give the job pull-requests: write and set pr-comment: true:
permissions:
contents: read
pull-requests: write
# …
- uses: AlicanAkyol/nativekeel@v0
with:
pr-comment: trueThe comment compares the pull request with its base commit (no code runs) and is edited in place on every push, not repeated. Pull requests from forks get a read-only token, so they get the job summary only.
With a baseline, only findings that are new since the baseline fail the build:
npx nativekeel --save-baseline .nativekeel-baseline.json # commit this fileLet Claude Code, Codex, Cursor, VS Code or any MCP client ask NativeKeel what is wrong with a project, how to upgrade it, and which version of a library works with your React Native version, instead of guessing. With it installed, the agent checks the project before it upgrades React Native or Expo, adds a native library, prepares a store release, or runs a project you did not write.
Claude Code (plugin: the MCP server plus a skill that tells Claude when to use it):
claude plugin marketplace add AlicanAkyol/nativekeel
claude plugin install nativekeel@nativekeelOr the MCP server alone: claude mcp add nativekeel -- npx -y nativekeel@latest mcp
Codex (plugin: the MCP server plus the same skill):
codex plugin marketplace add AlicanAkyol/nativekeel
codex plugin add nativekeel@nativekeelOr only the MCP server, in ~/.codex/config.toml:
[mcp_servers.nativekeel]
command = "npx"
args = ["-y", "nativekeel@latest", "mcp"]Any other agent, no MCP needed: add this line to your project's AGENTS.md or CLAUDE.md:
Before upgrading React Native or Expo, adding a native library, or preparing a store release, run `npx -y nativekeel@latest --json` and fix the critical and high findings first.Also listed in the official MCP Registry as io.github.AlicanAkyol/nativekeel.
Tools: scan_project (findings with file:line and fixes), measure_bundle (what the release bundle is made of, from its source map), upgrade_plan (ordered steps), check_library (latest version, New Architecture support, maintenance, the range that works with a given React Native version, known traps) explain_error (what a build, launch, crash or store-review error means, the fix, and where this project is affected) and verify_upgrade (after an upgrade: what got fixed and what is new compared with the last commit). Without MCP: npx nativekeel explain "<error>" --path . and npx nativekeel verify. The server is read-only and only scans folders under the directory it was started in, plus NATIVEKEEL_MCP_ROOTS (set it when your client starts servers from another folder). Results omit source files and non-package project names. Common instruction-like patterns are filtered, but this is not a complete prompt-injection defense. Malware findings stop upgrade plans; verify_upgrade.ok means no new serious findings, while safety.blocked separately reports current malware. Servers started inside a plugin folder (Codex) use your home folder as the boundary, or only NATIVEKEEL_MCP_ROOTS when it is set. See SECURITY.md.
Every report rates six areas from A to E, the way SonarQube rates code: Security, Store, Stability, Upgrade, Performance, Accessibility. A means the scan found nothing in that area, B only low findings, C medium, D high, E at least one critical. A rating describes what the scan found, not a guarantee.
npx nativekeel fleet [folder ...] scans every React Native and Expo app under the folders you give it (client projects side by side, or all apps in a monorepo) and shows them in one table, worst first: versions, the six ratings, critical and high counts, and the store and end-of-support deadlines each app faces. --html fleet.html saves it as a page you can share, --markdown and --json work too, and --fail-on applies across all apps.
npx nativekeel fleet ~/clients --html fleet.html --brand "Acme Mobile"
npx nativekeel fleet ~/clients --json > fleet-2026-10.json # keep this month's run
npx nativekeel fleet ~/clients --base fleet-2026-10.json # next month: what changed per appWith --base, every app shows what changed since that run ("Security D→B, critical 2→0"), and new or removed apps are listed. npx nativekeel compare before.json after.json does the same for one app, ratings included.
Every app in a GitHub organization, monthly: copy examples/fleet-workflow.yml to .github/workflows/ in any repository of the organization. On the 1st of each month it clones the repositories on the runner, scans them, compares with last month and writes the table to the run summary, with fleet.html and fleet.json kept as the run's artifact. Private repositories need a read-only FLEET_TOKEN secret; NativeKeel uploads nothing.
Already on SonarQube? npx nativekeel --sonar nativekeel-sonar.json writes the findings in SonarQube's generic issue format; pass it to the scanner with -Dsonar.externalIssuesReportPaths=nativekeel-sonar.json (or set sonar: nativekeel-sonar.json on the GitHub Action). Security findings arrive as vulnerabilities, store rules and crash risks as bugs, upgrade and other findings as code smells, each on its file and line. Tested on SonarQube Community Build 26.10. Details: nativekeel.com/sonarqube.
In a pull request, the GitHub Action's comment (pr-comment: true) starts with a quality gate (passed when the change adds no critical or high finding) and the ratings, with what changed.
A .nativekeel.json next to package.json keeps the team's decisions in the repository: the gate level, findings the team has accepted, folders that are not part of the app (a web dashboard, a backend), each with a reason, which checks may fail the build (gate), and an until date on an accepted finding so it comes back for review: teams usually start by gating only the checks they have seen to be right in their code, and keep the rest as a report. Every finding in the report shows its id in brackets. A finding in a file no import reaches is labelled "in code no import reaches"; crash, performance and accessibility findings there are lowered, security findings keep their level, and a project that loads files by a computed path (require.context, import(variable)) gets no such label at all. --fail-on still wins. Ignored findings stay listed in the report, and malware warnings cannot be ignored.
{
"failOn": "high",
"gate": ["secret:*", "backend-admin-in-bundle:*", "ci-*", "android-16kb-libs"],
"ignore": [
{ "id": "flipper", "reason": "Removed in the 0.80 upgrade, sprint 42" },
{ "id": "a11y-small-touch-target*", "reason": "Design review in November", "until": "2026-12-01" }
],
"exclude": [
{ "path": "tools/admin-web", "reason": "Internal web dashboard, not shipped in the app" }
]
}Team panel (closed beta). With --upload (or the Action's panel-token input) and your team's token in NATIVEKEEL_TOKEN, each scan sends a summary to your team's page on nativekeel.com: app name, versions, ratings, finding titles. No source code and no finding details; never with --offline. Live demo · join the beta: [email protected].
Looking after many apps? Tell us what your team needs: [email protected]
Agencies can put their own name on the HTML report: npx nativekeel plan --html plan.html --brand "Acme Mobile".
npm audit sends). In Expo projects without node_modules, one request to unpkg for the versions your Expo SDK expects (only the expo version is sent). --offline makes none; a test traps fetch to prove it.npm audit signatures.Details and vulnerability reporting: SECURITY.md. Wrong or missed finding? Tell us, no code needed.
The tool is free and stays free. If your team would rather hand an upgrade over, the maintainer takes on a few projects at a time: send your report to [email protected]. How it works.
MIT
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/nativekeel to learn what the "NativeKeel" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx nativekeel upgrade # go/no-go for the newest React Native / Expo, with file and line
npx nativekeel # full health check: upgrade, store rules, crashes, security, accessibility
npx nativekeel security . --html security.html --fail-on high
npx nativekeel improve /path/to/app --offline
npx nativekeel improve /path/to/app --offline --out IMPROVE.md
npx nativekeel [path] # reportThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its npm package has not answered in our offline sandbox, which usually means it needs an API key or other configuration to start. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/nativekeel)Nothing comparable is listed yet.
v0.1.134Release notesv0.1.133Release notesv0.1.132Release notesv0.1.131Release notesv0.1.1300.1.130Release notesv0.1.1290.1.129Release notesv0.1.1280.1.128Release notesv0.1.1270.1.127Release notesv0.1.1260.1.126Release notesv0.1.1250.1.125Release notesv0.1.1240.1.124Release notesv0.1.1230.1.123Release notesv0.1.1220.1.122Release notesv0.1.1210.1.121Release notesv0.1.1200.1.120Release notesv0.1.1190.1.119Release notesv0.1.1180.1.118Release notesv0.1.1170.1.117Release notesv0.1.1160.1.116Release notesv0.1.115Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "nativekeel" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.