nebula-tv: Skill for Claude Code

Nebula Architecture Reference

App Structure (Single Module)

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)

Current Navigation Model

// 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>.

Data Flow (Current)

PackageManager ──► AppGridViewModel ──► StateFlow<List<AppInfo>> ──► AppGrid ──► LazyVerticalGrid
   (IO thread)      (viewModelScope)        (Main thread)           (Compose)       (TvLazyGrid)

PanelView Component

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 — NOT YET ENABLED

Hilt 2.57 is in libs.versions.toml. Plugin is commented out in app/build.gradle.kts.

To enable when ready:

1. app/build.gradle.kts: Uncomment id("com.google.dagger.hilt.android")
2. Create NebulaApplication : Application() with @HiltAndroidApp
3. Register in AndroidManifest.xml: android:name=".NebulaApplication"
4. Add @AndroidEntryPoint to MainActivity
5. Replace viewModel() with hiltViewModel() in composables
6. Use @Inject constructor in ViewModels + @HiltViewModel