nebula-tv: Skill for Claude Code

Nebula Project Conventions

Package Structure

com.example.nebula/
├── MainActivity.kt          — Entry point only, no business logic
├── ViewModel.kt             — AppGridViewModel (rename eventually)
├── AppGrid.kt               — App grid composable
├── AppItem.kt               — App card composable
├── apps/Panel.kt            — App grid panel
├── home/Panel.kt            — Widget area panel
├── browser/Panel.kt         — GeckoView browser panel
├── backgrouds/Panel.kt      — ⚠️ Typo in folder name — DO NOT RENAME (preserves git history)
├── widgets/                 — All widget data sources + composables (TODO: create)
├── constants/Screen.kt      — ViewScreen enum
└── ui/
    ├── theme/               — Color, Type, Theme composables
    └── components/
        ├── core/            — Generic reusable components (PanelView, LauncherScreen)
        └── navigation/      — Nav bar (Bar.kt, Item.kt)

Naming Conventions

ViewModel Pattern (Standard)

class FeatureViewModel : ViewModel() {
    private val _uiState = MutableStateFlow<FeatureState>(FeatureState.Loading)
    val uiState: StateFlow<FeatureState> = _uiState.asStateFlow()

    init { load() }

    fun load() {
        viewModelScope.launch {
            try {
                // fetch data
            } catch (e: Exception) {
                _uiState.value = FeatureState.Error(e.message ?: "Error")
            }
        }
    }
}