diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
new file mode 100644
index 0000000..2806813
--- /dev/null
+++ b/.github/workflows/release.yml
@@ -0,0 +1,28 @@
+name: test & maybe release
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  id-token: write
+  packages: write
+  pull-requests: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event_name }}-${{ github.event_name == 'push' && github.sha || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  js-test-and-release:
+    uses: ipdxco/unified-github-workflows/.github/workflows/js-test-and-release.yml@v1.0
+    secrets:
+      DOCKER_TOKEN: ${{ secrets.DOCKER_TOKEN }}
+      DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}
+      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+      UCI_GITHUB_TOKEN: ${{ secrets.UCI_GITHUB_TOKEN }}
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..e69de29
diff --git a/package.json b/package.json
index 558c570..6589acc 100644
--- a/package.json
+++ b/package.json
@@ -1,23 +1,136 @@
 {
-  "name": "ipfs-quicklaunch-extension",
-  "version": "1.0.0",
+  "name": "ipfs-quicklaunch",
+  "version": "0.0.1",
   "description": "IPFS launcher browser extension with local pet names, version management, and smart CID discovery",
+  "license": "Apache-2.0 OR MIT",
+  "homepage": "https://github.com/ipshipyard/ipfs-quicklaunch",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ipshipyard/ipfs-quicklaunch.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ipshipyard/ipfs-quicklaunch"
+  },
   "main": "src/background.js",
   "scripts": {
     "build": "tsc && cp src/manifest.json dist/ && cp src/popup.html dist/ && cp -r src/icons dist/",
+    "release": "aegir release",
     "watch": "tsc --watch",
     "clean": "rm -rf dist"
   },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      [
+        "@semantic-release/commit-analyzer",
+        {
+          "preset": "conventionalcommits",
+          "releaseRules": [
+            {
+              "breaking": true,
+              "release": "major"
+            },
+            {
+              "revert": true,
+              "release": "patch"
+            },
+            {
+              "type": "feat",
+              "release": "minor"
+            },
+            {
+              "type": "fix",
+              "release": "patch"
+            },
+            {
+              "type": "docs",
+              "release": "patch"
+            },
+            {
+              "type": "test",
+              "release": "patch"
+            },
+            {
+              "type": "deps",
+              "release": "patch"
+            },
+            {
+              "scope": "no-release",
+              "release": false
+            }
+          ]
+        }
+      ],
+      [
+        "@semantic-release/release-notes-generator",
+        {
+          "preset": "conventionalcommits",
+          "presetConfig": {
+            "types": [
+              {
+                "type": "feat",
+                "section": "Features"
+              },
+              {
+                "type": "fix",
+                "section": "Bug Fixes"
+              },
+              {
+                "type": "chore",
+                "section": "Trivial Changes"
+              },
+              {
+                "type": "docs",
+                "section": "Documentation"
+              },
+              {
+                "type": "deps",
+                "section": "Dependencies"
+              },
+              {
+                "type": "test",
+                "section": "Tests"
+              }
+            ]
+          }
+        }
+      ],
+      "@semantic-release/changelog",
+      "@semantic-release/npm",
+      [
+        "@semantic-release/github",
+        {
+          "assets": [
+            { "path": "dist", "label": "Browser extension background" },
+            { "path": "src", "label": "Source" }
+          ]
+        }
+      ],
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "CHANGELOG.md",
+            "package.json"
+          ]
+        }
+      ]
+    ]
+  },
   "devDependencies": {
     "@types/chrome": "^0.0.248",
+    "aegir": "^47.0.20",
     "typescript": "^5.0.0"
   },
   "keywords": [
     "browser-extension",
     "chrome-extension",
-    "ipfs-quicklaunch",
-    "petnames"
-  ],
-  "author": "",
-  "license": "MIT"
+    "ipfs-quicklaunch"
+  ]
 }
\ No newline at end of file