Activity Log

The Activity Log is a basic activity and notification center within Isotop. It operates within a single session and displays key events, warnings, and system messages related to changes in the design system.

How the Activity Log works

The Activity Log captures the most important actions and system states in real time, including:


  • linking and bulk operations,
  • system notifications,
  • warnings about potential issues,
  • conflicts in variable structure.


The log does not persist between sessions and is not intended to be a full change history. This is a deliberate MVP decision — the Activity Log focuses on transparency during the current workflow rather than long-term auditing.

Notifications and warnings

In addition to standard notifications, the Activity Log plays an important role in detecting problematic states within a design system.


For example, in complex or inherited systems, situations may occur where:


  • a core variable references another core variable,
  • a core variable becomes linked to a regular design token,
  • dependency hierarchy rules are violated outside of Isotop.


This can happen when:


  • changes are made directly in Figma,
  • another contributor edits the file,
  • variables are modified without awareness of core variable logic.


Figma’s native tools do not expose the concept or hierarchy of core variables, which makes these issues easy to overlook.

Conflict detection

When Isotop is opened, it analyzes the current state of variables. If conflicting or invalid relationships are detected, the plugin surfaces them through the Activity Log.


The user receives:


  • a clear warning,
  • information about the type of conflict,
  • guidance on how the issue can be resolved.


This makes it possible to quickly restore a valid system state and maintain the integrity of the color architecture.

Purpose of the Activity Log

The Activity Log serves as a foundation for a more transparent and interactive design system workflow. It helps users:


  • understand what is happening to their variables,
  • catch errors and conflicts early,
  • work safely in team environments and complex files.


Even in its minimal MVP form, the Activity Log improves reliability and predictability when working with color systems.

Activity Log — Isotop Plugin for Figma