mana-am/matrix-swift

🎯 Dot-matrix loading indicators cho SwiftUI — 100+ mẫu, zero asset, zero dependency

Một cổng Swift/SwiftUI trung thựy từ zzzzshawn/matrix, cung cấp 100+ chỉ báo tải động dưới dạng lưới chấm dot-matrix, deterministic và hoàn toàn bằng SwiftUI.

matrix-swift là một Swift Package triển khai lại toàn bộ thư viện chỉ báo tải matrix của zzzzshawn dưới dạng các thành phần SwiftUI. Mỗi loader được vẽ hoàn toàn bằng Circle động và TimelineView, không cần bất kỳ asset nào và không phụ thuộc bên ngoài. Dự án được Mana (một AI-first creation studio cho iOS) sử dụng cho trạng thái "đang suy nghĩ" trong ứng dụng chat.

✨ Điểm nổi bật

• 100+ mẫu loader: bao gồm Square (23), Circular (20), Hex (10), Fun (18), 3×3 (20), Triangle (20), Icon (1).
• Deterministic: cùng một key luôn chọn cùng một loader, tránh thay đổi khi SwiftUI tái tạo view.
• Zero asset, zero dependency: toàn bộ bằng SwiftUI, vẽ từ Circle động.
• Hai cách dùng: thành phần đặt tên (DotmSquare3) hoặc dùng MatrixLoader(.square(3)) theo ID.
• Reduce Motion aware: tự động dừng hoạt ảnh và chuyển sang tư thế tĩnh khi người dùng tắt chuyển động.
• SwiftPM hỗ trợ: cài đặt nhanh qua Xcode hoặc Package.swift.
• Interactive gallery: MatrixLoaderGallery() để duyệt mọi loader ngay trong app.

💡 Vì sao đáng chú ý

Khác với các spinner mặc định, matrix-swift tạo cảm giác "hand-tuned dot grid" — nhỏ gọn, sống động, phù hợp cho trạng thái đang xử lý trong chat, tool activity hoặc inline loading. Đặc biệt, tính năng deterministic giúp tránh hiện tượng loader nhảy ngẫu nhiên khi cuộn trang hay tái tạo view. Phù hợp với bất kỳ dự án SwiftUI nào cần một chỉ báo tải đẹp và nhẹ.

#SwiftUI #LoadingIndicator #DotMatrix #iOS #OpenSource #TiniX