Skip to content
HAEVN Logo HAEVN

Contributing

Development setup

Section titled “Development setup”

  1. Clone the repository

    Terminal window
    git clone https://github.com/yourusername/haevn.git
    cd haevn

  2. Install dependencies

    Terminal window
    pnpm install

  3. Build the extension

    Terminal window
    pnpm run build

  4. Load in Chrome

    • Open chrome://extensions
    • Enable Developer mode
    • Click Load unpacked and select the dist/ folder

  5. Start developing

    Make code changes, rebuild with pnpm run build, then reload the extension.

Development workflow

Section titled “Development workflow”
Terminal window
# Build
pnpm run build


# Run tests
pnpm test


# Lint
pnpm run lint
pnpm run lint:fix   # auto-fix


# Reload the extension after building
# (run from any page with the extension active)
haevnDebug.reload()

Code style

Section titled “Code style”

HAEVN uses Biome for linting and formatting:

  • 2-space indentation, 100 character line width
  • Double quotes, trailing commas
  • camelCase for functions/variables, PascalCase for components/types

Run pnpm run lint:fix before committing to auto-fix any issues.

Submitting a PR

Section titled “Submitting a PR”
  1. Fork the repository and create a branch from main
  2. Make your changes following the conventions above
  3. Add or update tests where applicable
  4. Run pnpm test and pnpm run lint — both must pass
  5. Open a PR with a clear description of what changed and why

For new platform providers, see Adding Providers.