Skip to content

codezelat/indexmint-chrome-ext

Repository files navigation

IndexMint — SEO & Social Preview Checker

IndexMint is a professional Chrome extension by Codezela Technologies that provides instant SEO audits and social preview checks for any webpage.

✨ Features

🔍 Complete SEO Audit

  • Metadata Analysis — Title tag, meta description, robots, canonical, viewport, language
  • Heading Structure — H1-H6 hierarchy, duplicate detection, empty/long heading warnings
  • Image Accessibility — Alt text coverage, missing alt detection, lazy loading audit
  • Link Analysis — Internal vs external counts, broken anchors, rel attribute detection
  • Schema Detection — JSON-LD parsing, microdata detection, validity checking

📱 Social Preview

  • Google SERP Preview — See how your page appears in Google search results
  • Facebook/LinkedIn Card Preview — See how your page appears when shared on social media
  • Open Graph & Twitter Card Audit — Validate all OG and Twitter meta tags

📊 Scoring Engine

  • 0-100 Score with weighted categories
  • Verdict System — Excellent (75+), Good (60-74), Needs Work (40-59), Poor (<40)
  • Top Fixes — Prioritized list of the most impactful improvements

📤 Export & Share

  • Copy short summary
  • Copy full markdown report
  • Download .md report file
  • Copy top fixes list

🎨 Design

  • Light & Dark theme
  • Professional, minimal UI
  • Collapsible sections with persistent state
  • Animated score visualization

🚀 Installation

Get it on Chrome Web Store

From Source (Developer Mode)

  1. Clone this repository
  2. Run pnpm install
  3. Run pnpm build
  4. Open chrome://extensions/ in Chrome
  5. Enable "Developer mode"
  6. Click "Load unpacked" → select .output/chrome-mv3/

🛠️ Development

Prerequisites

  • Node.js 18+
  • pnpm 8+

Setup

pnpm install

Development Mode

pnpm dev        # Start development server with hot reload

Build

pnpm build      # Production build

Testing

pnpm test       # Run all unit tests
pnpm test:watch # Run tests in watch mode
pnpm test:e2e   # Run e2e tests (requires build first)
pnpm type-check # TypeScript type checking
pnpm lint       # ESLint

🏗️ Architecture

Tech Stack

  • WXT — Modern Chrome extension framework (Manifest V3)
  • React 19 + TypeScript 5.8 — UI components
  • Tailwind CSS v4 — Styling with custom IndexMint theme
  • Vite — Build tooling
  • Vitest — Unit testing
  • Playwright — E2E testing

Project Structure

src/
├── assets/          # Tailwind CSS theme
├── components/      # React UI components (13 components)
├── entrypoints/
│   ├── background.ts    # Service worker (scan orchestrator)
│   ├── page-scanner.ts  # Content script (DOM extraction)
│   └── popup/           # Extension popup UI
├── hooks/           # React hooks (useAudit, useTheme, useStorage)
├── lib/             # Core logic (scoring, extractors, export)
└── types/           # TypeScript type definitions
tests/
├── unit/            # Vitest unit tests (98 tests)
├── e2e/             # Playwright e2e tests
└── fixtures/        # Test HTML fixtures

Extension Message Flow

  1. Popup sends SCAN_PAGE to background service worker
  2. Background injects page-scanner.js into the active tab
  3. Scanner extracts all page data (metadata, social, headings, images, links, schema)
  4. Background runs scoring engine on extracted data
  5. Result sent back to popup for display

Scoring Weights

Category Weight
Metadata 30%
Headings 15%
Social/OG 15%
Images 20%
Links 10%
Schema 10%

🔒 Privacy

IndexMint runs entirely locally in your browser. No data is sent to any server. No analytics. No tracking.

  • ✅ No external network requests
  • ✅ No data collection
  • ✅ No cookies
  • ✅ No third-party services
  • ✅ Minimal permissions (activeTab, scripting, storage)

📄 License

Proprietary — © 2026 Codezela Technologies (Pvt) Ltd. All rights reserved. See LICENSE for details.

🏢 About

Built with ❤️ by Codezela Technologies


IndexMint — Fresh SEO insights, one click away. 🌿

About

Chrome extension that provides instant SEO audits and social preview checks for any webpage.

Resources

License

Contributing

Stars

Watchers

Forks

Contributors