Metadata-Version: 2.4
Name: lumo-mobile
Version: 0.0.9
Summary: Deterministic mobile UI/UX checks for Compose / SwiftUI / XML / UIKit — WCAG validator with OKLCH auto-correct, cross-platform parity diff, cognitive-science (Fitts / Hick / Gestalt) layout checks. Ships with an MCP server.
Author: Viktor Savchik
License: MIT
Project-URL: Homepage, https://github.com/OneXeor-Dev/lumo
Project-URL: Repository, https://github.com/OneXeor-Dev/lumo
Project-URL: Issues, https://github.com/OneXeor-Dev/lumo/issues
Keywords: mobile,design,ui,ux,wcag,accessibility,jetpack-compose,swiftui,uikit,android,ios,fitts,gestalt,design-system,cross-platform,mcp
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: numpy>=1.26
Requires-Dist: mcp>=1.27
Requires-Dist: tree-sitter>=0.23
Requires-Dist: tree-sitter-kotlin>=1.1
Requires-Dist: tree-sitter-swift>=0.7
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: ruff>=0.4; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"

# lumo-mobile

Deterministic mobile UI/UX checks invoked by [Lumo](https://github.com/OneXeor-Dev/lumo) — a
Claude Code skill / MCP server / CLI toolkit for designing polished mobile
apps on Jetpack Compose, Android XML, SwiftUI, and UIKit.

Install:

```bash
pipx install lumo-mobile
```

Three CLIs (plus one MCP server) ship:

| Command | What it does |
|---|---|
| `lumo-wcag check --fg <hex> --bg <hex>` | WCAG AA / AAA contrast verdict using the W3C luminance formula. |
| `lumo-wcag fix   --fg <hex> --bg <hex>` | OKLCH auto-correct that preserves hue and chroma while pushing the contrast above the threshold. |
| `lumo-theory check --layout <path>` | Cognitive-science layout checks: Fitts (undersized targets, relative difficulty for primaries), Hick overload, Gestalt proximity, one-handed reachability. |
| `lumo-parity diff --android <path> --ios <path> [--config <path>]` | Cross-platform diff between Android (dp) and iOS (pt) layouts, with optional design-system token validation. |
| `lumo-mcp` | Model Context Protocol server (stdio) exposing all of the above to Claude Code, Cursor, Continue, Aider, Goose, Zed, Codex. |

See the [main repo](https://github.com/OneXeor-Dev/lumo) for the full SKILL.md,
examples, and rationale.

## License

MIT
