1

Install Extension SDK

npm install @villagehq/extension-sdk
2

Add to your Extension

The SDK provides two main functions:
import Village from "@villagehq/extension-sdk";

// Initialize Village service worker
Village.initServiceWorker();

import Village from "@villagehq/extension-sdk";

// Initialize Village content script
Village.initContentScript();
3

Required permissions

Your extension’s manifest.json must include the following permissions:
    "permissions": [
      "cookies",
      "storage",
      "webRequest",
      "alarms",
      "webNavigation"
    ],
    "host_permissions": ["*://*.linkedin.com/*", "*://*.village.do/*"],
    "externally_connectable": {
      "matches": ["*://*.village.do/*"]
    }
4

Test your extension

Go to the Platform Admin and add your Extension’s ID to verify your integration:Extension Pn

​
Cross-Site Authentication

Extensions built with the Village Extension SDK enable seamless authentication across different domains and embedded contexts. This allows users to stay logged in when accessing Village components on third-party websites like job boards or partner platforms. Learn more about how this works in our detailed Cross-Site Authentication guide.

My extension integration is not working