Skip to content

Repository files navigation

SiteAudit Pro

A privacy-focused browser extension built by FarhanCodeSpace for auditing Accessibility, Performance, and SEO directly from the active webpage.

Version Manifest License


Overview

SiteAudit Pro by FarhanCodeSpace is a browser audit tool designed for web developers, accessibility advocates, and digital marketers who need fast, on-demand audits of active web pages. Built on Chrome Manifest V3, SiteAudit Pro operates entirely locally within your browser, delivering instant scores, actionable diagnostic findings, and printable PDF reports without requiring accounts, remote API keys, or external server dependencies.


Feature Overview

  • Accessibility Auditing - Instant scans powered by the bundled axe-core engine testing against WCAG 2.0, 2.1, and 2.2 rules.
  • Performance Analysis - Real-world metric collection using native browser Performance APIs (FCP, LCP, CLS, TTFB, page weight, DOM size, and resource breakdowns).
  • Page-Level SEO Checks - Automated verification of search engine metadata, document structure, heading hierarchy, Open Graph tags, and mobile readiness.
  • Unified & Category Scores - 0 to 100 heuristic scoring for each category alongside an overall weighted health score.
  • Detailed Audit Reports - Comprehensive HTML report featuring diagnostic breakdowns, affected code snippets, and remediation recommendations.
  • Print & PDF Export - CSS-optimized printable report format for saving or sharing audit deliverables.
  • Local Audit History - Automatic local retention of past 20 audits for tracking improvements across sessions.
  • Local-First & Privacy-Focused - Zero data collection, zero tracking, and zero remote code execution.

Audit Categories

1. Accessibility (a11y)

Powered by the bundled axe-core accessibility engine:

  • Violations: Confirmed WCAG standard failures (WCAG 2.0/2.1/2.2 Level A/AA and best practices).
  • Incomplete / Needs Review: Potential issues requiring manual human verification.
  • Affected Elements: Inspect selector paths and raw HTML code snippets (up to 3 samples per finding).
  • Impact Severity: Findings classified as critical, serious, moderate, or minor.
  • Accessibility Score: Calculated from 100 with weighted deductions per violation and incomplete item.

2. Performance

Captured directly from Chrome's native PerformanceObserver and performance.getEntriesByType() APIs:

  • First Contentful Paint (FCP): Time until the first DOM content is rendered.
  • Largest Contentful Paint (LCP): Render time of the largest content element.
  • Cumulative Layout Shift (CLS): Visual stability score measuring unexpected layout shifts.
  • Time to First Byte (TTFB): Server responsiveness and initial network latency.
  • DOM & Load Timing: Exact timestamps for DOMContentLoaded and Page Load events.
  • DOM Size: Total DOM node count (document.querySelectorAll('*')).
  • Resource Count & Transfer Weight: Total HTTP requests and total network transfer size (in KB/MB).
  • Resource Breakdown: Transfer size breakdown across JavaScript, CSS, Images, Fonts, and other assets.
  • Large Resource Identifiers: Highlights top network assets exceeding 100 KB transfer size.

3. Page-Level SEO

Heuristic DOM inspection covering key search engine optimization criteria:

  • Page Title: Checks presence and optimal length (10 to 70 characters).
  • Meta Description: Evaluates presence and recommended length (50 to 160 characters).
  • Viewport Meta Tag: Verifies mobile-responsiveness configuration.
  • HTML Language Attribute: Confirms presence of <html lang="..."> for screen readers and regional indexing.
  • Canonical URL: Checks <link rel="canonical"> presence and valid href attributes.
  • H1 Heading: Verifies that exactly one non-empty <h1> tag exists on the page.
  • Heading Hierarchy: Detects skipped heading levels (e.g. <h1> followed directly by <h3>) and empty heading tags.
  • Image Alt Attributes: Identifies <img> elements missing alt attributes entirely.
  • Open Graph Metadata: Checks social sharing tags (og:title, og:description, og:image).
  • Robots Meta Tag: Detects indexing restrictions such as noindex directives.

Scoring Methodology

Important Note on Scores: SiteAudit Pro uses its own transparent, heuristic scoring system (0 to 100). The scores produced are NOT official Google Lighthouse scores, Google Search rankings, or certified WCAG compliance certificates.

Category Weighting

The overall SiteAudit Pro score is calculated as a weighted average: $$\text{Overall Score} = (\text{Accessibility} \times 0.35) + (\text{Performance} \times 0.35) + (\text{SEO} \times 0.30)$$

Scoring Rules

Accessibility Score (0 to 100)

Starts at 100. Deductions are applied based on rule impact severity and affected element count:

$$\text{Violation Penalty} = \text{Impact Weight} \times \min(\text{Affected Nodes}, 5)$$

Severity Impact Base Weight per Violation
Critical 10 pts
Serious 6 pts
Moderate 3 pts
Minor 1 pt
  • Incomplete Checks: Apply 30% of the standard violation penalty (unconfirmed items).
  • Penalty Cap: Total accessibility penalty is capped at 100 points (minimum score: 0).

Performance Score (0 to 100)

Starts at 100. Points are deducted based on Web Vitals performance thresholds:

Metric Good Threshold Poor Threshold Needs Improvement Penalty Poor Penalty
FCP $\le 1800\text{ ms}$ $&gt; 3000\text{ ms}$ $-10\text{ pts}$ $-20\text{ pts}$
LCP $\le 2500\text{ ms}$ $&gt; 4000\text{ ms}$ $-12\text{ pts}$ $-25\text{ pts}$
CLS $\le 0.10$ $&gt; 0.25$ $-10\text{ pts}$ $-20\text{ pts}$
TTFB $\le 800\text{ ms}$ $&gt; 1800\text{ ms}$ $-7\text{ pts}$ $-15\text{ pts}$

SEO Score (0 to 100)

Starts at 100. Points are deducted per failed check:

  • Errors: $-15\text{ pts}$ per failed critical check.
  • Warnings: $-5\text{ pts}$ per failed warning check.

User Workflow & Usage

  1. Open SiteAudit Pro: Click the extension icon in your Chrome toolbar on any active web page.
  2. Review Header Status: The extension displays the current domain name and execution status.
  3. Run Audit: Click Audit This Page. Real-time step progress indicators display accessibility, performance, and SEO checks.
  4. View Immediate Summary: Within seconds, view your overall score alongside category scores for Accessibility, Performance, and SEO.
  5. Inspect Full Report: Click View Full Report to open a detailed breakdown in a new tab.
  6. Print or Save PDF: Click Print / Save PDF inside the report tab to open Chrome's print dialog and select Save to PDF.
  7. Review Audit History: Access past audit records at any time via the extension popup or options page.

Project Structure

siteaudit-pro/
├── icons/
│   ├── icon16.png           # 16x16 extension icon
│   ├── icon48.png           # 48x48 extension icon
│   └── icon128.png          # 128x128 extension icon
├── lib/
│   └── axe.min.js           # Pre-bundled axe-core library
├── .gitignore               # Git ignore rules
├── README.md                # Project documentation
├── manifest.json            # MV3 configuration & permissions
├── background.js            # Service worker for tab management
├── content.js               # Injected audit runner (axe, perf, SEO)
├── scoring.js               # Centralized 0-100 scoring engine
├── popup.html               # Extension popup HTML structure
├── popup.js                 # Popup logic & state management
├── popup.css                # Popup styling & responsive gauges
├── report.html              # Full report page HTML structure
├── report.js                # Report rendering, filtering & XSS safety
├── report.css               # Report layout & print stylesheet
├── history.html             # Audit history viewer HTML
├── history.js               # History retrieval & rendering
├── history.css              # History tab styling
├── options.html             # Extension settings & privacy HTML
├── options.js               # Options page actions & storage clearing
└── options.css              # Options page stylesheet

Brand Architecture & Credits

  • Hero Product: SiteAudit Pro
  • Product Descriptor: Browser Audit Tool
  • Creator Identity: Built by FarhanCodeSpace

About

Privacy-focused browser extension for Accessibility, Performance, and SEO auditing.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages