Owner: Engineering Team | Last Updated: 2026-01-30 | Status: Active
The WWAI Chrome Plugin is a browser extension that enables inline text humanization directly from any webpage. Users can select text in their browser and transform it using the WWAI AI humanizer without leaving their current context. The extension authenticates users via an extension token mechanism that integrates with the web app's NextAuth.js session, and all humanization operations are processed through the shared Django REST API backend.
Repository: To be confirmed when codebase is provided
Platform: Google Chrome (Chromium-based browsers)
Manifest Version: To be confirmed (likely Manifest V3)
| Technology | Purpose |
|---|---|
| Chrome Extension APIs | Browser extension framework |
| JavaScript / TypeScript | Extension logic |
| Chrome Storage API | Local token and preference storage |
Draft: Full dependency list and build tooling will be documented when the codebase is analyzed.
| Feature | Description | Status |
|---|---|---|
| Inline Text Humanization | Select text on any webpage and humanize it in-place | Active |
| Authentication | Extension token-based auth linked to web app account | Active |
| Web App Integration | Seamless account sharing with the main WWAI web application | Active |
| Quick Access | Browser action popup for fast humanization access | Active |
Draft: Detailed feature documentation will be created when the Chrome plugin codebase is analyzed.
Chrome Browser
|
+-- Content Script (injected into web pages)
| |-- Text selection handling
| |-- Inline UI overlay for humanization
| |-- Communication with Background Script
|
+-- Background Script (Service Worker)
| |-- API communication with Django backend
| |-- Token management and refresh
| |-- Extension lifecycle management
|
+-- Popup UI
| |-- Quick humanization interface
| |-- Login / account status
| |-- Settings and preferences
|
+-- Options Page (if applicable)
|-- Extension configuration
|-- Account linking
The Chrome extension uses a cookie-based flag mechanism for authentication that integrates with the web app's NextAuth.js configuration:
Web App (NextAuth.js) Chrome Extension
| |
|-- User logs in |
|-- NextAuth session callback |
|-- Sets extension token cookie/flag -----> |
| |-- Reads extension token
| |-- Stores in chrome.storage
| |-- Uses token for API calls
| |
| v
| Django REST API
| (Bearer token auth)
Draft: The exact extension token format, cookie name, and refresh mechanism will be documented when both the web app auth configuration and Chrome extension codebase are analyzed in detail.
Draft: This section will be expanded with implementation details when the codebase is provided.
The Chrome extension communicates with the same Django REST API backend used by all WWAI frontends:
application/json| Endpoint Pattern | Purpose |
|---|---|
/api/feature/humanizer/ |
Text humanization |
/api/user/profile/ |
User profile and credit balance |
/api/user/token/refresh/ |
Token refresh (if applicable) |
Draft: Complete API endpoint mapping will be documented when the codebase is analyzed.
Draft: This section will be updated with project-specific details when the codebase is provided.
| Tool | Purpose |
|---|---|
| Node.js | Build tooling |
| Chrome Browser | Testing and debugging |
| Chrome Developer Mode | Loading unpacked extensions |
# 1. Clone the repository
git clone <repository-url>
cd <chrome-plugin-directory>
# 2. Install dependencies
npm install
# 3. Build the extension
npm run build
# 4. Load in Chrome
# Navigate to chrome://extensions/
# Enable "Developer mode"
# Click "Load unpacked" and select the build output directory
Draft: This section will be updated when the codebase is provided.
Draft: This section will be updated with project-specific deployment details.
| Aspect | Details |
|---|---|
| Distribution | Chrome Web Store |
| Review Process | Google review required for each version |
| Update Mechanism | Auto-update via Chrome Web Store |
| Manifest Version | To be confirmed |
Draft: This section will be populated with common issues and solutions when the codebase is analyzed.
| Issue | Possible Cause | Resolution |
|---|---|---|
| Extension not authenticating | Extension token not set | Log into the web app first to generate the extension token |
| Inline humanization not appearing | Content script blocked | Check if the target site blocks content scripts |
| API calls failing | Token expired | Re-authenticate via the web app |
| Extension not loading | Build errors | Check build output and reload unpacked extension |
| Date | Author | Change |
|---|---|---|
| 2026-01-30 | Admin | Initial creation |
Up: WalterWrites