Skip to content
CAI
Software that uses CAICheck a score

MagicMirrorOrg/MagicMirror

42.2

Weak · 15 November 2026

13.6k

lines of production code

JavaScript

primary language

3

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Expanded language support with new and updated translation files

The application now supports a wider range of languages through the addition of new translation files (including Afrikaans, Arabic, Azerbaijani, Bulgarian, Catalan, Chuvash, Welsh, Esperanto, Gujarati, Hebrew, Hindi, Indonesian, Icelandic, and others) and updates to existing ones. These files provide localized strings for core UI elements such as date formats, weather conditions, module error messages, and update notifications, ensuring the interface is accessible in more languages.

translations · high confidence

Introduce clientonly script for launching Electron client

A new \clientonly/index.js\ script has been added to allow users to start the Electron application by connecting to a remote server. The script accepts command-line arguments (such as \--address\, \--port\, and \--use-tls\) or environment variables to determine the server connection details. It fetches configuration from the specified server URL, validates the port, and then spawns the Electron process, passing the server configuration via an environment variable. The script supports both HTTP and HTTPS connections and handles display server detection (Wayland vs. X11) to ensure the Electron app launches correctly in the current environment.

clientonly · high confidence

Introduce dedicated server-only runtime and file-watcher for standalone server mode

This change adds a new \serveronly\ directory containing \index.js\ and \watcher.js\, establishing a distinct entry point for running the application in server-only mode (without Electron). The \index.js\ file initializes the app and logs the ready status with the correct protocol (HTTP or HTTPS) and address. The \watcher.js\ module provides a file-watching mechanism that monitors source files for changes, automatically restarting the server process via \node ./serveronly\ when updates are detected, including logic to wait for port availability and notify connected clients to reload.

serveronly · high confidence

New default alert and calendar modules added

The MagicMirror² now includes two new default modules: an alert module for displaying notifications and alerts with configurable effects and positions, and a calendar module for displaying events from public iCal calendars. The alert module supports various notification effects (slide, jelly, flip, etc.) and can display welcome messages. The calendar module fetches and displays events from iCal feeds, with support for multiple calendars, event filtering, and customizable display options.

defaultmodules · high confidence

Behavioural changes

Introduces internal alias resolver and refactors core startup logic

The application now uses a new \js/alias-resolver.js\ module to map internal require aliases (such as \logger\ and \node\_helper\) to absolute paths, ensuring consistent resolution across the codebase. This change is integrated into the core startup sequence in \js/app.js\ and the configuration checker \js/check\_config.js\. Additionally, the Electron entry point \js/electron.js\ has been updated to enforce \contextIsolation: true\ and \nodeIntegration: false\ by default for improved security, and the \js/ip\_access\_control.js\ module now implements stricter same-origin checks alongside IP whitelisting to prevent CSRF attacks.

js · high confidence

Major UI overhaul and modernization of the core application shell

The application's core HTML structure has been completely rewritten to support a modern, region-based layout system, replacing the previous static DOM elements with a flexible grid of containers (e.g., \region top bar\, \region middle center\) that allow modules to be positioned dynamically. The entry point for the JavaScript has switched from standard script tags to an ES module (\`type=

(repo-wide) · high confidence

Migration to Husky v6 with npx-based pre-commit hook

The project has migrated to Husky v6, replacing the previous hook implementation with a new executable \.husky/pre-commit\ script. This script now uses \npx lint-staged\ to execute linting on staged files, ensuring the tooling works correctly regardless of whether \lint-staged\ is installed globally or locally in the project.

.husky · high confidence

Redesigns UI with CSS variables and replaces font/icon libraries

The visual presentation is overhauled to use CSS custom properties for colors, font sizes, and spacing, allowing for more consistent theming and easier adjustments. The default font family changes from Helvetica Neue to Roboto and Roboto Condensed, with font files now sourced from the @fontsource/roboto npm package. Additionally, the legacy weather-icons library is removed and replaced by Font Awesome (via @fortawesome/fontawesome-free), updating the icon set used throughout the interface.

css · high confidence

Updated configuration and styling samples for MagicMirror²

The \config/config.js.sample\ has been refreshed to reflect the current default setup, including a default port of 8080, a new \basePath\ configuration for reverse proxy support, and an expanded \ipWhitelist\ that now includes IPv6 loopback addresses. The sample modules have been updated to use the \openmeteo\ weather provider instead of the deprecated OpenWeatherMap, and the calendar module now includes a specific \fetchInterval\ configuration. Additionally, a new \config/custom.css.sample\ file has been added, providing CSS variables for customizing text colors, fonts, and spacing.

config · high confidence

Test coverage

Added E2E test helpers for app lifecycle, basic auth, and weather mocking; Added Electron module tests for Calendar, Compliments, and Weather; Added end-to-end tests for core modules; Added mock data for calendar and newsfeed tests; Added snapshot tests for updatenotification module; Added test configuration files for module testing; Added test configuration files for the newsfeed module; Added test configurations for Spanish clock module variants; Added test configurations for alert module welcome message behavior; Added test configurations for clock module options; Added test configurations for module display and positioning; Added test configurations for the Compliments module; Added test configurations for weather module variants; Added test helpers for Electron app lifecycle and mock weather data injection; Added tests for Electron app environment and development console; Added unit tests for Calendar, Newsfeed, and UpdateNotification modules; Added unit tests for Compliments module and time formatting utility; Added unit tests for core classes and utilities; Added unit tests for core utility functions and modules; Added unit tests for default modules and root path configuration; Added unit tests for the weather module; Expanded end-to-end test coverage for core application features; Expanded test coverage for the Calendar module.

Dependencies

Upgrade to Node 22+ and modernize core dependencies

The platform now requires Node.js 22.22.2 or 24+ and upgrades key runtime libraries, including Express to v5, Helmet to v8, and node-ical to v0.27.2. Development tooling has also been updated to use Vitest for testing and ESLint v10 for linting.

(dependencies) · high confidence

Housekeeping

Added empty modules directory placeholder

An empty .gitkeep file was added to the modules directory to ensure the directory is tracked by version control.

modules · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Baseline

  • First survey — no prior run to compare against. CAI 42.

Lenses

  • Code Health 40
  • Architecture 87
  • Maturity 45
  • Readiness 63
  • Security 43
  • Accessibility 39
  • Performance 60

Changes since last survey

  • 300 commits — 234 feature/other, 66 fixes

By area

  • (root) — 175 commits
  • modules/default — 57 commits
  • (repo) — 30 commits
  • tests/e2e — 10 commits
  • tests/configs — 9 commits
  • css/main.css — 5 commits
  • tests/unit — 4 commits
  • .github/workflows — 3 commits
  • .github/ISSUE_TEMPLATE — 1 commit
  • defaultmodules/weather — 1 commit
  • js/main.js — 1 commit
  • js/node_helper.js — 1 commit
  • tests/electron — 1 commit
  • translations/en.json — 1 commit
  • translations/th.json — 1 commit

Notable commits

  • fix: Fix envcanada hourly forecast time (#3090)
  • fix: Fixed probability of precipitation in weathergov.js (#3195)
  • fix: fix calendar not showing events with the same name and start date but different calendar url (#3166)
  • fix: Bug fix: adding date to the analog clock if showDate is true (#3101)
  • fix: Cross UTC time fix (#3175)
  • fix: Event class bugfix (#3218)
  • fix: Fix API version in yr weather provider call (#3223)
  • fix: Fix async node_helper stopping electron start (#3021)
  • fix: Fix badge status (#2991)
  • fix: Fix badge status (#2991)
  • fix: Fix calendar.js missing default symbol prefix (#3007)
  • fix: Fix empty news feed stopping the feed from ever updating again (#3062)
  • fix: Fix envcanada today pop (#3106)
  • fix: Fix fetchInterval for sample calendar (#3139)
  • fix: Fix import order in serveronly (#3072)
  • fix: Fix ipWhiteList test (#3181)
  • fix: Fix issue #3250: Respect deleted (excluded) calendar events (#3251)
  • fix: Fix jsdoc error
  • fix: Fix jsdoc in calendar
  • fix: Fix missing typeof in calendar module (#3286)
  • …and 280 more

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

MagicMirrorOrg/MagicMirror was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit f138f5b690ceab6450f55c852ac81d268363f563 — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.