Failed to install cordova-plugin-splashscreen. Please do it

Error message

Failed to install cordova-plugin-splashscreen. Please do it manually.

What it means

When mounting a Cordova project, icongenie ensures cordova-plugin-splashscreen is installed because splash screen generation depends on it. If the cordova plugin install does not report success, this warning is printed along with the manual command to run inside /src-cordova. The mounting continues but splash screens may not work.

Source

Thrown at icongenie/lib/mount/mount-cordova.js:157

  if (
    // it's already installed, so nothing to do
    hasDeepProp(pkg, 'dependencies', 'cordova-plugin-splashscreen') ||
    hasDeepProp(pkg, 'cordova', 'plugins', 'cordova-plugin-splashscreen')
  ) {
    return
  }

  const hasInstalled = await spawnSync(
    'cordova',
    ['plugin', 'add', 'cordova-plugin-splashscreen'],
    {
      cwd: srcCordovaDir
    }
  )

  if (!hasInstalled) {
    warn()
    warn(
      'Failed to install cordova-plugin-splashscreen. Please do it manually.'
    )
    console.log(
      ' -> /src-cordova: $ cordova plugin add cordova-plugin-splashscreen\n'
    )
  }
}

export async function mountCordova(files) {
  if (existsSync(cordovaConfigXml)) {
    const cordovaFiles = getCordovaFiles(files)

    if (cordovaFiles.length !== 0) {
      const hasSplashscreen = cordovaFiles.some(
        file => file.generator === 'splashscreen'
      )

      if (hasSplashscreen) {

View on GitHub (pinned to 4841521b5f)

Solutions

Run manually in /src-cordova: `cordova plugin add cordova-plugin-splashscreen`.
Verify the cordova CLI works (`cordova --version`) and registry access is available.
Check config.xml for version pins conflicting with the plugin and retry the icongenie command.

Example fix

# before: automatic plugin install failed
cd src-cordova
cordova plugin add cordova-plugin-splashscreen  # then rerun icongenie

Defensive patterns

Strategy: validation

Validate before calling

const cfg = fs.readFileSync('src-cordova/config.xml', 'utf8');
if (!cfg.includes('cordova-plugin-splashscreen')) {
  console.log('Pre-install: cd src-cordova && cordova plugin add cordova-plugin-splashscreen');
}

Prevention

Add cordova-plugin-splashscreen to the project before running icongenie.
Verify the cordova CLI is installed and on PATH (`cordova --version`).
Check plugin version pins in config.xml for conflicts.

When it happens

Trigger: Running icongenie generate/mount for Cordova when cordova-plugin-splashscreen is absent and `cordova plugin add cordova-plugin-splashscreen` fails (network error, cordova CLI missing, plugin registry issue).

Common situations: cordova CLI not installed or on PATH; offline/CI environments; plugin pinned to an incompatible version in config.xml.

Related errors

AI-assisted analysis of quasarframework/quasar@4841521b5f (2026-08-30). Data as JSON: /api/errors/4dcf6bedaac2fc5c. Report an issue: GitHub.