Skip to content

Developer Guide

HAEVN is open source and built to be extended. The plugin architecture makes it straightforward to add support for new AI platforms, and the codebase is well-documented.

Architecture

Understand the three-tier worker model, data pipeline, and how the pieces fit together.

Read more →

Adding Providers

Step-by-step guide to adding support for a new AI platform.

Read more →

Data Model

The HAEVN.Chat format and how data flows from extraction to storage.

Read more →

Contributing

How to set up the development environment, run tests, and submit a PR.

Read more →

  • Language: TypeScript 5.9 (strict mode)
  • Build: esbuild (multi-entry, ~30s full rebuild)
  • Runtime: Chrome Extension MV3 (Service Worker)
  • UI: React 18, Tailwind CSS, shadcn/ui
  • Storage: Dexie (IndexedDB) + OPFS
  • Search: Lunr.js in a Web Worker
  • Testing: Vitest + fake-indexeddb