@hydration-tracker/core

Core hydration tracking functionality for measuring React SSR hydration costs. Framework agnostic.

Installation

npm install @hydration-tracker/core

Usage

import { createTracker } from '@hydration-tracker/core';

const tracker = createTracker();
tracker.start();

// ... your app hydrates ...

const data = tracker.stop();
console.log(data.hydrationScore); // 0-100
console.log(data.totalHydrationTime); // in milliseconds
console.log(data.components); // per-component breakdown

API

createTracker(options?)

Creates a new hydration tracker instance.

Options

• threshold - Minimum hydration time (ms) to track a component (default: 1)

Tracker Methods

• start() - Begin tracking hydration
• stop() - Stop tracking and return collected data
• trackComponent(name, startTime, endTime) - Manually track a component's hydration

Return Data

interface HydrationData {
  hydrationScore: number;      // 0-100 score
  totalHydrationTime: number;  // Total time in ms
  components: ComponentData[]; // Per-component breakdown
}

License

MIT