FormFilla README

README проекта с github.com/AhmadHassan-BTed/FormFilla. Одним файлом markdown: README.md.

FormFilla promo tile

FormFilla

Ingenious Local-First Form Filler
Deterministic, zero-network autofill powered by bipartite graph matching.

License: MIT Chrome Web Store TypeScript Zero AI Kuhn-Munkres Privacy

Install from Chrome Web Store • Key Features • Architecture • Quickstart • Extending Rules • Issues & Feedback


The Philosophy

Job hunting in the modern era is exhausting and repetitive. Candidates spend hours copying and pasting identical professional records into applicant tracking systems (ATS) like Workday, Greenhouse, and Lever—systems whose built-in resume parsers frequently misalign dates, drop job titles, and scramble contact details.

FormFilla was created to restore candidate dignity and reclaim time.

Unlike cloud-based or LLM-driven autofill plugins that transmit your personal credentials, resume texts, and references to third-party AI endpoints, FormFilla is 100% local-first and deterministic. Everything runs directly inside your browser in sub-100ms. Your sensitive career data never leaves your computer.


Key Features


Technical Architecture

FormFilla executes a robust three-stage pipeline to analyze and populate complex application forms:

Active DOM  ──►  1. Scanner & Normalizer  ──►  2. Hungarian Solver  ──►  3. Framework Setter  ──►  Filled Form

1. Element Scanning & Normalization

Recursively traverses active DOM subtrees (including same-origin iframe roots) to detect inputs, selects, textareas, and comboboxes. Raw signals (labels, placeholders, IDs, names, ARIA attributes) are tokenized and normalized against abbreviation dictionaries.

flowchart TD
    DOM["Active DOM Subtree"] --> Scan["Scanner: Inputs, Selects, & Textareas"]
    Scan --> Blocks["Repeated Block Detector: Identify School & Work Cards"]
    Blocks --> Extract["Signal Extractor: Read Label, Placeholder, ID, Name"]
    Extract --> Normalizer["Normalizer: Tokenize & Expand Abbreviations"]
    Normalizer --> Tokens["Normalized Field Tokens"]

2. Kuhn-Munkres Bipartite Matching

Models the pairing between scanned form inputs and candidate profile fields as a weighted bipartite graph. FormFilla builds a global cost matrix and executes the Kuhn-Munkres (Hungarian) algorithm to guarantee the mathematically optimal assignment.

flowchart TD
    Tokens["Normalized Field Tokens"] --> Scorer["Signal Scorer: Fuzzy Sim + Regex Signatures"]
    Profile["Candidate Profile JSON"] --> Scorer
    Scorer --> CostMatrix["Build Cost Matrix: 100 - Score"]
    CostMatrix --> Hungarian["Hungarian Minimization Algorithm"]
    Hungarian --> GlobalMatching["Globally Optimal Field-to-Key Mapping"]

3. Framework-Safe DOM Writing

Standard .value = ... mutations fail on modern reactive web apps (React, Vue, Angular) because virtual DOM wrappers ignore raw property writes. FormFilla extracts browser-native property descriptors and dispatches bubbling lifecycle events.

sequenceDiagram
    participant E as Core Orchestrator
    participant D as Target DOM Element
    participant F as Web Framework (React/Vue/JS)

    E->>D: Resolve Value Assignment
    E->>D: Invoke Native Prototype Setter (bypass wrapper)
    D-->>F: Update element value
    E->>D: Dispatch event: 'input' (bubbles: true)
    E->>D: Dispatch event: 'change' (bubbles: true)
    F-->>F: Synchronize reactive state store
    Note over D,F: Element highlighted green/amber for review

Repository Structure

FormFilla/
├── src/                   # Extension source code
│   ├── background/        # Service Worker & offline lifecycle
│   ├── content/           # Scanners, Kuhn-Munkres matcher, platform adapters & DOM setters
│   ├── options/           # Dashboard settings panel & profile management
│   ├── popup/             # Extension toolbar popup interface
│   ├── shared/            # Matching dictionaries, schemas, types & storage client
│   └── themes/            # Built-in CSS themes (Light, Dark, Brutalist)
├── tests/                 # Vitest test runner suites & HTML form fixtures
├── store_assets/          # Chrome Web Store graphics, banners, and screenshots
├── scripts/               # esbuild bundling, packaging, and icon build utilities
├── docs/                  # Architecture specifications and documentation
├── icons/                 # Extension icons (16, 32, 48, 128px)
├── manifest.json          # Chrome Manifest V3 configuration
├── LICENSE                # MIT License
└── package.json           # Node dependencies and build scripts

Setup & Development

Prerequisites

1. Clone & Install Dependencies

git clone https://github.com/AhmadHassan-BTed/FormFilla.git
cd FormFilla
npm install

2. Build the Extension

Compile the TypeScript code and static assets into the dist/ directory:

# Single build
npm run build

# Watch mode for real-time development
npm run watch

3. Load Unpacked in Chrome

  1. Open Google Chrome and navigate to chrome://extensions/.
  2. Enable Developer mode via the toggle switch in the upper-right corner.
  3. Click Load unpacked in the top-left corner.
  4. Select the dist/ directory inside this repository.
  5. FormFilla is now active in your browser toolbar!

4. Running Tests

Run the Vitest unit and integration test suite:

npm run test

AI-Driven Dictionary Expansion

FormFilla’s matching logic is completely decoupled from its code through four externalized JSON dictionaries. You can easily expand matching accuracy for specialized portals, regional formats, or regional application styles:

File Purpose How to Extend
rules.json Field Selectors & Signatures Add new target keys, exactPhrases, and regexPatterns for custom portal inputs.
profile-template.json Profile Schema Layout Define user-facing fields and defaults matching any newly introduced rules.
abbreviations.json Acronym Normalization Map domain acronyms (e.g. exp → experience, inst → institution).
degrees.json Education Ranking Matrix Define degree equivalence tiers for international and regional qualifications.

Pro Tip: Each dictionary contains an embedded __meta__ prompt. You can supply these JSON files directly to any AI model (Gemini, Claude, GPT) with sample forms to generate accurate new mapping entries!


Platform Support

FormFilla contains dedicated platform adapters and generic fallback handling for:


Installation via Chrome Web Store

If you prefer installing pre-packaged releases with automated updates, install FormFilla directly from the Google Chrome Web Store:

👉 Install FormFilla from the Chrome Web Store


Contributing & Bug Reports

Contributions, issues, and feature suggestions are warmly welcomed!

Please open an issue on our central tracker:
👉 Open an Issue or Suggestion


License

This project is licensed under the MIT License © 2026 Ahmad Hassan (B-Ted). Free to use, modify, and distribute.

FormFilla (AhmadHassan-BTed/FormFilla)

Ищем в базе…

Что это такое?FormFilla — это локальное браузерное расширение, которое автоматически заполняет формы заявок на работу данными вашего профиля и файлами, хранящимися на вашем устройстве, чтобы вам не приходилось вручную копировать одни и те же сведения в каждую форму ATS.
Входит ли исходный код расширения в этот репозиторий?Нет — этот репозиторий содержит только публичную документацию, трекер задач и заметки о релизах. Движок извлечения данных и логика работы с DOM, на которых держится расширение, закрытые.
Заполняются ли автоматически чувствительные поля, например номера социального страхования?Нет — критически важные поля, такие как номера социального страхования, никогда не заполняются автоматически: рядом с ними появляется плавающий золотой значок, и для подтверждения нужен ручной клик, а поля EEO остаются отключёнными, пока вы сами не включите их.
Покидают ли данные моего профиля браузер?Нет — данные хранятся и обрабатываются локально с помощью chrome.storage.local и IndexedDB, без сетевых запросов и скриптов отслеживания.
Могу ли я использовать или изменять исходный код FormFilla?Нет — документацию и ресурсы в этом репозитории можно просматривать, но само программное обеспечение FormFilla является проприетарным и закрытым.
Что делает Repeated Block Fingerprinting?Это функция, которая находит и группирует повторяющиеся секции формы, например несколько прошлых мест работы или учебных заведений, анализируя расположение их элементов. Благодаря этому каждая запись профиля попадает в нужный повторяющийся блок, а не перезаписывает один и тот же слот.
Может ли оно также загружать мой файл резюме автоматически?Да, FormFilla имитирует загрузку файлов перетаскиванием с помощью синтетических потоков DataTransfer и подставляет сохранённые локально резюме и сопроводительные письма в поля загрузки файлов без ручного перетаскивания.
Можно ли настроить сопоставление полей на нестандартных сайтах вакансий?Да, сопоставитель читает внешние JSON-словари (rules.json, abbreviations.json, degrees.json, profile-template.json), которые разработчики или ИИ-модели могут дополнять, чтобы повысить точность на новых порталах.
Что запланировано в дорожной карте?В планах — пользовательские настройки выбора полей, адаптеры для платформ Taleo, Workable и Breezy HR, а также экспорт зашифрованных резервных копий профиля в формате AES-GCM.
Какие есть похожие проекты?BrowserKitten, job-application-agent, JobFlow, JinaClip, Darkument, svoi, javranking-extension, ScrollToPrompt
Размер
6.1 MB
Звёзды
4.7K
Обновлён
КоммитNov 03
Возраст
4 мес
Коммиты · 90 дней