refactor: rebrand AI SEO Copilot to Optia

Paul Mulligan · claude · Paul Mulligan · commit 3dcb862a9c05 · 2026-06-26T11:57:54.000-04:00
Rename all brand references across code, config, docs and UI from "AI SEO Copilot"/"SEO Copilot" to "Optia". Updates package names (optia-extension, optia), manifest name/short_name/default_title, HTML &lt;title&gt; tags, service-worker log prefixes, internal CSS identifiers (optia-highlight/optia-styles), and rewords the robot/copilot framing toward a score-first concept.

External properties (GitHub repo/remote, Webflow site, Chrome Web Store listing, GitBook docs, Featurebase, Figma file) are intentionally left unchanged and documented as manual-rename TODOs in README.md.

Build passes; 309 tests pass.

Co-Authored-By: Claude Opus 4.8 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/README.md b/README.md
@@ -1,9 +1,22 @@
-# AI SEO Copilot - Chrome Extension
+# Optia - Chrome Extension
 
 A Chrome extension that analyzes web pages for SEO optimization and provides AI-powered recommendations to improve search rankings.
 
 **Website:** https://ai-seo-copilot.webflow.io/
 
+> ⚠️ **Rebrand in progress (AI SEO Copilot → Optia).** The codebase, UI, docs, and package names have been renamed to **Optia**. The items below live on **external systems** and must be renamed/migrated **manually by the project owner** — they were intentionally left unchanged so links don't break before migration:
+>
+> - **GitHub repository & remote URL** — currently `die-Manufaktur/AISEOC-Chrome-Extension`. Rename the repo, update the git remote, then update the links in `docs/` and `app/src/components/Footer.tsx`.
+> - **Marketing website** — `https://ai-seo-copilot.webflow.io/` (Webflow project).
+> - **Chrome Web Store listing** — extension name, description, screenshots, and the public store URL.
+> - **Documentation site** — `ai-seo-copilot.gitbook.io` (referenced in `app/src/lib/docs-links.ts` and `app/src/components/Footer.tsx`).
+> - **Feature-request portal** — `aiseocopilot.featurebase.app` (referenced in `app/src/components/Footer.tsx`).
+> - **Bug-report repo link** — `github.com/PMDevSolutions/seo-copilot` (referenced in `app/src/components/Footer.tsx`).
+> - **Figma design file** — `…/AI-SEO-Copilot-design` (referenced in `app/QA-PROMPT.md`).
+> - **Donation / sponsor links** — none found in the repo; update if any exist outside it.
+>
+> After migrating each external property, update the corresponding URL in `Footer.tsx`, `docs-links.ts`, and the docs to the new Optia domain.
+
 ## Features
 
 - **Real-time SEO Analysis** - Instant scoring for titles, meta descriptions, headings, images, and more
@@ -29,7 +42,7 @@ pnpm build
 ## Project Structure
 
 ```
-ai-seo-copilot-extension/
+optia-extension/
 ├── app/                    # Chrome extension source code
 │   ├── src/                # React + TypeScript source
 │   ├── dist/               # Built extension (load this in Chrome)
diff --git a/app/CHANGELOG.md b/app/CHANGELOG.md
@@ -1,6 +1,6 @@
 # Changelog
 
-All notable changes to AI SEO Copilot will be documented in this file.
+All notable changes to Optia will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
diff --git a/app/PRIVACY_POLICY.md b/app/PRIVACY_POLICY.md
@@ -1,8 +1,8 @@
-# Privacy Policy — AI SEO Copilot
+# Privacy Policy — Optia
 
 **Last updated:** April 1, 2026
 
-AI SEO Copilot is a Chrome browser extension that analyzes web pages for SEO issues and provides recommendations. This privacy policy explains what data the extension accesses, how it is used, and how it is stored.
+Optia is a Chrome browser extension that analyzes web pages for SEO issues and provides recommendations. This privacy policy explains what data the extension accesses, how it is used, and how it is stored.
 
 ## Data the Extension Accesses
 
@@ -53,7 +53,7 @@ No data is stored on external servers. No cookies are set. No analytics or track
 
 ## Data Sharing
 
-AI SEO Copilot does **not**:
+Optia does **not**:
 
 - Collect or transmit personal information
 - Use analytics, telemetry, or tracking of any kind
diff --git a/app/QA-PROMPT.md b/app/QA-PROMPT.md
@@ -1,4 +1,4 @@
-# AI SEO Copilot — Visual QA, Functional Testing & Code Review
+# Optia — Visual QA, Functional Testing & Code Review
 
 ## Your Role
 
@@ -73,7 +73,7 @@ The app uses a strict dark-mode design system. Match these tokens against both F
 #### Screen 1: Setup Page (initial state)
 - Navigate to the dev app URL. This is the default view.
 - **Expected elements:**
-  - Blue circle icon with Settings gear + "AI SEO Copilot" heading
+  - Blue circle icon with Settings gear + "Optia" heading
   - "Dev mode" subtitle
   - "Page URL to Analyze" input (dev mode only)
   - "OpenAI API Key (optional)" password input
@@ -329,7 +329,7 @@ Read the following files and review for correctness, consistency, and bugs:
 Produce your report in this structure:
 
 ```markdown
-# AI SEO Copilot — QA Report
+# Optia — QA Report
 
 ## 1. Visual Comparison
 
diff --git a/app/README.md b/app/README.md
@@ -1,4 +1,4 @@
-# AI SEO Copilot - Chrome Extension
+# Optia - Chrome Extension
 
 A Chrome extension that analyzes web pages for SEO issues and provides AI-powered recommendations to improve search rankings.
 
@@ -46,8 +46,8 @@ You should see something like `9.x.x`
 Clone or download this repository from GitHub:
 
 ```bash
-git clone https://github.com/YOUR-USERNAME/ai-seo-copilot-extension.git
-cd ai-seo-copilot-extension
+git clone https://github.com/YOUR-USERNAME/optia-extension.git
+cd optia-extension
 ```
 
 Or download the ZIP file from GitHub and extract it.
@@ -85,15 +85,15 @@ This creates a `dist` folder with the built extension.
 
 4. Navigate to the `app/dist` folder inside this project and select it
 
-5. The AI SEO Copilot extension icon should appear in your browser toolbar
+5. The Optia extension icon should appear in your browser toolbar
 
 ---
 
 ## Using the Extension
 
 1. Navigate to any website you want to analyze
 
-2. Click the AI SEO Copilot icon in your toolbar (the little robot)
+2. Click the Optia icon in your toolbar
 
 3. Enter your target keyword and click **Analyze**
 
diff --git a/app/dev.html b/app/dev.html
@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <link rel="icon" type="image/svg+xml" href="/icons/icon-32.svg" />
-    <title>AI SEO Copilot — Dev Preview</title>
+    <title>Optia — Dev Preview</title>
     <style>
       body { margin: 0; display: flex; justify-content: center; background: #111; }
       #frame { width: 715px; min-height: 100vh; }
diff --git a/app/manifest.json b/app/manifest.json
@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
-  "name": "AI SEO Copilot",
-  "short_name": "SEO Copilot",
+  "name": "Optia",
+  "short_name": "Optia",
   "description": "Analyze page SEO and get AI-powered recommendations",
   "version": "0.1.0",
   "minimum_chrome_version": "116",
@@ -31,7 +31,7 @@
     "open_in_tab": false
   },
   "action": {
-    "default_title": "Open AI SEO Copilot",
+    "default_title": "Open Optia",
     "default_icon": {
       "16": "icons/icon-16.png",
       "32": "icons/icon-32.png",
diff --git a/app/package.json b/app/package.json
@@ -1,5 +1,5 @@
 {
-  "name": "ai-seo-copilot",
+  "name": "optia",
   "version": "0.1.0",
   "private": true,
   "type": "module",
diff --git a/app/src/background/service-worker.ts b/app/src/background/service-worker.ts
@@ -1,6 +1,6 @@
 import { extractPageDataInline } from "@/lib/extract-page-data-inline";
 
-console.log("[AI SEO Copilot] Service worker initializing...");
+console.log("[Optia] Service worker initializing...");
 
 // Disable automatic panel opening - we'll handle it manually for per-tab scoping
 chrome.sidePanel.setPanelBehavior({ openPanelOnActionClick: false });
@@ -32,7 +32,7 @@ chrome.storage.session.get(PANEL_TABS_KEY).then((result) => {
   const saved = result[PANEL_TABS_KEY] as number[] | undefined;
   if (saved?.length) {
     saved.forEach((id) => panelTabs.add(id));
-    console.log("[AI SEO Copilot] Restored panel tabs:", saved);
+    console.log("[Optia] Restored panel tabs:", saved);
   }
 }).catch(() => {
   // Ignore errors
@@ -56,26 +56,26 @@ async function removePanelTab(tabId: number): Promise<void> {
   await persistPanelTabs();
 }
 
-console.log("[AI SEO Copilot] Service worker initialized successfully");
+console.log("[Optia] Service worker initialized successfully");
 
 // When the user switches tabs, hide the panel unless it was opened on that tab.
 // Only start scoping after the panel has been opened at least once — otherwise
 // the first click after install/reload would be blocked (chicken-and-egg bug).
 chrome.tabs.onActivated.addListener(({ tabId }) => {
-  console.log("[AI SEO Copilot] Tab activated:", tabId, "panelTabs:", Array.from(panelTabs));
+  console.log("[Optia] Tab activated:", tabId, "panelTabs:", Array.from(panelTabs));
   if (panelTabs.size === 0) {
-    console.log("[AI SEO Copilot] panelTabs empty, skipping");
+    console.log("[Optia] panelTabs empty, skipping");
     return;
   }
   if (panelTabs.has(tabId)) {
-    console.log("[AI SEO Copilot] Enabling panel for tab:", tabId);
+    console.log("[Optia] Enabling panel for tab:", tabId);
     chrome.sidePanel.setOptions({
       tabId,
       path: "src/sidepanel/index.html",
       enabled: true,
     });
   } else {
-    console.log("[AI SEO Copilot] Disabling panel for tab:", tabId);
+    console.log("[Optia] Disabling panel for tab:", tabId);
     chrome.sidePanel.setOptions({ tabId, enabled: false });
   }
 });
@@ -89,14 +89,14 @@ chrome.tabs.onRemoved.addListener((tabId) => {
   });
 });
 
-console.log("[AI SEO Copilot] Registering message listener...");
+console.log("[Optia] Registering message listener...");
 
 chrome.runtime.onMessage.addListener((message, _sender, sendResponse) => {
-  console.log("[AI SEO Copilot] Received message:", message.type);
+  console.log("[Optia] Received message:", message.type);
 
   // Ping handler for verifying service worker is responsive
   if (message.type === "PING") {
-    console.log("[AI SEO Copilot] Responding to PING");
+    console.log("[Optia] Responding to PING");
     sendResponse({ pong: true, timestamp: Date.now() });
     return true;
   }
@@ -147,31 +147,31 @@ chrome.runtime.onMessage.addListener((message, _sender, sendResponse) => {
   // (Side panel already tried content script and it failed, so skip that step here)
   if (message.type === "EXTRACT_PAGE_DATA") {
     const tabId = message.tabId as number;
-    console.log("[AI SEO Copilot] EXTRACT_PAGE_DATA for tab:", tabId);
+    console.log("[Optia] EXTRACT_PAGE_DATA for tab:", tabId);
     (async () => {
       try {
         // Inject the analyzer directly via executeScript
-        console.log("[AI SEO Copilot] Executing analyzer script...");
+        console.log("[Optia] Executing analyzer script...");
         const results = await chrome.scripting.executeScript({
           target: { tabId },
           func: extractPageDataInline,
         });
-        console.log("[AI SEO Copilot] executeScript completed, results:", results?.length ?? 0);
+        console.log("[Optia] executeScript completed, results:", results?.length ?? 0);
         const data = results?.[0]?.result;
         if (data) {
-          console.log("[AI SEO Copilot] Sending extracted data back");
+          console.log("[Optia] Sending extracted data back");
           sendResponse({ data });
         } else {
-          console.log("[AI SEO Copilot] No data from executeScript");
+          console.log("[Optia] No data from executeScript");
           sendResponse({ error: "Failed to extract page data" });
         }
       } catch (error) {
-        console.error("[AI SEO Copilot] EXTRACT_PAGE_DATA error:", error);
+        console.error("[Optia] EXTRACT_PAGE_DATA error:", error);
         sendResponse({ error: String(error) });
       }
     })().catch((err) => {
       // Catch any unhandled promise rejections from the async IIFE
-      console.error("[AI SEO Copilot] Unhandled error in EXTRACT_PAGE_DATA:", err);
+      console.error("[Optia] Unhandled error in EXTRACT_PAGE_DATA:", err);
       try {
         sendResponse({ error: String(err) });
       } catch {
diff --git a/app/src/components/Onboarding.tsx b/app/src/components/Onboarding.tsx
@@ -30,9 +30,9 @@ export function Onboarding() {
         </button>
 
         <div className="text-center">
-          <h2 className="text-h2 text-text-primary mb-2">AI SEO Copilot</h2>
+          <h2 className="text-h2 text-text-primary mb-2">Optia</h2>
           <p className="text-body-16 text-text-secondary mb-6">
-            Your AI-powered SEO assistant
+            Instant SEO scores with plain-language fixes
           </p>
         </div>
 
diff --git a/app/src/content/highlighter.ts b/app/src/content/highlighter.ts
@@ -1,5 +1,5 @@
-const HIGHLIGHT_CLASS = "seo-copilot-highlight";
-const STYLE_ID = "seo-copilot-styles";
+const HIGHLIGHT_CLASS = "optia-highlight";
+const STYLE_ID = "optia-styles";
 
 function injectStyles() {
   if (document.getElementById(STYLE_ID)) return;
diff --git a/app/src/options/index.html b/app/src/options/index.html
@@ -3,7 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>AI SEO Copilot — Settings</title>
+    <title>Optia — Settings</title>
   </head>
   <body>
     <div id="root"></div>
diff --git a/app/src/sidepanel/App.tsx b/app/src/sidepanel/App.tsx
@@ -114,7 +114,7 @@ async function sendToServiceWorker<T>(
   for (let attempt = 0; attempt <= retries; attempt++) {
     if (attempt > 0) {
       // Wait before retry to give service worker time to wake up
-      console.log(`[AI SEO Copilot] Retrying service worker message (attempt ${attempt + 1})`);
+      console.log(`[Optia] Retrying service worker message (attempt ${attempt + 1})`);
       await new Promise((r) => setTimeout(r, 500));
     }
 
@@ -188,7 +188,7 @@ async function extractPageData(tabId: number): Promise<PageSEOData> {
   if (swResponse.data) return swResponse.data;
 
   // Fallback: direct executeScript from side panel (may hang in CRXJS dev mode)
-  console.warn("[AI SEO Copilot] Service worker failed, trying direct executeScript:", swResponse.error);
+  console.warn("[Optia] Service worker failed, trying direct executeScript:", swResponse.error);
   try {
     return await directExecuteScript(tabId);
   } catch (directErr) {
@@ -463,7 +463,7 @@ export default function App() {
 
       setView("score");
     } catch (error) {
-      console.error("[AI SEO Copilot] Analysis failed:", error);
+      console.error("[Optia] Analysis failed:", error);
       setError(
         error instanceof Error ? error.message : "Analysis failed",
       );
diff --git a/app/src/sidepanel/index.html b/app/src/sidepanel/index.html
@@ -3,7 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>AI SEO Copilot</title>
+    <title>Optia</title>
   </head>
   <body>
     <div id="root"></div>
diff --git a/docs/chrome-web-store-listing.md b/docs/chrome-web-store-listing.md
@@ -2,7 +2,7 @@
 
 ## Extension Name
 
-AI SEO Copilot
+Optia
 
 ## Short Description
 
@@ -14,7 +14,7 @@ Productivity
 
 ## Detailed Description
 
-AI SEO Copilot analyzes any web page for SEO issues and gives you a clear score with actionable recommendations — powered by AI.
+Optia analyzes any web page for SEO issues and gives you a clear score with actionable recommendations — powered by AI.
 
 Enter your target keyword, click "Optimize my SEO," and instantly see what's working and what needs improvement across your titles, meta descriptions, headings, images, links, structured data, and more. Each check is labeled by priority (High, Medium) so you know exactly where to focus first.
 
@@ -46,7 +46,7 @@ Full privacy policy: https://github.com/die-Manufaktur/AISEOC-Chrome-Extension/b
 
 **FREE & OPEN SOURCE**
 
-AI SEO Copilot is completely free to use and open source. View the source code, report issues, or contribute on GitHub:
+Optia is completely free to use and open source. View the source code, report issues, or contribute on GitHub:
 https://github.com/die-Manufaktur/AISEOC-Chrome-Extension
 
 ## Privacy Policy URL
diff --git a/docs/launch-social-posts.md b/docs/launch-social-posts.md
diff --git a/package.json b/package.json

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`		`- "name": "ai-seo-copilot",`
	`2`	`+ "name": "optia",`
`3`	`3`	`"version": "0.1.0",`
`4`	`4`	`"private": true,`
`5`	`5`	`"type": "module",`