- Home
- Skills
- Mobile Development
- Capacitor Config Check
More screenshots
Works with the AI Agents you already use
Capacitor Config Check
This skill finds those and fifteen other Capacitor and Cordova config mistakes before you ship, and tells you how to fix each one.
$5
Capacitor Config Check
Example session with this skill installed
Check this project with capacitor-config-check.
- Read your context and instructions
- Compiled the capacitor config check
$ python3 scripts/check_capacitor.py examples/risky
BLOCK legacy-cordova/config.xml:9 C03 NAVIGATION_TO_ANY_SITE
<allow-navigation href="*" />
Why: The WebView may navigate to any site: server.allowNavigation lists '*' (or a wildcard for a whole top-level domain such as '*.com'), or Cordova's allow-navigation is '*' or 'https://*/*'. Capacitor gives every allowed origin access to the native bridge, and Cordova's docs mark href="*" as NOT RECOMMENDED: a link, redirect or injected script can open an attacker's page inside the app with access to native plugins.
Safer: List only the exact hosts the app must show inside the WebView (checkout.example.com) and open every other link in the system browser (@capacitor/browser, or InAppBrowser with _system).
BLOCK legacy-cordova/config.xml:12 C05 SECRET_IN_APP_CONFIG
BLOCK legacy-cordova/config.xml:20 C04 WEBVIEW_DEBUGGING_IN_RELEASE
BLOCK shop-app/capacitor.config.ts:10 C01 DEV_SERVER_URL_IN_CONFIG
BLOCK shop-app/capacitor.config.ts:13 C03 NAVIGATION_TO_ANY_SITE
BLOCK shop-app/capacitor.config.ts:18 C02 MIXED_CONTENT_ALLOWED
BLOCK shop-app/capacitor.config.ts:19 C04 WEBVIEW_DEBUGGING_IN_RELEASE
BLOCK shop-app/capacitor.config.ts:24 C05 SECRET_IN_APP_CONFIG
REVIEW field-app/android/app/src/main/assets/capacitor.config.json:6 C20 DEV_SERVER_IN_NATIVE_COPY
REVIEW field-app/capacitor.config.ts:13 C21 DEV_SETTING_FAILS_OPEN
REVIEW legacy-cordova/config.xml:8 C13 ACCESS_ANY_ORIGIN
REVIEW legacy-cordova/config.xml:11 C14 INSECURE_FILE_MODE
REVIEW legacy-cordova/config.xml:13 C18 OUTDATED_PLATFORM
REVIEW legacy-cordova/config.xml:16 C11 CLEARTEXT_ALLOWED
REVIEW legacy-cordova/config.xml:23 C17 KEY_IN_APP_CONFIG
REVIEW legacy-cordova/package.json:5 C18 OUTDATED_PLATFORM
REVIEW portal-app/capacitor.config.json:6 C22 HOSTED_APP_URL
REVIEW shop-app/capacitor.config.ts:8 C15 LOGGING_IN_RELEASE
REVIEW shop-app/capacitor.config.ts:11 C11 CLEARTEXT_ALLOWED
REVIEW shop-app/capacitor.config.ts:14 C12 NAVIGATION_ALLOWLIST
REVIEW shop-app/capacitor.config.ts:20 C16 LEGACY_ANDROID_BRIDGE
REVIEW shop-app/capacitor.config.ts:30 C17 KEY_IN_APP_CONFIG
REVIEW shop-app/index.html:3 C19 NO_CSP_IN_INDEX
REVIEW shop-app/package.json:10 C18 OUTDATED_PLATFORM
(Each finding also has Why and Safer lines, as in the first one.)
Verdict: BLOCK. Checked 13 files, 13 with Capacitor or Cordova content.
This is a static check of file text. NOT FLAGGED is not a guarantee.
Connects securely to your tools. The creator never sees your data.
About this skill
server: { url: 'http://192.168.1.68:8100' } left in capacitor.config.ts makes your store build load a laptop's dev server instead of the app, and webContentsDebuggingEnabled: process.env.NODE_ENV !== 'production' is true when npx cap sync runs without NODE_ENV, so release builds ship with WebView debugging on. This skill finds those and fifteen other Capacitor and Cordova config mistakes before you ship, and tells you how to fix each one.
Your agent runs a scanner on capacitor.config.ts, .js and .json, the capacitor.config.json copies Capacitor writes into android/ and ios/, Cordova and Ionic config.xml, package.json and the app's index.html. It reads TypeScript and JavaScript configs as data and never runs them: it follows object literals, shorthand properties, top-level constants and config.server = {...} assignments, and treats settings behind process.env checks, ternaries, if and switch as development-only, except "not production" checks that are true during npx cap sync. A config with an unclosed string, comment or bracket is reported as not checked instead of passing. Generated files (res/xml/config.xml, platforms/, plugins/) are skipped, and a config.xml left over from a Cordova migration is checked for secrets only. It returns BLOCK, REVIEW, or NOT FLAGGED, with the file, line, reason, and a safer approach. Secrets are never printed.
What it checks
BLOCK
- C01: server.url pointing at a development server (plain http, localhost, a private or emulator address, a .local name or a dev-server port) outside a condition (Capacitor's docs: not intended for production)
- C02: android.allowMixedContent: true, so https pages may load http scripts
- C03: navigation to any site: server.allowNavigation with , https:// or a whole top-level domain (.com), or Cordova allow-navigation , http:///, https:///
- C04: WebView debugging in release builds: android or ios webContentsDebuggingEnabled: true, Cordova InspectableWebview true
- C05: a literal password, client secret or private key in the app config (keystorePassword, keystoreAliasPassword, a plugin's clientSecret, a password in the user-info part of a URL, Cordova preferences and plugin variables)
REVIEW
- C11: cleartext traffic allowed: server.cleartext: true, android:usesCleartextTraffic="true" or NSAllowsArbitraryLoads written through config.xml
- C12: server.allowNavigation entries for specific hosts, or a Cordova allow-navigation entry over plain http
- C13: Cordova access origin="*" (any server; on iOS, Cordova writes it as NSAllowsArbitraryLoads)
- C14: Cordova AndroidInsecureFileModeEnabled set to true (the app loads from file://)
- C15: loggingBehavior: 'production'
- C16: android.useLegacyBridge: true
- C17: a literal API key or token in the app config (plugin settings, Cordova plugin variables and preferences); publishable key formats are not reported
- C18: Capacitor 6 or older, cordova-android below 15 without android-targetSdkVersion 36, cordova-ios below 6, or cordova-plugin-whitelist, as exact versions, ranges that stop below the current major (>=5.0.0 <8.0.0) or npm: aliases
- C19: the app's entry index.html has no Content-Security-Policy meta tag
- C20: the generated native copy of capacitor.config.json still holds server.url from a live-reload run
- C21: webContentsDebuggingEnabled, allowMixedContent or server.url switched on by a "not production" check (NODE_ENV !== 'production', or !isProd), which is true when npx cap sync runs without NODE_ENV
- C22: server.url pointing at a hosted https site, so the app wraps a website whose pages and scripts all get the native bridge
What's included
- The scanner (Python 3.9+, standard library only)
- A rules guide with the reason, safer approach and official Capacitor or Cordova documentation link for each rule
- Risky and safe example projects (a Capacitor app, a Capacitor app with a stale native copy, a hosted-site wrapper, a Cordova app), and the real report the scanner produces on the risky ones
Limits It reads the config as text and never runs it. Values that come from function calls, other modules or .env files are not followed, and a setting behind a condition is treated as development-only (C21 reports the "not production" form); literal secrets are reported in every branch because they are in the repository either way. C01 also fires on the live-reload example in Capacitor's docs, which is meant for development only. server.androidScheme 'http' is not reported, because Capacitor's 5.0 and 6.0 upgrade guides recommend it for existing apps. C19 does not see a policy added by a bundler plugin at build time (Angular's autoCsp is recognized). Versions are read from package.json and config.xml, not lock files. Native project files (AndroidManifest.xml, Info.plist, Gradle files) are not read. NOT FLAGGED is not a guarantee.
Static check of config text. Values computed in functions, other modules or .env files are not followed, and native project files are not read. NOT FLAGGED is not a guarantee.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 4 days ago
Requires
Permissions
Runs one local Python script in the terminal. It reads your project's files, writes nothing, and makes no network calls. The example projects include clearly fake, inert values (not-a-real-..., NOTREAL-..., EXAMPLE-...) for the scanner to find. Nothing is run or built.