# Swiftui View Refactor

Adopt this skill: https://proskills.md/skills/other/swiftui-view-refactor

Page: https://proskills.md/skills/other/swiftui-view-refactor
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 8009

```text
SwiftUI View Refactor

Attribution: copied from @Dimillian’s Dimillian/Skills
 (2025-12-31).

Overview

Apply a consistent structure and dependency pattern to SwiftUI views, with a focus on ordering, Model-View (MV) patterns, careful view model handling, and correct Observation usage.

Core Guidelines

1) View ordering (top → bottom)

Environment

private
/public
 let

@State
 / other stored properties

computed var
 (non-view)

init

body

computed view builders / other view helpers

helper / async functions

2) Prefer MV (Model-View) patterns

Default to MV: Views are lightweight state expressions; models/services own business logic.

Favor @State
, @Environment
, @Query
, and task
/onChange
 for orchestration.

Inject services and shared models via @Environment
; keep views small and composable.

Split large views into subviews rather than introducing a view model.

3) Split large bodies and view properties

If body
 grows beyond a screen or has multiple logical sections, split it into smaller subviews.

Extract large computed view properties (var header: some View { ... }
) into dedicated View
 types when they carry state or complex branching.

It's fine to keep related subviews as computed view properties in the same file; extract to a standalone View
 struct only when it structurally makes sense or when reuse is intended.

Prefer passing small inputs (data, bindings, callbacks) over reusing the entire parent view state.

Example (extracting a section):

swiftvar body: some View {
    VStack(alignment: .leading, spacing: 16) {
        HeaderSection(title: title, isPinned: isPinned)
        DetailsSection(details: details)
        ActionsSection(onSave: onSave, onCancel: onCancel)
    }
}

Example (long body → shorter body + computed views in the same file):

swiftvar body: some View {
    List {
        header
        filters
        results
        footer
    }
}

private var header: some View {
    VStack(alignment: .leading, spacing: 6) {
        Text(title).font(.title2)
        Text(subtitle).font(.subheadline)
    }
}

private var filters: some View {
    ScrollView(.horizontal, showsIndicators: false) {
        HStack {
            ForEach(filterOptions, id: \.self) { option in
                FilterChip(option: option, isSelected: option == selectedFilter)
                    .onTapGesture { selectedFilter = option }
            }
        }
    }
}

Example (extracting a complex computed view):

swiftprivate var header: some View {
    HeaderSection(title: title, subtitle: subtitle, status: status)
}

private struct HeaderSection: View {
    let title: String
    let subtitle: String?
    let status: Status

    var body: some View {
        VStack(alignment: .leading, spacing: 4) {
            Text(title).font(.headline)
            if let subtitle { Text(subtitle).font(.subheadline) }
            StatusBadge(status: status)
        }
    }
}

4) View model handling (only if already present)

Do not introduce a view model unless the request or existing code clearly calls for one.

If a view model exists, make it non-optional when possible.

Pass dependencies to the view via init
, then pass them into the view model in the view's init
.

Avoid bootstrapIfNeeded
 patterns.

Example (Observation-based):

swift@State private var viewModel: SomeViewModel

init(dependency: Dependency) {
    _viewModel = State(initialValue: SomeViewModel(dependency: dependency))
}

5) Observation usage

For @Observable
 reference types, store them as @State
 in the root view.

Pass observables down explicitly as needed; avoid optional state unless required.

Workflow

Reorder the view to match the ordering rules.

Favor MV: move lightweight orchestration into the view using @State
, @Environment
, @Query
, task
, and onChange
.

If a view model exists, replace optional view models with a non-optional @State
 view model initialized in init
 by passing dependencies from the view.

Confirm Observation usage: @State
 for root @Observable
 view models, no redundant wrappers.

Keep behavior intact: do not change layout or business logic unless requested.

Notes

Prefer small, explicit helpers over large conditional blocks.

Keep computed view builders below body
 and non-view computed vars above init
.

For MV-first guidance and rationale, see references/mv-patterns.md
.

Read more

Downloads

Security auditPass

Last updated4mo ago
Current versionv1.0.0

LicenseMIT-0
Report

Bookmark6
Downloads

Security auditPass

Last updated4mo ago
Current versionv1.0.0

LicenseMIT-0
Report

 ClawHubSkills and plugins for OpenClaw agents. Part of the wider OpenClaw ecosystem.
Explore docs
Browse
SkillsPluginsOfficialAudits

Publish
Publish SkillPublish PluginCreate org

Ecosystem
OverviewOpenClawDocsBlog

Community
GitHubDiscord

Built alongside the OpenClaw ecosystem
LobsterCrabboxClickClackCrabfleetOctopoolClawSweeperagent-skillsdiscrawlgitcrawlslacrawlnotcrawltelecrawlgraincrawlcrawlkitcrawlbaracpxmcporterTachikomaclawpatchclawbenchPeekaboocookbookplugin-inspectorwacrawlcrabpotAll projectsLobsterCrabboxClickClackCrabfleetOctopoolClawSweeperagent-skillsdiscrawlgitcrawlslacrawlnotcrawltelecrawlgraincrawlcrawlkitcrawlbaracpxmcporterTachikomaclawpatchclawbenchPeekaboocookbookplugin-inspectorwacrawlcrabpotAll projects

© 2026 OpenClaw Foundation
Status·Deployed on Vercel·Powered by Convex

....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-co
```
