{"record":{"id":"c0602fd0a2d4c505","repo":"quasarframework/quasar","slug":"failed-to-install-capacitor-splash-screen-please","errorCode":null,"errorMessage":"Failed to install @capacitor/splash-screen. Please do it manually.","messagePattern":"Failed to install @capacitor/splash-screen\\. Please do it manually\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"icongenie/lib/mount/mount-capacitor.js","lineNumber":54,"sourceCode":"      return false\n    }\n  }\n\n  if (\n    !pkg.dependencies?.['@capacitor/splash-screen'] &&\n    !pkg.devDependencies?.['@capacitor/splash-screen']\n  ) {\n    const pm = createInstance(srcCapacitorDir)\n    if (typeof pm === 'string') {\n      warn(pm)\n      return false\n    }\n\n    const success = await pm.installPackage('@capacitor/splash-screen')\n\n    if (!success) {\n      warn()\n      warn('Failed to install @capacitor/splash-screen. Please do it manually.')\n    }\n  }\n\n  return true\n}\n\nexport async function mountCapacitor() {\n  const hasInstalled = await installCapacitorAssets()\n  if (!hasInstalled) return\n\n  const success = await spawnSync('npx', ['@capacitor/assets', 'generate'], {\n    cwd: srcCapacitorDir\n  })\n\n  if (!success) {\n    warn()\n    warn('Failed to run @capacitor/assets. Please do it manually.')\n    console.log(' -> /src-capacitor: $ npx @capacitor/assets generate\\n')","sourceCodeStart":36,"sourceCodeEnd":72,"githubUrl":"https://github.com/quasarframework/quasar/blob/4841521b5f635a971eb9e2710e5542efd194691b/icongenie/lib/mount/mount-capacitor.js#L36-L72","documentation":"installCapacitorAssets also ensures @capacitor/splash-screen is present as a runtime dependency; when `pm.installPackage('@capacitor/splash-screen')` fails, this warning is emitted. Generation continues (it later returns true), but splash screen assets won't apply unless the plugin is installed.","triggerScenarios":"Running icongenie for Capacitor when package.json lacks @capacitor/splash-screen and the package manager install fails (registry unreachable, version conflict, permissions).","commonSituations":"CI with restricted network access; mismatched Capacitor versions causing resolution failures; offline development machines.","solutions":["Install manually: npm install @capacitor/splash-screen.","Inspect the package manager output above the warning for the root failure and resolve it (proxy, ERESOLVE, disk space).","Verify the plugin appears in package.json dependencies, then re-run the generation."],"exampleFix":"# before: automatic install failed\n# after\nnpm install @capacitor/splash-screen\nicongenie generate -m capacitor","handlingStrategy":"validation","validationCode":"const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));\nif (!pkg.dependencies?.['@capacitor/splash-screen']) {\n  console.log('Pre-install: npm install @capacitor/splash-screen');\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Install @capacitor/splash-screen up front as a project dependency.","Verify network/registry connectivity in CI before generation steps.","Keep Capacitor plugin versions aligned with your Capacitor core version."],"tags":["capacitor","npm","splash-screen","dependencies"],"backgroundTag":"dependency-install-failure","analyzedSha":"4841521b5f635a971eb9e2710e5542efd194691b","analyzedAt":"2026-08-30T01:13:14.944Z","schemaVersion":2},"datasetVersion":"2026-08-30T03:17:51.788Z"}