# `mix phoenix_kit.modernize_layouts`
[🔗](https://github.com/BeamLabEU/phoenix_kit/blob/v1.7.165/lib/mix/tasks/phoenix_kit.modernize_layouts.ex#L1)

Modernizes PhoenixKit layout integration for Phoenix v1.8+ compatibility.

This task performs automatic migration of existing PhoenixKit installations
to support both Phoenix v1.7- and v1.8+ layout systems seamlessly.

## What it does

1. **Detects Phoenix version** - Automatically detects your Phoenix version
2. **Updates configuration** - Modernizes layout configuration in config.exs
3. **Migrates templates** - Updates any existing PhoenixKit templates
4. **Adds LayoutWrapper** - Ensures LayoutWrapper component is available
5. **Validates compatibility** - Tests the new setup

## Usage

    mix phoenix_kit.modernize_layouts

## Options

    --dry-run         Show what would be changed without making changes
    --force           Force migration even if already modernized
    --verbose         Show detailed output during migration
    --backup          Create backup of modified files
    --skip-templates  Skip template migration (config only)

## Examples

    # Standard migration with backup
    mix phoenix_kit.modernize_layouts --backup

    # See what would be changed without modifying files
    mix phoenix_kit.modernize_layouts --dry-run

    # Force re-migration with detailed output
    mix phoenix_kit.modernize_layouts --force --verbose

The migration is idempotent - safe to run multiple times.

---

*Consult [api-reference.md](api-reference.md) for complete listing*