bricks_reset_design_system

UtilityAdvancedDestructiveComplexity: 8/10
Reset the entire design system to defaults

Overview

DANGEROUS — Permanently deletes ALL design system data from the Bricks site. This includes color palettes, global classes, class categories, global variables, variable categories, theme styles, and custom fonts. This action cannot be undone.

Requires the exact confirmation phrase "DELETE EVERYTHING" to execute, preventing accidental triggering. Optionally regenerates CSS assets after clearing.

Key Features

Safety confirmation
Requires exact phrase "DELETE EVERYTHING" to prevent accidental execution
Selective clearing
Optional include parameter to clear only specific data types (colors, classes, variables, etc.)
Auto asset regeneration
Optionally regenerates CSS assets after clearing to avoid stale styles

When to Use

Starting completely fresh on a site where the existing design system is unusable
Development/testing environments where you need to reset
When explicitly instructed by the user to clear all design system data
Prerequisites
Explicit user consent — this deletes EVERYTHING
Backup any important design system data first
Understand that all elements referencing deleted classes, variables, and colors will lose their styling

When NOT to Use

On production sites with live content — this is destructive and irreversible
When you only need to delete specific items — use individual delete tools instead
Never use without explicit user confirmation

Parameters

3 Total Parameters1 Required2 Optional
confirm_phrasestringREQUIRED
Must be exactly "DELETE EVERYTHING" to proceed
includearrayoptional
Specific items to clear. If omitted, ALL design system data is cleared.
Values: colors, classes, class_categories, variables, variable_categories, theme_styles, custom_fonts
regenerate_assetsbooleanoptional
Regenerate CSS asset files after clearing
Default: true

Code Examples

Reset everything

Clear all design system data and regenerate assets

JSON
{
    "confirm_phrase": "DELETE EVERYTHING",
    "regenerate_assets": true
}
Response
{"success": true, "cleared": {"colors": 14, "classes": 31, "variables": 21, "theme_styles": 1, "fonts": 0}}

Reset only colors and classes

Selectively clear only colors and classes, keeping variables and theme styles

JSON
{
    "confirm_phrase": "DELETE EVERYTHING",
    "include": [
        "colors",
        "classes",
        "class_categories"
    ]
}
Response
{"success": true, "cleared": {"colors": 14, "classes": 31, "class_categories": 5}}

Common Mistakes

Running reset on a production site without backup
Always backup design system data before resetting. Use bricks_export_variables for variables, and document existing colors/classes

Tips & Warnings

Tips & Warnings

WARNING: This is a destructive, irreversible operation.

  • All elements referencing deleted colors, classes, and variables will lose their styling
  • Use the include parameter to selectively clear only what you need
  • Always back up important data before executing
  • The confirmation phrase prevents accidental execution

Return Values

FieldTypeDescription
successbooleanWhether the reset was executed successfully
clearedobjectCounts of deleted items per category

Related Tools

Technical Details

Tool ID
bricks_reset_design_system
API Endpoint
/bricks-mcp/v1/design-system/reset-all
HTTP Method
POST
Namespace
design-system
Source File
design-system/reset.ts
Version
1.0
Min Bricks Version
1.9
Requires Auth
Yes

Changelog

v1.0
Initial release
20250101