القائمة
Nebula launcher MVVM architecture decisions, module layout, data flow, and the roadmap for Hilt, Navigation3, and GeckoView integration. Context for all code generation.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Build the Nebula debug APK with Gradle and parse the output for errors, warnings, and diagnostics.
Run full Gradle check suite — lint, unit tests, and code quality — then summarize what needs attention.
Nebula-specific Kotlin coroutines patterns — stateIn WhileSubscribed, CancellationException rules, withTimeout for widget APIs, supervisorScope for parallel refresh, and CoroutineName for debugging. Loaded automatically when writing ViewModel or Flow code.
Build and install the Nebula debug APK to a connected Android TV device. Checks for device connectivity and explains how to connect if none found.
Scaffold a TV-optimized reusable Composable with D-pad focus handling, scale animation on focus, TV Material3 patterns, and a @Preview configured for 1080p TV dark background.
Scaffold a new feature panel for the Nebula launcher — creates Panel.kt, ViewModel, updates ViewScreen enum and LauncherScreen routing, and adds a nav bar item.
| name | nebula-architecture |
| description | Nebula launcher MVVM architecture decisions, module layout, data flow, and the roadmap for Hilt, Navigation3, and GeckoView integration. Context for all code generation. |
| user-invocable | false |
MainActivity
└── NebulaTheme (TV MaterialTheme)
└── LauncherScreen (owns nav state)
├── NavigationBar (D-pad horizontal tabs)
│ └── NavigationItem × N (focusable tabs)
└── Panel Switcher (when expression on ViewScreen)
├── WidgetAreaPanel → home/Panel.kt
├── AppGridPanel → apps/Panel.kt + AppGridViewModel
├── BrowserPanel → browser/Panel.kt (GeckoView — TODO)
└── BackgroundsPanel → backgrouds/Panel.kt (typo, don't rename)
// In LauncherScreen — simple state switch, no back stack
var currentView by remember { mutableStateOf(ViewScreen.WIDGETS) }
when (currentView) {
ViewScreen.WIDGETS -> WidgetAreaPanel(Modifier.fillMaxSize())
ViewScreen.APP_GRID -> AppGridPanel(Modifier.fillMaxSize())
ViewScreen.BROWSER -> BrowserPanel(Modifier.fillMaxSize())
}
Migration path: Navigation3 (stable Nov 2025) when back stack needed.
Pattern: SnapshotStateList<ViewScreen> instead of MutableState<ViewScreen>.
PackageManager ──► AppGridViewModel ──► StateFlow<List<AppInfo>> ──► AppGrid ──► LazyVerticalGrid
(IO thread) (viewModelScope) (Main thread) (Compose) (TvLazyGrid)
ui/components/core/PanelView.kt — the frosted glass container.
All panel root composables MUST use PanelView {} as their outermost container.
This provides visual consistency (glass-morphism background) across panels.
Hilt 2.57 is in libs.versions.toml. Plugin is commented out in app/build.gradle.kts.
To enable when ready:
app/build.gradle.kts: Uncomment id("com.google.dagger.hilt.android")NebulaApplication : Application() with @HiltAndroidAppAndroidManifest.xml: android:name=".NebulaApplication"@AndroidEntryPoint to MainActivityviewModel() with hiltViewModel() in composables@Inject constructor in ViewModels + @HiltViewModelGeckoView 141.x is in deps and Mozilla Maven is configured. Integration requires:
NebulaApplication class (needed for singleton GeckoRuntime anyway)AndroidView {} wrapper in BrowserPanelGeckoSession per tab, managed in BrowserViewModelGeckoRuntime singleton in ApplicationSee gecko-browser-specialist agent for implementation patterns.
Widget refresh and background image updates need:
repeatOnLifecycle(STARTED) in ViewModels (pauses when backgrounded)WorkManager for refresh when launcher is not foregroundbackgrouds/ (note the typo — missing 'd') exists in git history.
DO NOT rename this folder. Use the typo as-is to avoid git complications.
Reference it exactly: com.example.nebula.backgrouds
minifyEnabled = false. Use for development.minifyEnabled = false (also currently). Add ProGuard rules before enabling.