# Nexus Store 1.0 — Evidence

Phase 1 mock app catalog for Ninja Nexus Shell — UI, metadata, and mock install state only. No MSI, setup.exe, or Microsoft Store integration.

## Scope

- `NexusStoreWindow` + `NexusStoreView` (dark glass, purple/cyan, Lucide paths)
- Left nav: Forside, Installeret, Tilgængelige Apps, Opdateringer, Favoritter, Nexus Apps, System Apps, Downloads, Historik
- Center: catalog grid / home sections (Anbefalede, Senest opdateret, Populære, Nye apps)
- Right: app details with Install / Åbn / Opdater
- Mock persistence: `%LocalAppData%/NinjaNexus/store/installed.json`
- Launcher + `nexus:store` wiring via `OpenStore()` in `MainWindow`
- `UpdateService` shell version + channel labels in store nav footer
- Build **77** in `config/version.poc.json`

## Architecture

| Layer | Type |
|-------|------|
| `NexusStoreView` | WPF UserControl |
| `NexusStoreViewModel` | MVVM |
| `NexusStoreService` | Catalog + install state orchestration |
| `NexusPackageRepository` | Loads `Assets/store-repository.json` |
| `NexusInstalledAppsService` | Mock install/favorites/history persistence |
| `NexusPackageManifest` | Future `.nxp` descriptor shape |

## Installation model (mock)

| State | Label | Actions |
|-------|-------|---------|
| Not installed | Ikke installeret | Install |
| Installed | Installeret | Åbn (Nexus apps only) |
| Update available | Opdatering tilgængelig | Opdater, Åbn |

Default seed on first run: Nexus Files + Nexus Browser at v1.0.0 while catalog lists newer versions (updates tab demo).

## Future `.nxp` plan

1. Replace `store-repository.json` entries with signed `.nxp` packages (ZIP + manifest).
2. `NexusPackageManifest` maps 1:1 to embedded `package.json` inside `.nxp`.
3. Real install extracts to `%LocalAppData%/NinjaNexus/apps/{id}/` and registers entry points.
4. Updates reuse `UpdateService` download/verify/apply pipeline (see `APP_CENTER.md`).
5. Lockdown `allowedApps` populated from installed package IDs.

## Screenshot checklist

Capture from a Release build:

- [ ] `store-home.png` — Forside with Anbefalede / Senest opdateret sections
- [ ] `store-app-details.png` — App selected with details panel and action buttons
- [ ] `store-installed.png` — Installeret nav showing seeded apps
- [ ] `store-updates.png` — Opdateringer nav with badge and update list

Store screenshots in this folder next to this README.

## Manual verification

1. Launcher → **Ninja Store** (`app-ninja-store` / `nexus:store`)
2. Forside shows four home sections with package cards
3. Opdateringer shows Nexus Files + Nexus Browser (seeded at 1.0.0)
4. Install Nexus Calculator → persists to `installed.json`
5. Åbn on installed Nexus app launches via `nexus:` protocol
6. Mock third-party app (VS Code) → Install works; Åbn shows POC message

## Build

```powershell
dotnet build "source/nexus-shell/NexusShell/NexusShell.csproj" -c Release
```
