Build from source

DevFiller is open source under the MIT license. This page is for contributors. To use DevFiller, install it from the Chrome Web Store, which keeps it up to date.

Run it locally

git clone https://github.com/gouderhaithem/devfiller.git
cd devfiller
npm ci
npm run dev        # options preview and demo forms at http://127.0.0.1:5187

Page	What it's for
/	The options page next to a working demo form
/welcome.html	The first-install welcome page
/demo.html	A mixed-language form to test the installed extension on
/dynamic-form.html	A form that reveals fields after filling

Load your build in Chrome

1. Run npm run build.
2. Open chrome://extensions and turn on Developer mode.
3. Click Load unpacked and select the dist folder (the folder itself, not a file inside it).

After a change, run npm run build again and click Reload on DevFiller's card. If the Chrome Web Store version is installed too, turn it off while you test your build.

Build, test and package

npm run build              # type-check and build the extension into dist/
npm test                   # unit tests
npx playwright install chromium
npm run test:e2e           # the real extension in Chromium
npm run benchmark          # recognition accuracy on the benchmark forms, fails on any regression
npm run package            # release/devfiller-<version>.zip for the Chrome Web Store
npm run store-assets       # store screenshots and promo tile

The benchmark scores the fill engine on labelled forms in English, French and Arabic, and on held-out forms it was never tuned on. How recognition works explains the engine.

Browser tests load the built extension in a throwaway profile and cover toolbar filling, the side panel, settings, exclusions, forms that change, and the AI cache. AI providers are simulated.

Where things are

Path	What it holds
public/manifest.json	Permissions, entry points and icons
src/background.ts	Toolbar action, AI preparation and cache
src/engine.ts	Field detection and filling
src/data.ts, src/samples.ts	The generator and its samples in three languages
src/gemini.ts	Groq and Gemini requests
src/sidepanel.tsx, src/panel-page.ts	Side panel and undo
src/main.tsx	The options page
website/	This website

Contributing

Bug reports and pull requests are welcome on GitHub. For a bug, include your browser version, the steps, and a small example form with fictional data. Run the build and both test suites before opening a pull request.