EatWell — Quickstart & Setup

Quick start

Follow these commands from the project root. These examples use PowerShell on Windows; replace with your shell if needed.

1. Install dependencies

npm install

2. Dev (Vite)

Run the Vite dev server for local development (HMR):

npm run dev

3. Build for production

Build produces a ready-to-load extension bundle in dist/:

npm run build

The build script copies src/manifest.json and the src/icons/ folder into dist/. Load the dist/ folder in Chrome to ensure icons and built assets are available.

Setting up the Extension

1. Register required API keys

• If you plan to use Rewriter / Origin Trial features, register an Origin Trial token via Chrome Origin Trials and add it in Options.
• To use Gemini or other Google AI REST endpoints, provision an API key at AI Studio: https://aistudio.google.com/app/apikey.

2. Load the extension into Chrome (developer mode)

1. Open chrome://extensions/.
2. Enable Developer mode.
3. Click Load unpacked and select the dist/ folder from the repo.

3. Configure Extension Options

Open the extension card in chrome://extensions and click Extension options, or open the hosted options/index.html page.

• Add your allergy information
• Add calorie goals
• Paste API keys (masked inputs)

Click Save.

4. If icons or assets don't appear

Reload the extension from the Extensions page. If issues persist, remove the extension and re-load via Load unpacked pointing at dist/. Check the extension "Errors" panel for missing file logs.