{"record":{"id":"730e4df230e7ef6b","repo":"quasarframework/quasar","slug":"files-validation-not-passed-successfully-please-f","errorCode":null,"errorMessage":"Files validation not passed successfully. Please fix the issues.","messagePattern":"Files validation not passed successfully\\. Please fix the issues\\.","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"app-vite/lib/quasar-config-file.js","lineNumber":1345,"sourceCode":"\n        rootComponent: 'src/App.vue',\n        router: 'src/router/index',\n        store: `src/${this.#storeProvider.pathKey}/index`,\n        pwaRegisterServiceWorker: 'src-pwa/register-sw',\n        pwaServiceWorker: 'src-pwa/sw/custom-sw',\n        pwaManifestFile: 'src-pwa/manifest.json',\n        electronMain: 'src-electron/electron-main',\n        bexManifestFile: 'src-bex/manifest.json'\n      },\n      cfg.sourceFiles\n    )\n\n    if (!appFilesValidations(appPaths)) {\n      if (this.#shouldFail) {\n        fatal('Files validation not passed successfully', 'FAIL')\n      }\n\n      warn('Files validation not passed successfully. Please fix the issues.\\n')\n      return\n    }\n\n    // do we have a store?\n    const storePath = appPaths.resolve.app(cfg.sourceFiles.store)\n    Object.assign(cfg.metaConf, {\n      hasStore: resolveExtension(storePath) !== void 0,\n      storePackage: this.#storeProvider.name\n    })\n\n    // make sure we have preFetch in config\n    cfg.preFetch ||= false\n\n    if (this.#ctx.mode.capacitor) {\n      if (cfg.capacitor.capacitorCliPreparationParams.length === 0) {\n        cfg.capacitor.capacitorCliPreparationParams = [\n          'sync',\n          this.#ctx.targetName","sourceCodeStart":1327,"sourceCodeEnd":1363,"githubUrl":"https://github.com/quasarframework/quasar/blob/4841521b5f635a971eb9e2710e5542efd194691b/app-vite/lib/quasar-config-file.js#L1327-L1363","documentation":"#computeConfig runs appFilesValidations against the project (required files such as src, src/App.vue, index.html, template files, etc.); if any required file is missing or invalid, this message is reported. Fatal under shouldFail; otherwise a warning that aborts config computation.","triggerScenarios":"A required project file listed by appFilesValidations is missing or fails its check — e.g. deleted src/App.vue, renamed index.html, missing src-ssr/server after partial mode removal, corrupted scaffold, or wrong file referenced via sourceFiles config.","commonSituations":"Manually deleting/moving scaffold files; git merge losing files; incomplete `quasar mode add` (mode folder half-created); custom sourceFiles paths in quasar.config pointing at nonexistent files; fresh checkout without install/scaffold.","solutions":["Read the validation details printed above the message to see exactly which file failed.","Restore the missing file (recreate via `quasar new`, copy from a fresh scaffold, or `git checkout -- <file>`).","If you intentionally moved files, update quasar.config > sourceFiles to the new paths.","Re-add a half-installed mode: `quasar mode remove <mode>` then `quasar mode add <mode>`.","Re-run the command after restoring."],"exampleFix":"// before (quasar.config)\nsourceFiles: { appComponent: 'src/views/Root.vue' } // file doesn't exist\n// after\nsourceFiles: { appComponent: 'src/App.vue' } // or create the referenced file","handlingStrategy":"validation","validationCode":"// Check the core scaffold files before running commands:\nimport { existsSync } from 'node:fs'\nfor (const f of ['src/App.vue', 'index.html', 'src/index.template.html', 'src/router/routes.js']) {\n  if (!existsSync(f)) console.warn(`Missing required file: ${f}`)\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Never delete scaffold files without replacing them; keep them in git.","When customizing sourceFiles, verify every referenced path exists.","Complete mode add/remove cycles fully; check for half-created mode folders.","After a merge conflict, confirm no required files were lost before building."],"tags":["config","file-validation","missing-files","project-structure"],"backgroundTag":"missing-required-file","analyzedSha":"4841521b5f635a971eb9e2710e5542efd194691b","analyzedAt":"2026-08-30T01:13:14.944Z","schemaVersion":2},"datasetVersion":"2026-08-30T03:17:51.788Z"}