i-Ready Diagnostic Score Trend Chart

WHAT IT DOES

i-Ready Diagnostic Score Trend Chart scans the current page for i-Ready diagnostic test scores, percentile rankings, and subject area performance data. It extracts overall scale scores, national percentiles, and subject-specific scores (Reading, Math, Language, etc.) from student reports and dashboards. The floating panel displays visual trend charts showing score progression across multiple test sessions, subject comparison bars, and percentile rankings. Manual data entry allows users to add older test scores to build complete trend lines. Areas of growth and those needing improvement are highlighted with color-coded indicators, and data can be exported as CSV or formatted text for tracking and sharing.

WHERE IT RUNS

Works on any web page, including i-Ready student dashboards, diagnostic reports, and parent portals. The script intelligently detects i-Ready-specific elements including scale scores, percentile ranks, and subject breakdowns. It works best on i-Ready.com and related educational platforms but also supports manual entry for data from printed reports or older sessions.

HOW TO USE

The panel displays a visual trend chart showing score progression across all saved diagnostic sessions. Each subject appears as a separate mini-chart with bar indicators for each test date. Use "Scan Page" to automatically detect and add scores from the current i-Ready page. For older tests or scores not displayed on the page, use the manual entry section to input date and subject scores. The panel shows a summary of total tests, latest date, earliest date, and growth per subject. Export data as CSV for spreadsheet analysis or as formatted text for sharing with teachers and parents. Customize subject order and chart preferences in the settings section.

MECHANISM — SCORE EXTRACTION WITH PERSISTENT TREND TRACKING

The script uses targeted CSS selectors to extract i-Ready-specific elements including .score, .diagnostic-score, .scale-score, .subject-score, and .percentile. It also performs text-based extraction to find scores in page content when standard selectors fail. All extracted data is stored locally with date stamps, allowing the script to build trend lines across multiple sessions. The trend chart calculates growth metrics by comparing the earliest and latest scores for each subject, providing a clear picture of academic progress. The manual entry system uses date validation and score range checking to ensure data quality.

THE PANEL

The floating panel is fully draggable and remembers its position per domain. Click the minimize button to collapse it to a small bubble, or press Escape to hide it. The panel automatically adjusts to different screen sizes and can be resized to show more content. All settings, including subject order and chart display preferences, are saved per domain. The panel integrates smoothly with any page layout using the BGPanel framework, maintaining clean separation from page content.

PLEASE NOTE

This script requires the free BotGentz extension to run. It does not send any data to external servers; all extracted scores, trends, and settings remain entirely local to your browser using GM_setValue. The script never reads password fields, hidden inputs, or file inputs. It stores only diagnostic scores, dates, and subject data from publicly visible page content, along with manually entered scores. Data extraction depends on the page structure; if scores are not detected, use the manual entry feature. Data persists across browser sessions and is isolated per browser profile.