# SnapKit — Auto Layout DSL for iOS and macOS

> A Swift DSL that makes Auto Layout constraints easy and readable, replacing verbose NSLayoutConstraint code with a concise chainable syntax for iOS and macOS development.

## Install

Save as a script file and run:

# SnapKit — Auto Layout DSL for iOS and macOS

## Quick Use
```swift
import SnapKit

let box = UIView()
view.addSubview(box)

box.snp.makeConstraints { make in
    make.top.equalTo(view.safeAreaLayoutGuide)
    make.leading.trailing.equalToSuperview().inset(16)
    make.height.equalTo(200)
}
```

## Introduction
SnapKit is a Swift DSL (Domain Specific Language) that simplifies Apple's Auto Layout API. Instead of writing verbose NSLayoutConstraint code or wrestling with Interface Builder, developers express layout constraints using a readable, chainable closure syntax that reduces boilerplate and makes programmatic UI layout maintainable.

## What SnapKit Does
- Provides a closure-based DSL for creating Auto Layout constraints in code
- Supports all constraint attributes: edges, size, center, baseline, and margins
- Allows updating and remaking constraints with snp.updateConstraints and snp.remakeConstraints
- Handles translatesAutoresizingMaskIntoConstraints automatically
- Works with both UIKit (iOS/tvOS) and AppKit (macOS) views

## Architecture Overview
SnapKit wraps each UIView/NSView with a ConstraintViewDSL (accessed via .snp) that creates a ConstraintMaker inside a closure. Each chained call builds a ConstraintDescription with target attribute, relation, and constant. When the closure completes, descriptions are compiled into actual NSLayoutConstraint objects and activated on the appropriate view in the hierarchy.

## Self-Hosting & Configuration
- Install via Swift Package Manager or CocoaPods: pod 'SnapKit', '~> 5.7'
- Import SnapKit in any file where you build constraints programmatically
- Use snp.makeConstraints for initial setup in viewDidLoad or init
- Call snp.updateConstraints inside animation blocks for animated layout changes
- Enable debug labels with snp.makeConstraints to trace unsatisfiable constraint logs

## Key Features
- Chainable syntax: make.top.leading.trailing.equalToSuperview()
- Priority support via .priority(.high) or custom numeric values
- Offset and inset helpers for common padding patterns
- Multiplier support for proportional sizing: make.width.equalToSuperview().multipliedBy(0.5)
- Safe area and layout margin guide support built-in

## Comparison with Similar Tools
- **NSLayoutConstraint (native)** — verbose and error-prone; SnapKit reduces constraint code by 60-80%
- **Interface Builder** — visual but hard to review in git; SnapKit keeps layouts in code
- **Cartography** — similar DSL using operator overloading; SnapKit uses closures for clarity
- **SwiftUI Layout** — declarative but UIKit-only apps still need SnapKit for programmatic constraints

## FAQ
**Q: Can I animate constraint changes with SnapKit?**
A: Yes, call snp.updateConstraints inside UIView.animate and then call layoutIfNeeded().

**Q: Does SnapKit work with UIScrollView?**
A: Yes, constrain the content view edges to the scroll view's contentLayoutGuide for proper scrolling.

**Q: How do I debug unsatisfiable constraints?**
A: SnapKit prints readable labels in console logs. Add .labeled("myConstraint") for custom identifiers.

**Q: Is SnapKit compatible with SwiftUI?**
A: SnapKit is for UIKit/AppKit views. In mixed apps, use UIViewRepresentable to bridge SnapKit-based views into SwiftUI.

## Sources
- https://github.com/SnapKit/SnapKit
- https://snapkit.io/

---
Source: https://tokrepo.com/en/workflows/asset-fd6453fc
Author: Script Depot