What causes "Please add ${entryPointMarkup} to /index.html inside of " in quasarframework/quasar?

Please add ${entryPointMarkup} to /index.html inside of <bod

Error message

Please add ${entryPointMarkup} to /index.html inside of <body>

What it means

appFilesValidations requires the marker comment '' inside <body> of /index.html. Quasar replaces it at build time with the app mount markup and the entry script tag; without it the app cannot be bootstrapped, so the validation warns and marks the project invalid.

Source

Thrown at app-vite/lib/utils/app-files-validations.js:25

  let valid = true

  const file = appPaths.resolve.app('index.html')

  if (!fs.existsSync(file)) {
    warn('The file /index.html is missing. Please add it back.\n')
    return false
  }

  const content = fs.readFileSync(file, 'utf8')

  if (content.includes(attachMarkup)) {
    warn(`Please remove ${attachMarkup} from
    /index.html inside of <body>\n`)
    valid = false
  }

  if (!content.includes(entryPointMarkup)) {
    warn(`Please add ${entryPointMarkup} to
    /index.html inside of <body>\n`)
    valid = false
  }

  return valid
}

View on GitHub (pinned to 4841521b5f)

Solutions

Add  inside the <body> of index.html.
If you also deleted <div id="q-app"></div>, that's fine — just keep the entry-point comment as the sole injection point.

Example fix

<!-- before -->
<body>
  <div id="app"></div>
</body>
<!-- after -->
<body>
  <!-- quasar:entry-point -->
</body>

Defensive patterns

Strategy: validation

Validate before calling

import { readFileSync } from 'node:fs'
if (!readFileSync('index.html', 'utf8').includes('<!-- quasar:entry-point -->')) {
  throw new Error('index.html must contain <!-- quasar:entry-point --> inside <body>')
}

Prevention

Never delete the  comment when editing the template.
Add an editor file-watcher/snippet that flags its removal.
When writing custom index.html, start from the official Quasar template.

When it happens

Trigger: Running quasar dev/build with a root index.html lacking  inside <body> (removed during editing or a hand-written template); called from #computeConfig via appFilesValidations.

Common situations: Cleaning up 'unused-looking' comments in the HTML template, creating a custom index.html from scratch, or copying an HTML file from a non-Quasar Vite project.

Related errors

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