How android/nowinandroid works
Purpose and Entry Points
Now in Android is a modular Kotlin/Jetpack Compose Android reference app for browsing Android-development news, following topics, bookmarking content, searching, and receiving matching-content notifications. The primary installable app starts through app/src/main/kotlin/com/google/samples/apps/nowinandroid/NiaApplication.kt and app/src/main/kotlin/com/google/samples/apps/nowinandroid/MainActivity.kt, which renders the root Compose shell in app/src/main/kotlin/com/google/samples/apps/nowinandroid/ui/NiaApp.kt. app-nia-catalog is a separate component-catalog application, entered by app-nia-catalog/src/main/kotlin/com/google/samples/apps/niacatalog/NiaCatalogActivity.kt.
Application Shell and Navigation
The app module owns process-level Hilt setup, activity lifecycle integration, adaptive app state, top-level navigation, theme selection, and app-wide performance instrumentation. MainActivityViewModel.kt prepares startup/UI state; NiaAppState.kt coordinates navigation and window/layout concerns. Navigation is abstracted behind core/navigation/src/main/kotlin/com/google/samples/apps/nowinandroid/core/navigation/Navigator.kt and NavigationState.kt, keeping feature destinations decoupled from the app shell.
Feature Boundaries
User-facing capabilities are split into API and implementation modules. API modules expose typed navigation keys; implementation modules supply Compose entry providers, screens, and ViewModels. Representative paths are:
• For You/onboarding feed: feature/foryou/api/src/main/kotlin/com/google/samples/apps/nowinandroid/feature/foryou/api/navigation/ForYouNavKey.kt, feature/foryou/impl/src/main/kotlin/com/google/samples/apps/nowinandroid/feature/foryou/impl/ForYouViewModel.kt.
• Interests and topic detail: feature/interests/impl/src/main/kotlin/com/google/samples/apps/nowinandroid/feature/interests/impl/InterestsScreen.kt, feature/topic/impl/src/main/kotlin/com/google/samples/apps/nowinandroid/feature/topic/impl/TopicViewModel.kt.
• Bookmarks and search: feature/bookmarks/impl/src/main/kotlin/com/google/samples/apps/nowinandroid/feature/bookmarks/impl/BookmarksViewModel.kt, feature/search/impl/src/main/kotlin/com/google/samples/apps/nowinandroid/feature/search/impl/SearchViewModel.kt.
Settings is a dialog-oriented feature backed by persisted user preferences.
Data, Domain, and Persistence Flow
Features consume repository interfaces and domain use cases, producing observable UI state in ViewModels. Shared business models live in core/model/src/main/kotlin/com/google/samples/apps/nowinandroid/core/model/data/. Search and topic-following orchestration is isolated in use cases such as core/domain/src/main/kotlin/com/google/samples/apps/nowinandroid/core/domain/GetSearchContentsUseCase.kt. The data layer implements offline-first repositories—e.g., core/data/src/main/kotlin/com/google/samples/apps/nowinandroid/core/data/repository/OfflineFirstNewsRepository.kt and OfflineFirstUserDataRepository.kt—which bridge network sync, Room, DataStore preferences, connectivity, and analytics.
Room is the local content/search cache via core/database/src/main/kotlin/com/google/samples/apps/nowinandroid/core/database/NiaDatabase.kt and its DAOs. Proto DataStore persists theme, followed topics, bookmarks, and sync versions through core/datastore/src/main/kotlin/com/google/samples/apps/nowinandroid/core/datastore/NiaPreferencesDataSource.kt and core/datastore-proto/src/main/proto/com/google/samples/apps/nowinandroid/data/user_preferences.proto.
External Boundaries and Background Work
core/network defines NiaNetworkDataSource.kt; the demo flavor serves bundled news.json/topics.json, while production uses RetrofitNiaNetwork.kt against a non-public backend. Flavor-specific bindings select these implementations. WorkManager schedules and executes synchronization through sync/work/src/main/kotlin/com/google/samples/apps/nowinandroid/sync/workers/SyncWorker.kt and WorkManagerSyncManager.kt. Production can subscribe to Firebase-driven sync events and display notification updates. Firebase Analytics is similarly production-bound in core/analytics/src/prod/kotlin/com/google/samples/apps/nowinandroid/core/analytics/FirebaseAnalyticsHelper.kt; app/google-services.json configures Google services.
UI System and Dependency Composition
Compose screens depend on shared visual primitives and feed components rather than direct platform UI: core/designsystem/src/main/kotlin/com/google/samples/apps/nowinandroid/core/designsystem/theme/Theme.kt, core/ui/src/main/kotlin/com/google/samples/apps/nowinandroid/core/ui/NewsFeed.kt. Hilt modules at data/database/network boundaries bind interfaces to flavor-specific implementations, enabling demo, production, and test substitutions.
Build, Delivery, and Performance
Gradle convention plugins centralize Android, Compose, Hilt, Room, flavor, and quality policy under build-logic/convention/src/main/kotlin/. Main variants are demo (bundled data), prod (remote backend), plus benchmark; normal development targets demoDebug. Macrobenchmarks and baseline-profile journeys reside in benchmarks/src/main/kotlin/com/google/samples/apps/nowinandroid/baselineprofile/ and support startup and critical navigation optimization. GitHub Actions build, release, and nightly profile workflows are in .github/workflows/.
Main entry points: Navigator.kt Navigation abstraction · OfflineFirstNewsRepository.kt Offline-first repositories · GetSearchContentsUseCase.kt Domain use cases · ForYouViewModel.kt For You
Components 20
App shell
- Main activity · Hosts the primary Compose application.
app/src/main/kotlin/com/google/samples/apps/nowinandroid/MainActivity.kt - Nia application · Initializes process-level dependencies.
app/src/main/kotlin/com/google/samples/apps/nowinandroid/NiaApplication.kt - Compose app shell · Owns adaptive layout, theme, and top-level destinations.
app/src/main/kotlin/com/google/samples/apps/nowinandroid/ui/NiaApp.kt - Navigation abstraction · Decouples app shell from feature destinations.
core/navigation/src/main/kotlin/com/google/samples/apps/nowinandroid/core/navigation/Navigator.kt - Component catalog · Standalone catalog activity for UI components.
app-nia-catalog/src/main/kotlin/com/google/samples/apps/niacatalog/NiaCatalogActivity.kt
Feature modules
- For You · Onboarding and personalized feed.
feature/foryou/impl/src/main/kotlin/com/google/samples/apps/nowinandroid/feature/foryou/impl/ForYouViewModel.kt - Interests and topics · Topic discovery, following, and detail.
feature/interests/impl/src/main/kotlin/com/google/samples/apps/nowinandroid/feature/interests/impl/InterestsScreen.kt - Bookmarks
feature/bookmarks/impl/src/main/kotlin/com/google/samples/apps/nowinandroid/feature/bookmarks/impl/BookmarksViewModel.kt - Search
feature/search/impl/src/main/kotlin/com/google/samples/apps/nowinandroid/feature/search/impl/SearchViewModel.kt - Design system and UI · Shared theme, primitives, and news-feed components.
core/designsystem/src/main/kotlin/com/google/samples/apps/nowinandroid/core/designsystem/theme/Theme.kt
Data and platform
- Domain use cases · Orchestrates search and topic-following flows.
core/domain/src/main/kotlin/com/google/samples/apps/nowinandroid/core/domain/GetSearchContentsUseCase.kt - Offline-first repositories · Bridge local state, sync, connectivity, and analytics.
core/data/src/main/kotlin/com/google/samples/apps/nowinandroid/core/data/repository/OfflineFirstNewsRepository.kt - Room content cache · Caches content and powers local search.
core/database/src/main/kotlin/com/google/samples/apps/nowinandroid/core/database/NiaDatabase.kt - Proto DataStore · Persists preferences, follows, bookmarks, and sync versions.
core/datastore/src/main/kotlin/com/google/samples/apps/nowinandroid/core/datastore/NiaPreferencesDataSource.kt - Network data source · Demo uses bundled data; prod uses Retrofit backend.
core/network/src/main/kotlin/com/google/samples/apps/nowinandroid/core/network/NiaNetworkDataSource.kt - WorkManager sync · Schedules and executes repository synchronization.
sync/work/src/main/kotlin/com/google/samples/apps/nowinandroid/sync/workers/SyncWorker.kt
Variants and delivery
- Firebase services · Provides analytics and sync-triggered notifications.
core/analytics/src/prod/kotlin/com/google/samples/apps/nowinandroid/core/analytics/FirebaseAnalyticsHelper.kt - Convention build and variants · Defines Compose, Hilt, Room, quality, and demo/prod/benchmark policy.
- Baseline profiles · Captures startup and navigation optimization journeys.
- GitHub Actions · Builds, releases, and runs nightly profile workflows.
Connections 23
- Nia application → Main activity: initializes
- Main activity → Compose app shell: renders
- Compose app shell → Navigation abstraction: uses
- Navigation abstraction → For You: routes to
- Navigation abstraction → Interests and topics: routes to
- Navigation abstraction → Bookmarks: routes to
- Navigation abstraction → Search: routes to
- For You → Design system and UI: composes
- Interests and topics → Design system and UI: composes
- Bookmarks → Domain use cases: consumes
- Search → Domain use cases: queries through
- For You → Domain use cases: consumes
- Interests and topics → Domain use cases: consumes
- Domain use cases → Offline-first repositories: uses
- Offline-first repositories → Room content cache: reads and writes
- Offline-first repositories → Proto DataStore: reads and writes
- Offline-first repositories → Network data source: syncs with
- WorkManager sync → Offline-first repositories: synchronizes
- Firebase services → WorkManager sync: triggers in prod
- Convention build and variants → Network data source: selects demo/prod binding
- Convention build and variants → Nia application: builds variants
- Baseline profiles → Compose app shell: measures journeys
- GitHub Actions → Convention build and variants: runs builds and releases