Domain Hopper (Chrome Extension)

Overview

A Chrome Extension that allows you to switch the domain portion (including protocol http/https) while preserving the path portion (e.g.,

/products/123?ref=abc#section

) of the currently open page.

Example: When viewing

https://example.com/app/dashboard?tab=reports

, selecting a registered domain

https://staging.example.org

will open a new tab at:

https://staging.example.org/app/dashboard?tab=reports

Core Features

Pre-register multiple "base URLs (protocol + domain + optional port) without paths"
Display list of candidates in popup or side panel
Extract
```
pathname + search + hash
```
from current tab's location and combine with selected base URL to generate new URL
Open the generated result in a new tab via
```
tabs.create
```
(works across different origins)
(Optional) Display recently used N items at the top / pin favorites

Terminology

Term Description

Base URL

Term	Description
Base URL	Protocol + domain (+ port) only. Examples: `https://example.com` , `http://localhost:5173`
Path Portion	Concatenation of `pathname + search + hash` . Example: `/a/b?x=1#top`
Domain Hopping	The operation of switching to a different registered base URL while preserving the path portion

Protocol + domain (+ port) only. Examples:

https://example.com

http://localhost:5173

Path Portion

Concatenation of

pathname + search + hash

. Example:

/a/b?x=1#top

Domain Hopping The operation of switching to a different registered base URL while preserving the path portion

Specification Details

URL Composition Algorithm (Agent: URLComposer)

Get current tab's
```
location
```

Build

const pathPart = pathname + search + hash

Normalize trailing
```
/
```
if selected
```
base
```
ends with
```
/
```
New URL =
```
base.replace(/\/$/, '') + pathPart
```
Open the generated result in a new tab via
```
tabs.create({ url: newUrl })
```

Persistence (Agent: StorageAgent)

Registered base URL list:
```
chrome.storage.sync
```
(synced across devices)

TypeScript schema definition

interface DomainEntry {
  id: string;            // UUID or nanoid
  label?: string;        // Optional display name
  baseUrl: string;       // Protocol + domain (+ port), no path allowed
  pinned?: boolean;      // Pin flag
  lastUsedAt?: number;   // Unix epoch (ms)
}
interface DomainListState {
  entries: DomainEntry[];
  version: number;       // For migration
}

UI Display (Agent: UIPresenter)

Sort order: pinned descending → lastUsedAt descending → label/baseUrl ascending
Filter: Incremental search (label + baseUrl)
Operations: Click to open in new tab / Right-click to edit / Star icon to toggle pin

Validation (Agent: Validator)

Checks on registration:
- ```
new URL(baseUrl)
```
  does not throw an exception
- ```
pathname === '/'
```
  (no path attached)
- Duplicate baseUrl not allowed
Normalization rules:
- Trailing
```
/
```
  unified to one
- Protocol lowercased
- Domain kept as input (internally lowercased for comparison)

Migration (Agent: MigrationAgent)

Execute migration process if there's a
```
version
```
difference (e.g., populate additional fields)
Generate initial structure if not set

Agent List

Agent Name	Role	Primary Responsibilities
URLComposer	URL Reconstruction	Extract path from current tab + combine with base URL
StorageAgent	Persistence	URL list CRUD / lastUsedAt updates
UIPresenter	UI Generation	Sorting / display / event wiring
Validator	Validation	Input URL syntax, duplication, normalization
MigrationAgent	Data Migration	Structure adjustment on version differences
NavigationAgent	Tab Navigation	`chrome.tabs.create` invocation for new tab and error handling
TelemetryAgent (Future)	Usage Metrics	Operation frequency / success/failure statistics

Edge Cases / Notes

If the same path doesn't exist on the new domain, it may result in a 404 (intended behavior / no handling needed)
Browser may show mixed content warnings when switching between HTTP → HTTPS
Different port numbers mean sessions/cookies won't be available (acceptable by design)
Large volume (> 1000) registrations: may need search + virtual list implementation (not currently expected)
If a URL with a subpath is mistakenly registered, Validator will reject it

Future Enhancement Ideas

Import/Export (JSON) functionality
Domain grouping (environments: prod / staging / dev)
Auto-detect recently opened domains → suggest adding to candidates
Keyboard shortcuts to instantly switch to recent N items
Context menu for single-click re-navigation to "previous alternate domain"
Drag-and-drop sorting (maintain manual order without pinning)

Minimum MVP Requirements Checklist

Domain list CRUD (add / delete / edit)
List display + search
Click to open in new tab (preserving path)
lastUsedAt updates
Validation on add (no path / no duplicates)
Data version embedding

Recommended Directory Structure for Implementation (Reference)

packages/
  storage/        // StorageAgent implementation
  module-manager/ // (Existing) Leverage for agent DI
  shared/         // Type definitions (DomainEntry, etc.)
chrome-extension/src/
  background/     // NavigationAgent (tabs.create)
  ui/             // UIPresenter
  utils/          // Validator / MigrationAgent / URLComposer breakdown

Testing Guidelines

URLComposer: Path extraction + composition patterns (with/without hash/query)

Validator:

http://localhost:3000

OK,

https://example.com/app

NG, duplicates NG

StorageAgent: Full sequence of add → retrieve → update → delete

Security / Privacy

Stored data is domain list only (no personal information)
If usage metrics are added, make it opt-in

In the initial phase, implement only the minimal Agents to satisfy MVP requirements, then build upon them incrementally.

Domain Hopper (Chrome Extension)

Overview

A Chrome Extension that allows you to switch the domain portion (including protocol http/https) while preserving the path portion (e.g.,

/products/123?ref=abc#section

) of the currently open page.

Example: When viewing

https://example.com/app/dashboard?tab=reports

, selecting a registered domain

https://staging.example.org

will open a new tab at:

https://staging.example.org/app/dashboard?tab=reports

Core Features

Pre-register multiple "base URLs (protocol + domain + optional port) without paths"
Display list of candidates in popup or side panel
Extract
```
pathname + search + hash
```
from current tab's location and combine with selected base URL to generate new URL
Open the generated result in a new tab via
```
tabs.create
```
(works across different origins)
(Optional) Display recently used N items at the top / pin favorites

Terminology

Term Description

Base URL

Term	Description
Base URL	Protocol + domain (+ port) only. Examples: `https://example.com` , `http://localhost:5173`
Path Portion	Concatenation of `pathname + search + hash` . Example: `/a/b?x=1#top`
Domain Hopping	The operation of switching to a different registered base URL while preserving the path portion

Protocol + domain (+ port) only. Examples:

https://example.com

http://localhost:5173

Path Portion

Concatenation of

pathname + search + hash

. Example:

/a/b?x=1#top

Domain Hopping The operation of switching to a different registered base URL while preserving the path portion

Specification Details

URL Composition Algorithm (Agent: URLComposer)

Get current tab's
```
location
```

Build

const pathPart = pathname + search + hash

Normalize trailing
```
/
```
if selected
```
base
```
ends with
```
/
```
New URL =
```
base.replace(/\/$/, '') + pathPart
```
Open the generated result in a new tab via
```
tabs.create({ url: newUrl })
```

Persistence (Agent: StorageAgent)

Registered base URL list:
```
chrome.storage.sync
```
(synced across devices)

TypeScript schema definition

interface DomainEntry {
  id: string;            // UUID or nanoid
  label?: string;        // Optional display name
  baseUrl: string;       // Protocol + domain (+ port), no path allowed
  pinned?: boolean;      // Pin flag
  lastUsedAt?: number;   // Unix epoch (ms)
}
interface DomainListState {
  entries: DomainEntry[];
  version: number;       // For migration
}

UI Display (Agent: UIPresenter)

Sort order: pinned descending → lastUsedAt descending → label/baseUrl ascending
Filter: Incremental search (label + baseUrl)
Operations: Click to open in new tab / Right-click to edit / Star icon to toggle pin

Validation (Agent: Validator)

Checks on registration:
- ```
new URL(baseUrl)
```
  does not throw an exception
- ```
pathname === '/'
```
  (no path attached)
- Duplicate baseUrl not allowed
Normalization rules:
- Trailing
```
/
```
  unified to one
- Protocol lowercased
- Domain kept as input (internally lowercased for comparison)

Migration (Agent: MigrationAgent)

Execute migration process if there's a
```
version
```
difference (e.g., populate additional fields)
Generate initial structure if not set

Agent List

Agent Name	Role	Primary Responsibilities
URLComposer	URL Reconstruction	Extract path from current tab + combine with base URL
StorageAgent	Persistence	URL list CRUD / lastUsedAt updates
UIPresenter	UI Generation	Sorting / display / event wiring
Validator	Validation	Input URL syntax, duplication, normalization
MigrationAgent	Data Migration	Structure adjustment on version differences
NavigationAgent	Tab Navigation	`chrome.tabs.create` invocation for new tab and error handling
TelemetryAgent (Future)	Usage Metrics	Operation frequency / success/failure statistics

Edge Cases / Notes

If the same path doesn't exist on the new domain, it may result in a 404 (intended behavior / no handling needed)
Browser may show mixed content warnings when switching between HTTP → HTTPS
Different port numbers mean sessions/cookies won't be available (acceptable by design)
Large volume (> 1000) registrations: may need search + virtual list implementation (not currently expected)
If a URL with a subpath is mistakenly registered, Validator will reject it

Future Enhancement Ideas

Import/Export (JSON) functionality
Domain grouping (environments: prod / staging / dev)
Auto-detect recently opened domains → suggest adding to candidates
Keyboard shortcuts to instantly switch to recent N items
Context menu for single-click re-navigation to "previous alternate domain"
Drag-and-drop sorting (maintain manual order without pinning)

Minimum MVP Requirements Checklist

Domain list CRUD (add / delete / edit)
List display + search
Click to open in new tab (preserving path)
lastUsedAt updates
Validation on add (no path / no duplicates)
Data version embedding

Recommended Directory Structure for Implementation (Reference)

packages/
  storage/        // StorageAgent implementation
  module-manager/ // (Existing) Leverage for agent DI
  shared/         // Type definitions (DomainEntry, etc.)
chrome-extension/src/
  background/     // NavigationAgent (tabs.create)
  ui/             // UIPresenter
  utils/          // Validator / MigrationAgent / URLComposer breakdown

Testing Guidelines

URLComposer: Path extraction + composition patterns (with/without hash/query)

Validator:

http://localhost:3000

OK,

https://example.com/app

NG, duplicates NG

StorageAgent: Full sequence of add → retrieve → update → delete

Security / Privacy

Stored data is domain list only (no personal information)
If usage metrics are added, make it opt-in

In the initial phase, implement only the minimal Agents to satisfy MVP requirements, then build upon them incrementally.

Domain Hopper (Chrome Extension)

Domain Hopper (Chrome Extension)

Overview

Core Features

Terminology

Specification Details

URL Composition Algorithm (Agent: URLComposer)

Persistence (Agent: StorageAgent)

UI Display (Agent: UIPresenter)

Validation (Agent: Validator)

Migration (Agent: MigrationAgent)

Agent List

Edge Cases / Notes

Future Enhancement Ideas

Minimum MVP Requirements Checklist

Recommended Directory Structure for Implementation (Reference)

Testing Guidelines

Security / Privacy

Related Skills

Markdown Converter

Nano Banana Pro

1password

Domain Hopper (Chrome Extension)

Overview

Core Features

Terminology

Specification Details

URL Composition Algorithm (Agent: URLComposer)

Persistence (Agent: StorageAgent)

UI Display (Agent: UIPresenter)

Validation (Agent: Validator)

Migration (Agent: MigrationAgent)

Agent List

Edge Cases / Notes

Future Enhancement Ideas

Minimum MVP Requirements Checklist

Recommended Directory Structure for Implementation (Reference)

Testing Guidelines

Security / Privacy