# johnpatrickmorgan/wtfautolayout

The source code for Why The Failure, Auto Layout?

Repository: https://github.com/johnpatrickmorgan/wtfautolayout
Canonical: https://ross.abutalabs.com/products/wtfautolayout
Homepage: https://www.wtfautolayout.com
Language: Swift
License: MIT
License Family: permissive
Topics: vapor, swift, spm
Last push: 2024-10-10T14:58:46+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3300, "days_push": 692, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1074, forks 21 (observed 2026-08-28T04:03:29.027890+00:00)

## What it is
The source code for WTF Auto Layout (wtfautolayout.com), a web service that parses Auto Layout constraint-conflict error logs from iOS and macOS and renders them as intuitive visual descriptions. It is built with Swift, the Vapor server framework, and the Sparse parser-combinator library.

## Use cases
- decipher 'Unable to simultaneously satisfy constraints' Auto Layout error logs
- visualize conflicting NSLayoutConstraint conflicts from an iOS or macOS crash log
- find which unwanted constraint broke my UIKit layout
- paste a constraint failure log and get a human-readable explanation
- debug translatesAutoresizingMaskIntoConstraints issues in Auto Layout
- run a Swift/Vapor web service that parses Apple framework logs

## When to choose
- you are debugging UIKit or AppKit Auto Layout constraint conflicts and the raw console log is hard to read
- you want a quick web tool to paste an Auto Layout error and see the conflicting constraints visualized
- you want to study or self-host a Swift/Vapor application that parses structured Apple error logs
- you need to identify NSAutoresizingMaskLayoutConstraint entries you did not expect in your constraints

## When to avoid
- you need a general-purpose log analyzer for logs other than Auto Layout constraint errors
- you want an offline or IDE-integrated constraint debugger rather than a paste-into-website workflow
- you need programmatic APIs or CI integration for constraint debugging - the project exposes a website, not a library or CLI
- you are not working with Apple's Auto Layout (iOS/macOS) constraint system

## Facets
- artifact type: service
- maturity: maintenance
- function: parser, http-server, developer-tools, gui, documentation
- domain: developer-tools, web-development, apple-ecosystem
- platform: -
- tags: auto-layout, constraint-debugging, error-log-parser, visualization, swift-on-server, vapor, developer-utility, web-tool, debugging, automation, swift, web-server, macos, ios

## Member repositories
- johnpatrickmorgan/wtfautolayout (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:29.027890+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:53:31.767304+00:00, confidence not recorded.
  - readme: https://github.com/johnpatrickmorgan/wtfautolayout (fetched 2026-08-28T04:03:29.027890+00:00, sha b0434f37b99e)
  - homepage: https://www.wtfautolayout.com (fetched 2026-08-29T12:55:11.849551+00:00, sha 47476b641674)
  - site_page: https://www.wtfautolayout.com/about (fetched 2026-08-29T12:55:11.852076+00:00, sha 411f26973195)
- Data as of 2026-08-30T08:39:29.467469+00:00.