What causes "Failed to run @capacitor/assets. Please do it manually." in quasarframework/quasar?

Run the command manually in /src-capacitor: `npx @capacitor/assets generate` to see the underlying error.

Failed to run @capacitor/assets. Please do it manually.

Error message

Failed to run @capacitor/assets. Please do it manually.

What it means

After installing @capacitor/assets, mountCapacitor runs `npx @capacitor/assets generate` inside /src-capacitor to produce icons and splash screens. A non-zero exit of that spawned command triggers this warning with a hint of the command to run manually. The assets are simply not generated.

Source

Thrown at icongenie/lib/mount/mount-capacitor.js:71

      warn()
      warn('Failed to install @capacitor/splash-screen. Please do it manually.')
    }
  }

  return true
}

export async function mountCapacitor() {
  const hasInstalled = await installCapacitorAssets()
  if (!hasInstalled) return

  const success = await spawnSync('npx', ['@capacitor/assets', 'generate'], {
    cwd: srcCapacitorDir
  })

  if (!success) {
    warn()
    warn('Failed to run @capacitor/assets. Please do it manually.')
    console.log(' -> /src-capacitor: $ npx @capacitor/assets generate\n')
  }
}

View on GitHub (pinned to 4841521b5f)

Solutions

Run the command manually in /src-capacitor: `npx @capacitor/assets generate` to see the underlying error.
Ensure source images (e.g. logo.png, splash.png) exist and match the documented sizes/format.
Install @capacitor/assets locally so npx doesn't need to fetch it, then re-run icongenie.

Example fix

# before: automatic run failed
cd src-capacitor
npx @capacitor/assets generate  # inspect real error, fix assets, rerun

Defensive patterns

Strategy: validation

Validate before calling

import { existsSync } from 'node:fs';
if (!existsSync('src-capacitor/assets/logo.png')) {
  console.log('Provide source logo.png (and splash.png) in src-capacitor/assets before generating');
}

Prevention

Run `npx @capacitor/assets generate` manually once to surface the underlying error.
Ensure source images exist with correct names and dimensions per @capacitor/assets docs.
Install @capacitor/assets locally so npx works offline.

When it happens

Trigger: npx @capacitor/assets generate fails in srcCapacitorDir: npx cannot fetch the package (offline), assets config is invalid (logo files missing), or the generator itself errors on the provided images.

Common situations: Missing or misnamed source logo files in the assets directory; network-restricted npx; incompatible @capacitor/assets version with the installed Capacitor CLI.

Related errors

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