letfixit 0.1.0

package/server/data/device_gpu_db.json

@@ -0,0 +1,465 @@
+{
+  "_meta": {
+    "version": "1.0.0",
+    "updated": "2025-07",
+    "tiers": {
+      "flagship": "Top-end GPU. Handles all Flutter widgets including heavy shaders, BackdropFilter, Impeller.",
+      "high":     "Strong GPU. Most heavy widgets fine. Complex shader stacks may drop frames at 120Hz.",
+      "mid":      "Moderate GPU. BackdropFilter, ShaderMask, heavy Opacity layers will cause frame drops.",
+      "low":      "Weak GPU. Any offscreen compositing or CustomPainter triggers jank. Avoid Opacity != 0/1.",
+      "entry":    "Very weak GPU. Even basic animations can drop below 30fps. Stack depth > 8 causes jank."
+    },
+    "gpu_families": {
+      "Adreno 7xx":     "flagship",
+      "Adreno 6xx":     "high",
+      "Adreno 5xx":     "mid",
+      "Immortalis-G7xx":"flagship",
+      "Mali-G7xx":      "high",
+      "Mali-G6xx":      "mid",
+      "Mali-G5xx":      "mid",
+      "Mali-G52":       "low",
+      "Mali-G57":       "low",
+      "Apple A17":      "flagship",
+      "Apple A16":      "flagship",
+      "Apple A15":      "flagship",
+      "Apple A14":      "high",
+      "Apple A13":      "high",
+      "Apple A12":      "high"
+    }
+  },
+
+  "android": {
+
+    "Samsung Galaxy S24 Ultra": {
+      "gpu": "Adreno 750", "gpu_tier": "flagship", "ram_gb": 12,
+      "api": 34, "arch": "arm64-v8a", "soc": "Snapdragon 8 Gen 3",
+      "flutter_notes": "Impeller performs excellently. All widget types safe."
+    },
+    "Samsung Galaxy S24+": {
+      "gpu": "Adreno 750", "gpu_tier": "flagship", "ram_gb": 12,
+      "api": 34, "arch": "arm64-v8a", "soc": "Snapdragon 8 Gen 3",
+      "flutter_notes": "Same SoC as S24 Ultra. Full widget support."
+    },
+    "Samsung Galaxy S24": {
+      "gpu": "Xclipse 940", "gpu_tier": "high", "ram_gb": 8,
+      "api": 34, "arch": "arm64-v8a", "soc": "Exynos 2400",
+      "flutter_notes": "Xclipse 940 (AMD RDNA2). BackdropFilter safe. Watch shader compilation at 120Hz."
+    },
+    "Samsung Galaxy S23 Ultra": {
+      "gpu": "Adreno 740", "gpu_tier": "flagship", "ram_gb": 12,
+      "api": 33, "arch": "arm64-v8a", "soc": "Snapdragon 8 Gen 2",
+      "flutter_notes": "Excellent. All widgets safe including heavy shader stacks."
+    },
+    "Samsung Galaxy S23+": {
+      "gpu": "Adreno 740", "gpu_tier": "flagship", "ram_gb": 8,
+      "api": 33, "arch": "arm64-v8a", "soc": "Snapdragon 8 Gen 2",
+      "flutter_notes": "Same SoC as S23 Ultra."
+    },
+    "Samsung Galaxy S23": {
+      "gpu": "Adreno 740", "gpu_tier": "flagship", "ram_gb": 8,
+      "api": 33, "arch": "arm64-v8a", "soc": "Snapdragon 8 Gen 2",
+      "flutter_notes": "Same SoC as S23 Ultra."
+    },
+    "Samsung Galaxy S22 Ultra": {
+      "gpu": "Xclipse 920", "gpu_tier": "high", "ram_gb": 12,
+      "api": 32, "arch": "arm64-v8a", "soc": "Exynos 2200",
+      "flutter_notes": "Xclipse 920 (AMD RDNA2). Heavy CustomPainter acceptable. Shader warm-up recommended."
+    },
+    "Samsung Galaxy S22+": {
+      "gpu": "Adreno 730", "gpu_tier": "high", "ram_gb": 8,
+      "api": 32, "arch": "arm64-v8a", "soc": "Snapdragon 8 Gen 1",
+      "flutter_notes": "BackdropFilter in scrollable lists can cause micro-jank."
+    },
+    "Samsung Galaxy S22": {
+      "gpu": "Adreno 730", "gpu_tier": "high", "ram_gb": 8,
+      "api": 32, "arch": "arm64-v8a", "soc": "Snapdragon 8 Gen 1",
+      "flutter_notes": "BackdropFilter in scrollable lists can cause micro-jank."
+    },
+    "Samsung Galaxy S21 Ultra": {
+      "gpu": "Mali-G78 MP14", "gpu_tier": "high", "ram_gb": 12,
+      "api": 31, "arch": "arm64-v8a", "soc": "Exynos 2100",
+      "flutter_notes": "ShaderMask on large widgets may cause 1-2 dropped frames."
+    },
+    "Samsung Galaxy S21": {
+      "gpu": "Adreno 660", "gpu_tier": "high", "ram_gb": 8,
+      "api": 31, "arch": "arm64-v8a", "soc": "Snapdragon 888",
+      "flutter_notes": "Avoid nesting multiple BackdropFilter widgets."
+    },
+    "Samsung Galaxy A54 5G": {
+      "gpu": "Mali-G68 MP4", "gpu_tier": "mid", "ram_gb": 8,
+      "api": 33, "arch": "arm64-v8a", "soc": "Exynos 1380",
+      "flutter_notes": "BackdropFilter causes visible jank. Opacity layer >0.99 triggers saveLayer."
+    },
+    "Samsung Galaxy A34 5G": {
+      "gpu": "Mali-G68 MP4", "gpu_tier": "mid", "ram_gb": 6,
+      "api": 33, "arch": "arm64-v8a", "soc": "Dimensity 1080",
+      "flutter_notes": "Same as A54. Avoid animated gradients in ListView."
+    },
+    "Samsung Galaxy A14 5G": {
+      "gpu": "Mali-G68", "gpu_tier": "mid", "ram_gb": 4,
+      "api": 33, "arch": "arm64-v8a", "soc": "Dimensity 700",
+      "flutter_notes": "4GB RAM limits Flutter engine overhead. Avoid large image caches."
+    },
+    "Samsung Galaxy A13": {
+      "gpu": "Mali-G52 MC2", "gpu_tier": "low", "ram_gb": 4,
+      "api": 32, "arch": "arm64-v8a", "soc": "Exynos 850",
+      "flutter_notes": "CRITICAL: Mali-G52 has no hardware raytracing. BackdropFilter drops to ~15fps. Avoid ShaderMask entirely."
+    },
+    "Samsung Galaxy A03": {
+      "gpu": "Mali-G52 MC2", "gpu_tier": "low", "ram_gb": 3,
+      "api": 31, "arch": "arm64-v8a", "soc": "Snapdragon 450",
+      "flutter_notes": "Entry-tier device in many markets. Avoid animations >2 layers deep. No BackdropFilter."
+    },
+    "Samsung Galaxy A03s": {
+      "gpu": "PowerVR GE8320", "gpu_tier": "entry", "ram_gb": 3,
+      "api": 30, "arch": "arm64-v8a", "soc": "Helio P35",
+      "flutter_notes": "PowerVR GPU — poor Flutter/Skia optimization. Even basic CustomPainter causes jank."
+    },
+
+    "Google Pixel 8 Pro": {
+      "gpu": "Immortalis-G715 MC10", "gpu_tier": "flagship", "ram_gb": 12,
+      "api": 34, "arch": "arm64-v8a", "soc": "Google Tensor G3",
+      "flutter_notes": "Excellent Impeller support. Hardware-accelerated backdrop filters."
+    },
+    "Google Pixel 8": {
+      "gpu": "Immortalis-G715 MC10", "gpu_tier": "flagship", "ram_gb": 8,
+      "api": 34, "arch": "arm64-v8a", "soc": "Google Tensor G3",
+      "flutter_notes": "Identical GPU to Pixel 8 Pro. All widgets safe."
+    },
+    "Google Pixel 7 Pro": {
+      "gpu": "Mali-G710 MP7", "gpu_tier": "high", "ram_gb": 12,
+      "api": 33, "arch": "arm64-v8a", "soc": "Google Tensor G2",
+      "flutter_notes": "BackdropFilter at 90Hz is smooth. Complex shader stacks watch at 120Hz mode."
+    },
+    "Google Pixel 7": {
+      "gpu": "Mali-G710 MP7", "gpu_tier": "high", "ram_gb": 8,
+      "api": 33, "arch": "arm64-v8a", "soc": "Google Tensor G2",
+      "flutter_notes": "Same GPU as Pixel 7 Pro. No 120Hz so less GPU pressure."
+    },
+    "Google Pixel 7a": {
+      "gpu": "Mali-G710 MP7", "gpu_tier": "high", "ram_gb": 8,
+      "api": 33, "arch": "arm64-v8a", "soc": "Google Tensor G2",
+      "flutter_notes": "Same GPU as Pixel 7."
+    },
+    "Google Pixel 6 Pro": {
+      "gpu": "Mali-G78 MP20", "gpu_tier": "high", "ram_gb": 12,
+      "api": 31, "arch": "arm64-v8a", "soc": "Google Tensor G1",
+      "flutter_notes": "ShaderMask on full-screen widgets may stutter. Prefer shader warm-up."
+    },
+    "Google Pixel 6": {
+      "gpu": "Mali-G78 MP20", "gpu_tier": "high", "ram_gb": 8,
+      "api": 31, "arch": "arm64-v8a", "soc": "Google Tensor G1",
+      "flutter_notes": "Same GPU as Pixel 6 Pro."
+    },
+    "Google Pixel 6a": {
+      "gpu": "Mali-G78 MP20", "gpu_tier": "high", "ram_gb": 6,
+      "api": 32, "arch": "arm64-v8a", "soc": "Google Tensor G1",
+      "flutter_notes": "6GB RAM means larger apps should watch widget tree depth."
+    },
+    "Google Pixel 5": {
+      "gpu": "Adreno 620", "gpu_tier": "mid", "ram_gb": 8,
+      "api": 30, "arch": "arm64-v8a", "soc": "Snapdragon 765G",
+      "flutter_notes": "Adreno 620 handles most widgets. Avoid stacked BackdropFilters."
+    },
+
+    "OnePlus 12": {
+      "gpu": "Adreno 750", "gpu_tier": "flagship", "ram_gb": 12,
+      "api": 34, "arch": "arm64-v8a", "soc": "Snapdragon 8 Gen 3",
+      "flutter_notes": "Flagship GPU. All Flutter widgets including heavy shaders perform well."
+    },
+    "OnePlus 11": {
+      "gpu": "Adreno 740", "gpu_tier": "flagship", "ram_gb": 16,
+      "api": 33, "arch": "arm64-v8a", "soc": "Snapdragon 8 Gen 2",
+      "flutter_notes": "16GB RAM. Excellent for complex UI trees."
+    },
+    "OnePlus Nord CE3 Lite": {
+      "gpu": "Adreno 610", "gpu_tier": "mid", "ram_gb": 8,
+      "api": 33, "arch": "arm64-v8a", "soc": "Snapdragon 695",
+      "flutter_notes": "Mid-range Adreno. BackdropFilter causes 3-5ms GPU overhead per frame."
+    },
+    "OnePlus Nord 3": {
+      "gpu": "Immortalis-G715 MC10", "gpu_tier": "flagship", "ram_gb": 16,
+      "api": 33, "arch": "arm64-v8a", "soc": "Dimensity 9000",
+      "flutter_notes": "Surprisingly strong for a Nord device. Full widget support."
+    },
+
+    "Xiaomi 14 Pro": {
+      "gpu": "Adreno 750", "gpu_tier": "flagship", "ram_gb": 12,
+      "api": 34, "arch": "arm64-v8a", "soc": "Snapdragon 8 Gen 3",
+      "flutter_notes": "All Flutter widgets safe."
+    },
+    "Xiaomi 13": {
+      "gpu": "Adreno 740", "gpu_tier": "flagship", "ram_gb": 12,
+      "api": 33, "arch": "arm64-v8a", "soc": "Snapdragon 8 Gen 2",
+      "flutter_notes": "All Flutter widgets safe."
+    },
+    "Redmi Note 13 Pro+": {
+      "gpu": "Immortalis-G77 MC9", "gpu_tier": "high", "ram_gb": 12,
+      "api": 33, "arch": "arm64-v8a", "soc": "Dimensity 7200 Ultra",
+      "flutter_notes": "Solid mid-high GPU. BackdropFilter smooth at 120Hz."
+    },
+    "Redmi Note 12": {
+      "gpu": "Adreno 619", "gpu_tier": "mid", "ram_gb": 6,
+      "api": 33, "arch": "arm64-v8a", "soc": "Snapdragon 685",
+      "flutter_notes": "Avoid BackdropFilter + scrolling simultaneously. Use RepaintBoundary."
+    },
+    "Redmi 12": {
+      "gpu": "Mali-G52 MC2", "gpu_tier": "low", "ram_gb": 4,
+      "api": 33, "arch": "arm64-v8a", "soc": "Helio G88",
+      "flutter_notes": "Mali-G52 — same warnings as Galaxy A13. No compositing-heavy widgets."
+    },
+    "Redmi 10C": {
+      "gpu": "Adreno 619", "gpu_tier": "mid", "ram_gb": 4,
+      "api": 31, "arch": "arm64-v8a", "soc": "Snapdragon 680",
+      "flutter_notes": "4GB RAM — watch memory pressure. Avoid caching large decoded images."
+    },
+
+    "Realme 11 Pro+": {
+      "gpu": "Mali-G68 MP4", "gpu_tier": "mid", "ram_gb": 12,
+      "api": 33, "arch": "arm64-v8a", "soc": "Dimensity 7050",
+      "flutter_notes": "BackdropFilter acceptable but visible CPU overhead with Skia."
+    },
+    "Realme C55": {
+      "gpu": "Mali-G57 MC2", "gpu_tier": "low", "ram_gb": 6,
+      "api": 33, "arch": "arm64-v8a", "soc": "Helio G88",
+      "flutter_notes": "Budget GPU. Keep widget tree flat. Animated opacity causes frame drops."
+    },
+    "Realme C35": {
+      "gpu": "PowerVR GE8320", "gpu_tier": "entry", "ram_gb": 4,
+      "api": 31, "arch": "arm64-v8a", "soc": "Unisoc T616",
+      "flutter_notes": "PowerVR — poor Skia/Impeller support. Minimal animations only."
+    },
+
+    "Vivo V29": {
+      "gpu": "Mali-G68 MP4", "gpu_tier": "mid", "ram_gb": 8,
+      "api": 33, "arch": "arm64-v8a", "soc": "Dimensity 8200",
+      "flutter_notes": "Adequate for most apps. Avoid shader-heavy screens."
+    },
+    "OPPO Reno 11": {
+      "gpu": "Mali-G68 MP4", "gpu_tier": "mid", "ram_gb": 8,
+      "api": 34, "arch": "arm64-v8a", "soc": "Dimensity 8200",
+      "flutter_notes": "Same SoC as Vivo V29."
+    },
+
+    "Motorola Moto G84": {
+      "gpu": "Adreno 619", "gpu_tier": "mid", "ram_gb": 12,
+      "api": 33, "arch": "arm64-v8a", "soc": "Snapdragon 695",
+      "flutter_notes": "Good mid-range. BackdropFilter usable with care."
+    },
+    "Motorola Moto G54": {
+      "gpu": "Mali-G68 MC4", "gpu_tier": "mid", "ram_gb": 8,
+      "api": 33, "arch": "arm64-v8a", "soc": "Dimensity 7020",
+      "flutter_notes": "Avoid heavy CustomPainter in ListViews."
+    },
+    "Motorola Moto E13": {
+      "gpu": "Mali-G52", "gpu_tier": "entry", "ram_gb": 2,
+      "api": 33, "arch": "arm64-v8a", "soc": "Unisoc T606",
+      "flutter_notes": "2GB RAM is hard constraint. Only basic Material widgets. No animations."
+    },
+
+    "Nothing Phone 2": {
+      "gpu": "Adreno 740", "gpu_tier": "flagship", "ram_gb": 12,
+      "api": 33, "arch": "arm64-v8a", "soc": "Snapdragon 8+ Gen 1",
+      "flutter_notes": "Glyph animations are hardware-composited. Flutter UI is unaffected."
+    },
+    "Nothing Phone 1": {
+      "gpu": "Adreno 730", "gpu_tier": "high", "ram_gb": 12,
+      "api": 32, "arch": "arm64-v8a", "soc": "Snapdragon 778G+",
+      "flutter_notes": "Strong mid-high GPU. All standard widgets safe."
+    }
+  },
+
+  "ios": {
+
+    "iPhone 15 Pro Max": {
+      "gpu": "Apple A17 Pro GPU (6-core)", "gpu_tier": "flagship", "ram_gb": 8,
+      "ios_min": "17.0", "arch": "arm64", "soc": "Apple A17 Pro",
+      "flutter_notes": "Hardware ray tracing. Metal 3. All Flutter/Impeller features perform excellently."
+    },
+    "iPhone 15 Pro": {
+      "gpu": "Apple A17 Pro GPU (6-core)", "gpu_tier": "flagship", "ram_gb": 8,
+      "ios_min": "17.0", "arch": "arm64", "soc": "Apple A17 Pro",
+      "flutter_notes": "Same GPU as 15 Pro Max."
+    },
+    "iPhone 15 Plus": {
+      "gpu": "Apple A16 GPU (5-core)", "gpu_tier": "flagship", "ram_gb": 6,
+      "ios_min": "17.0", "arch": "arm64", "soc": "Apple A16 Bionic",
+      "flutter_notes": "A16 GPU handles all Flutter widgets at 60Hz."
+    },
+    "iPhone 15": {
+      "gpu": "Apple A16 GPU (5-core)", "gpu_tier": "flagship", "ram_gb": 6,
+      "ios_min": "17.0", "arch": "arm64", "soc": "Apple A16 Bionic",
+      "flutter_notes": "Same GPU as iPhone 15 Plus."
+    },
+
+    "iPhone 14 Pro Max": {
+      "gpu": "Apple A16 GPU (6-core)", "gpu_tier": "flagship", "ram_gb": 6,
+      "ios_min": "16.0", "arch": "arm64", "soc": "Apple A16 Bionic",
+      "flutter_notes": "ProMotion 120Hz. Watch widget build time — 8.3ms budget at 120Hz."
+    },
+    "iPhone 14 Pro": {
+      "gpu": "Apple A16 GPU (6-core)", "gpu_tier": "flagship", "ram_gb": 6,
+      "ios_min": "16.0", "arch": "arm64", "soc": "Apple A16 Bionic",
+      "flutter_notes": "ProMotion 120Hz. Same 8.3ms frame budget warning."
+    },
+    "iPhone 14 Plus": {
+      "gpu": "Apple A15 GPU (5-core)", "gpu_tier": "flagship", "ram_gb": 6,
+      "ios_min": "16.0", "arch": "arm64", "soc": "Apple A15 Bionic",
+      "flutter_notes": "60Hz only. 16.6ms budget."
+    },
+    "iPhone 14": {
+      "gpu": "Apple A15 GPU (5-core)", "gpu_tier": "flagship", "ram_gb": 6,
+      "ios_min": "16.0", "arch": "arm64", "soc": "Apple A15 Bionic",
+      "flutter_notes": "60Hz only. Strong GPU — all widgets safe."
+    },
+
+    "iPhone 13 Pro Max": {
+      "gpu": "Apple A15 GPU (5-core)", "gpu_tier": "flagship", "ram_gb": 6,
+      "ios_min": "15.0", "arch": "arm64", "soc": "Apple A15 Bionic",
+      "flutter_notes": "ProMotion 120Hz. A15 handles BackdropFilter at 120Hz smoothly."
+    },
+    "iPhone 13 Pro": {
+      "gpu": "Apple A15 GPU (5-core)", "gpu_tier": "flagship", "ram_gb": 6,
+      "ios_min": "15.0", "arch": "arm64", "soc": "Apple A15 Bionic",
+      "flutter_notes": "ProMotion 120Hz."
+    },
+    "iPhone 13": {
+      "gpu": "Apple A15 GPU (4-core)", "gpu_tier": "flagship", "ram_gb": 4,
+      "ios_min": "15.0", "arch": "arm64", "soc": "Apple A15 Bionic",
+      "flutter_notes": "4-core GPU. BackdropFilter in scrollable content OK at 60Hz."
+    },
+    "iPhone 13 mini": {
+      "gpu": "Apple A15 GPU (4-core)", "gpu_tier": "flagship", "ram_gb": 4,
+      "ios_min": "15.0", "arch": "arm64", "soc": "Apple A15 Bionic",
+      "flutter_notes": "Small screen reduces raster workload. All widgets safe."
+    },
+
+    "iPhone SE (3rd gen)": {
+      "gpu": "Apple A15 GPU (4-core)", "gpu_tier": "flagship", "ram_gb": 4,
+      "ios_min": "15.4", "arch": "arm64", "soc": "Apple A15 Bionic",
+      "flutter_notes": "Strong GPU in a budget body. 60Hz only."
+    },
+    "iPhone SE (2nd gen)": {
+      "gpu": "Apple A13 GPU (4-core)", "gpu_tier": "high", "ram_gb": 3,
+      "ios_min": "13.4", "arch": "arm64", "soc": "Apple A13 Bionic",
+      "flutter_notes": "3GB RAM — watch memory. Large image caches may trigger OOM."
+    },
+
+    "iPhone 12 Pro Max": {
+      "gpu": "Apple A14 GPU (4-core)", "gpu_tier": "high", "ram_gb": 6,
+      "ios_min": "14.1", "arch": "arm64", "soc": "Apple A14 Bionic",
+      "flutter_notes": "First 5nm chip. Excellent Flutter Skia and Impeller performance."
+    },
+    "iPhone 12 Pro": {
+      "gpu": "Apple A14 GPU (4-core)", "gpu_tier": "high", "ram_gb": 6,
+      "ios_min": "14.1", "arch": "arm64", "soc": "Apple A14 Bionic",
+      "flutter_notes": "Same GPU as 12 Pro Max."
+    },
+    "iPhone 12": {
+      "gpu": "Apple A14 GPU (4-core)", "gpu_tier": "high", "ram_gb": 4,
+      "ios_min": "14.1", "arch": "arm64", "soc": "Apple A14 Bionic",
+      "flutter_notes": "4GB RAM. Stack depth and image cache matter."
+    },
+    "iPhone 12 mini": {
+      "gpu": "Apple A14 GPU (4-core)", "gpu_tier": "high", "ram_gb": 4,
+      "ios_min": "14.1", "arch": "arm64", "soc": "Apple A14 Bionic",
+      "flutter_notes": "Same as iPhone 12."
+    },
+
+    "iPhone 11 Pro Max": {
+      "gpu": "Apple A13 GPU (4-core)", "gpu_tier": "high", "ram_gb": 4,
+      "ios_min": "13.0", "arch": "arm64", "soc": "Apple A13 Bionic",
+      "flutter_notes": "Still very capable. BackdropFilter at 60Hz is smooth."
+    },
+    "iPhone 11 Pro": {
+      "gpu": "Apple A13 GPU (4-core)", "gpu_tier": "high", "ram_gb": 4,
+      "ios_min": "13.0", "arch": "arm64", "soc": "Apple A13 Bionic",
+      "flutter_notes": "Same as 11 Pro Max."
+    },
+    "iPhone 11": {
+      "gpu": "Apple A13 GPU (4-core)", "gpu_tier": "high", "ram_gb": 4,
+      "ios_min": "13.0", "arch": "arm64", "soc": "Apple A13 Bionic",
+      "flutter_notes": "Liquid Retina — same GPU, less display area to raster."
+    },
+
+    "iPhone XR": {
+      "gpu": "Apple A12 GPU (4-core)", "gpu_tier": "high", "ram_gb": 3,
+      "ios_min": "12.0", "arch": "arm64", "soc": "Apple A12 Bionic",
+      "flutter_notes": "3GB RAM is limit. Avoid large image grids. BackdropFilter OK at 60Hz."
+    },
+    "iPhone XS Max": {
+      "gpu": "Apple A12 GPU (4-core)", "gpu_tier": "high", "ram_gb": 4,
+      "ios_min": "12.0", "arch": "arm64", "soc": "Apple A12 Bionic",
+      "flutter_notes": "Large OLED screen increases raster workload but A12 handles it."
+    },
+    "iPhone XS": {
+      "gpu": "Apple A12 GPU (4-core)", "gpu_tier": "high", "ram_gb": 4,
+      "ios_min": "12.0", "arch": "arm64", "soc": "Apple A12 Bionic",
+      "flutter_notes": "Same GPU as XS Max."
+    },
+
+    "iPad Pro 12.9 (M4)": {
+      "gpu": "Apple M4 GPU (10-core)", "gpu_tier": "flagship", "ram_gb": 16,
+      "ios_min": "17.5", "arch": "arm64", "soc": "Apple M4",
+      "flutter_notes": "Desktop-class GPU. ProMotion 120Hz. Ideal for complex Flutter UIs."
+    },
+    "iPad Pro 11 (M4)": {
+      "gpu": "Apple M4 GPU (10-core)", "gpu_tier": "flagship", "ram_gb": 16,
+      "ios_min": "17.5", "arch": "arm64", "soc": "Apple M4",
+      "flutter_notes": "Same as 12.9 M4."
+    },
+    "iPad Air (M2)": {
+      "gpu": "Apple M2 GPU (9-core)", "gpu_tier": "flagship", "ram_gb": 8,
+      "ios_min": "17.4", "arch": "arm64", "soc": "Apple M2",
+      "flutter_notes": "M2 GPU — all Flutter widgets at any complexity."
+    },
+    "iPad (10th gen)": {
+      "gpu": "Apple A14 GPU (4-core)", "gpu_tier": "high", "ram_gb": 4,
+      "ios_min": "16.0", "arch": "arm64", "soc": "Apple A14 Bionic",
+      "flutter_notes": "Large screen (10.9\") increases raster cost. Watch full-screen BackdropFilter."
+    },
+    "iPad mini (6th gen)": {
+      "gpu": "Apple A15 GPU (4-core)", "gpu_tier": "flagship", "ram_gb": 4,
+      "ios_min": "15.0", "arch": "arm64", "soc": "Apple A15 Bionic",
+      "flutter_notes": "Small screen + A15 = very light GPU load."
+    }
+  },
+
+  "gpu_widget_risk": {
+    "BackdropFilter": {
+      "cost": "high",
+      "risky_on": ["entry", "low"],
+      "warning": "Triggers full offscreen compositing pass. Avoid in scrollable lists on low/entry-tier GPUs."
+    },
+    "ShaderMask": {
+      "cost": "high",
+      "risky_on": ["entry", "low"],
+      "warning": "Custom shader evaluation per pixel. Replace with pre-rendered assets on low-tier devices."
+    },
+    "Opacity": {
+      "cost": "medium",
+      "risky_on": ["entry"],
+      "warning": "Values between 0 and 1 (exclusive) trigger saveLayer(). Prefer AnimatedOpacity or FadeTransition."
+    },
+    "CustomPainter": {
+      "cost": "medium",
+      "risky_on": ["entry", "low"],
+      "warning": "Unbounded GPU cost. Profile with shouldRepaint() and use RepaintBoundary."
+    },
+    "ClipPath": {
+      "cost": "medium",
+      "risky_on": ["entry", "low"],
+      "warning": "Anti-aliased clipping is GPU-expensive. Prefer ClipRRect with simple radii."
+    },
+    "ImageFilter": {
+      "cost": "high",
+      "risky_on": ["entry", "low", "mid"],
+      "warning": "Per-frame GPU image processing. Cache result with ImageFiltered + RepaintBoundary."
+    },
+    "Stack": {
+      "cost": "low",
+      "risky_on": ["entry"],
+      "warning": "Deep stacks (>8 layers) with positioned children increase compositing cost on entry GPUs."
+    }
+  }
+}

package/server/device_db.js

@@ -0,0 +1,94 @@
+const fs = require('fs');
+const path = require('path');
+
+const DB_PATH = path.join(__dirname, 'data/device_gpu_db.json');
+
+let _db = { android: {}, ios: {}, _meta: {}, gpu_widget_risk: {} };
+try {
+  _db = JSON.parse(fs.readFileSync(DB_PATH, 'utf8'));
+} catch (err) {
+  console.error(`  ⚠️  Could not load device DB (${DB_PATH}): ${err.message}`);
+}
+
+// Tier ranking — higher number = more capable GPU
+const TIER_RANK = { entry: 0, low: 1, mid: 2, high: 3, flagship: 4 };
+
+/** Flat list of every device, tagged with platform + a stable id. */
+function listDevices() {
+  const out = [];
+  for (const [name, d] of Object.entries(_db.android || {})) {
+    out.push({ id: `android:${name}`, platform: 'android', name, ...d });
+  }
+  for (const [name, d] of Object.entries(_db.ios || {})) {
+    out.push({ id: `ios:${name}`, platform: 'ios', name, ...d });
+  }
+  return out;
+}
+
+/**
+ * One representative device per unique (platform, gpu_tier) configuration.
+ * The performance projection only varies by gpu_tier (+ platform for risky
+ * tiers / API), so this covers the full capability spectrum without evaluating
+ * all ~75 devices. Used as the default target set for a module test.
+ */
+function listUniqueConfigs() {
+  const byKey = new Map();
+  for (const d of listDevices()) {
+    const key = `${d.platform}:${d.gpu_tier}`;
+    // Prefer the highest-RAM device as the tier's representative (most common spec).
+    const cur = byKey.get(key);
+    if (!cur || (d.ram_gb || 0) > (cur.ram_gb || 0)) byKey.set(key, d);
+  }
+  // Sort by platform then tier rank (weakest → strongest) for a readable report.
+  return [...byKey.values()].sort((a, b) =>
+    a.platform === b.platform
+      ? tierRank(a.gpu_tier) - tierRank(b.gpu_tier)
+      : a.platform.localeCompare(b.platform)
+  );
+}
+
+/** Look up one device by its `platform:name` id. */
+function getDevice(id) {
+  if (!id) return null;
+  const [platform, ...rest] = id.split(':');
+  const name = rest.join(':');
+  const d = (_db[platform] || {})[name];
+  return d ? { id, platform, name, ...d } : null;
+}
+
+/**
+ * Best-effort fuzzy match of a raw device-model string reported by the running
+ * app (e.g. "SM-A135F", "Pixel 6", "iPhone14,5") against known devices.
+ * Returns the matched device or null.
+ */
+function matchDeviceModel(raw) {
+  if (!raw) return null;
+  const norm = String(raw).toLowerCase().replace(/[\s_-]+/g, '');
+  const all = listDevices();
+
+  // 1. Exact-ish name contains
+  for (const d of all) {
+    const dn = d.name.toLowerCase().replace(/[\s_-]+/g, '');
+    if (dn === norm || dn.includes(norm) || norm.includes(dn)) return d;
+  }
+  // 2. Token overlap (model numbers, "pixel", "galaxy", etc.)
+  const tokens = String(raw).toLowerCase().split(/[\s_-]+/).filter((t) => t.length > 2);
+  let best = null, bestScore = 0;
+  for (const d of all) {
+    const dl = d.name.toLowerCase();
+    const score = tokens.reduce((s, t) => s + (dl.includes(t) ? 1 : 0), 0);
+    if (score > bestScore) { bestScore = score; best = d; }
+  }
+  return bestScore > 0 ? best : null;
+}
+
+function tierRank(tier) {
+  return TIER_RANK[tier] ?? 2;
+}
+
+/** GPU widget-risk lookup table shipped in the DB. */
+function widgetRisk() {
+  return _db.gpu_widget_risk || {};
+}
+
+module.exports = { listDevices, listUniqueConfigs, getDevice, matchDeviceModel, tierRank, widgetRisk, TIER_RANK };