settings-system

Consolidate and manage application settings across the Matrx settings system.

2|1|Updated Aug 24, 2024
One-click install
npx skills add https://github.com/armanisadeghi/ai-matrx --skill settings-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: settings-system
Source: https://github.com/armanisadeghi/ai-matrx/tree/main/.cursor/skills/settings-system
Command: npx skills add https://github.com/armanisadeghi/ai-matrx --skill settings-system

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Single source of truth for adding, editing, or migrating settings in the Matrx settings system. Use when adding a new preference, creating a settings tab, binding a new Redux slice, wiring a deep link, or touching anything under features/settings, components/official/settings, or the old components/user-preferences folder. Covers primitives, useSetting, the registry, admin gating, persistence tiers, and mobile parity.

Core Features & Use Cases

  • Establishes a central registry for settings tabs and primitives; ensures consistent behavior across desktop and mobile.
  • Supports creating settings tabs, binding Redux slices, and wiring deep links that reference settings.
  • Enforces admin gating, persistence tier choices, and mobile parity to ensure safe, scalable configuration across the app.

Quick Start

Create a new settings tab wired to an existing settings slice and ensure it appears in the Settings shell.

Frequently Asked Questions about settings-system

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new preference to the Matrx settings system?

To add a new preference, use the Matrx settings primitives and the central registry to ensure a single source of truth. You must wire the corresponding Redux slice and configure the appropriate persistence tier.

How do I create a settings tab and wire it to a Redux slice?

Creating a settings tab involves registering it within the Matrx settings shell and binding it to an existing Redux slice. This ensures the tab correctly reads and writes preferences through the central registry.

What is the single source of truth for managing application settings?

The single source of truth for application settings is a centralized registry system that consolidates primitives, admin gating, and persistence tiers. This prevents fragmentation across desktop and mobile environments.

How do I migrate legacy user-preferences to the new settings components?

Migrating legacy user-preferences involves moving configurations from the old components/user-preferences folder to the features/settings and components/official/settings directories using the new registry and primitives.

Does the settings system support admin gating and mobile parity?

Yes, the settings system enforces admin gating to restrict access and maintains mobile parity to ensure consistent configuration behavior and UI across both desktop and mobile platforms.

What is the best way to manage settings persistence tiers across features?

The best way to manage persistence tiers is by using the Settings primitives to define persistence levels within the central registry, ensuring scalable and safe configuration across all application features.