Iris

Config StudioNew

Config Studio is a visual editor in your account dashboard for building and syncing .irisconfig.json to VS Code without touching a file manually. Free users can pick a preset and sync it in one click. Pro users get the full studio with custom thresholds, detections, diagnostics, severity overrides, and custom scoring weights.

BalancedStrictLegacySecurityTypescriptcustom

A balanced default.

Sane thresholds for a typical TypeScript codebase. Catches the common issues without burying you in warnings.

DEFAULT
console.log warnings✓
magic-number detection−
return-type warnings✓
secrets detection✓
TODO detection✓
long-param detection✓
unused detection✓
inline diagnostics✓
minHealthScoregate threshold
70
hardcodedSecretscore penalty
-10 pts
Opens .irisconfig.json in your editor

What the studio contains

  • Preset selector — choose from Balanced, Strict, Legacy, Security, TypeScript, or switch to Custom mode to edit every value individually.
  • Detection matrix — see at a glance which rules are on or off for the selected preset.
  • minHealthScore bar — the gate threshold used by the CLI and hooks is always visible at the top of the card.
  • Gate limits (Pro, Custom mode) — hard caps on secrets count, max file length, max complexity, and smells per file. Leave a field empty to impose no workspace-wide limit.
  • Custom scoring (Pro, Custom mode) — control exactly how many points each finding type deducts from the base 100 score. See Scoring Weights.
  • Live JSON preview — the right panel updates as you change values, showing the exact .irisconfig.json that will be written.

Syncing to VS Code

The sync flow is designed to never write silently. Every sync opens a diff in VS Code first:

  1. 1.Open Account → Config in the browser.
  2. 2.Choose a preset or switch to Custom mode and tune individual values.
  3. 3.Click Sync to VS Code.
  4. 4.VS Code opens and shows a diff preview of the exact changes to your .irisconfig.json.
  5. 5.Confirm the write — or cancel with no changes made.
Note: The sync token is short-lived and single-use. If VS Code does not open within a few seconds, check that you have the Iris extension installed and that VS Code is running.

Write targets

  • Workspace — writes to the project root .irisconfig.json. Available to all users. Commit it and the whole team runs the same config.
  • Global default (Pro) — writes to your personal default config path so every new project on the machine starts with the same settings. Useful for personal standards you maintain across repositories.
Tip: If your team uses a monorepo, sync a Workspace config to each package root that needs different thresholds. The extension resolves config by walking up the directory tree — the nearest .irisconfig.json wins.

Using a preset without Config Studio

You do not need the dashboard to use a preset. Create a .irisconfig.json at your project root and add one line:

{ "presetId": "balanced" }

All five preset IDs are: legacy, balanced, typescript, strict, security. Commit the file and every developer on the team picks up the same thresholds automatically.

Free vs Pro

Free — pick any preset, preview the resulting JSON, and sync to Workspace. The preset values are fixed and cannot be overridden locally — editing them produces a yellow warning squiggle in the editor.

Pro — start from any preset and override individual threshold values, detections, diagnostic categories, severity overrides, custom scoring weights, and gate limits. Custom mode gives you full control over every key. Global default write target is also Pro-only.