Qentrah
Projects
On this page
Guides

Two ways to run it

View as Markdown

Chrome cannot use the Vite dev server as a New Tab page. Vite is only a live preview.

CommandWhat it is for
npm run devPreview at http://127.0.0.1:5173 while you edit. Not the real New Tab.
npm run buildWrites a static extension into dist/. Load that folder in Chrome. No Vite process needed after this.

Preview while developing

Terminal
Shell
npm install
npm run dev

Open http://127.0.0.1:5173. Hot reload works here. Your real New Tab still uses whatever you last loaded from dist/.

Load the extension locally (no Vite)

Terminal
Shell
npm install
npm run build

Then in Chrome:

  1. Open chrome://extensions
  2. Turn on Developer mode
  3. Click Load unpacked
  4. Choose the dist folder in this repo

Every new tab opens dist/index.html as a normal page so Chrome does not draw the “Customise Chrome” footer under the dock. Rebuild and click Reload on the extension card when source changes. Allow the extra permissions if Chrome asks.

The extension icon (public/icons/) is copied into dist/icons/ on build and shows on chrome://extensions.

Source captured: 2026-10-11