feat: mock newm-admin dashboard view

Author: AndrewWestberg

.agent/task/admin/newm-admin.md

@@ -0,0 +1,169 @@
+# NEWM Admin Desktop Application
+
+## Overview
+
+NEWM Admin is a desktop application for internal administrators to manage the NEWM platform. Built with Rust and GPUI (GPU-accelerated UI framework from Zed), it provides a performant, native interface for admin operations.
+
+**Tech Stack:**
+- **Language:** Rust (2024 edition)
+- **UI Framework:** GPUI + gpui-component
+- **HTTP Client:** reqwest with async-compat bridge
+- **Target Platform:** Desktop (Linux, macOS, Windows)
+
+---
+
+## Current Features
+
+### ✅ Authentication
+
+**Status:** Completed (2026-01-07)
+
+| Feature | Description |
+|---------|-------------|
+| Admin Login | Email/password authentication against Garage/Studio APIs |
+| Environment Selection | Toggle between Garage (dev) and Studio (prod) environments |
+| JWT Validation | Verifies `admin: true` claim in JWT before allowing access |
+| Password Visibility Toggle | Eye icon to show/hide password input |
+
+**Files:**
+- [auth.rs](file:///home/westbam/Development/newm-server/newm-admin/src/auth.rs) — HTTP authentication client
+- [jwt.rs](file:///home/westbam/Development/newm-server/newm-admin/src/jwt.rs) — JWT claims parsing
+- [login.rs](file:///home/westbam/Development/newm-server/newm-admin/src/views/login.rs) — Login view UI
+
+---
+
+### ✅ Admin Dashboard
+
+**Status:** Completed (2026-01-07)
+
+| Feature | Description |
+|---------|-------------|
+| Sidebar Navigation | 200px fixed sidebar with menu items |
+| View State Management | Switches from Login → Dashboard on success |
+| Menu Items | Earnings (pie chart icon), Refunds (undo icon) |
+| Dynamic Work Area | Content changes based on selected menu |
+| Mock Statistics Cards | Placeholder cards showing sample data |
+
+**Files:**
+- [app.rs](file:///home/westbam/Development/newm-server/newm-admin/src/app.rs) — App state and view switching
+- [dashboard.rs](file:///home/westbam/Development/newm-server/newm-admin/src/views/dashboard.rs) — Dashboard view
+- [colors.rs](file:///home/westbam/Development/newm-server/newm-admin/src/colors.rs) — Shared color palette
+
+---
+
+## Planned Features
+
+### 🔲 Earnings Management
+
+**Priority:** High
+
+| Requirement | Status |
+|-------------|--------|
+| List all earnings with pagination | ⬜ Not started |
+| Filter by artist, song, date range | ⬜ Not started |
+| View earnings details | ⬜ Not started |
+| Export earnings data | ⬜ Not started |
+
+### 🔲 Refunds Processing
+
+**Priority:** High
+
+| Requirement | Status |
+|-------------|--------|
+| List refund requests | ⬜ Not started |
+| Approve/reject refunds | ⬜ Not started |
+| View refund history | ⬜ Not started |
+| Audit trail for refund actions | ⬜ Not started |
+
+### 🔲 Token Refresh
+
+**Priority:** Medium
+
+| Requirement | Status |
+|-------------|--------|
+| Automatic token refresh before expiry | ⬜ Not started |
+| Token storage (secure) | ⬜ Not started |
+| Session timeout handling | ⬜ Not started |
+
+---
+
+## Project Structure
+
+```
+newm-admin/
+├── src/
+│   ├── main.rs          # Entry point, window setup
+│   ├── app.rs           # App state, view coordinator
+│   ├── auth.rs          # Authentication client
+│   ├── jwt.rs           # JWT parsing utilities
+│   ├── colors.rs        # Shared color palette
+│   └── views/
+│       ├── mod.rs       # View module exports
+│       ├── login.rs     # Login view
+│       └── dashboard.rs # Dashboard view
+├── Cargo.toml           # Dependencies
+├── DESIGN_GUIDE.md      # UI styling reference
+└── README.md            # Setup instructions
+```
+
+---
+
+## Design System
+
+The application follows NEWM Studio's visual language:
+
+| Element | Specification |
+|---------|---------------|
+| Background | `#000000` (primary), `#1a1a1a` (surface) |
+| Sidebar | 200px fixed width |
+| Primary Button | Purple-to-pink gradient (`#C341F0` → `#F53C69`) |
+| Text | White (`#ffffff`), secondary gray (`#a1a1aa`) |
+| Icons | From gpui-component-assets |
+
+See [DESIGN_GUIDE.md](file:///home/westbam/Development/newm-server/newm-admin/DESIGN_GUIDE.md) for full specifications.
+
+---
+
+## Development Commands
+
+```bash
+# Build
+cd newm-admin && cargo build
+
+# Run (development)
+cd newm-admin && cargo run
+
+# Format code
+cd newm-admin && cargo fmt
+
+# Lint
+cd newm-admin && cargo clippy
+```
+
+---
+
+## Backend API Dependencies
+
+The admin app communicates with the NEWM backend:
+
+| Endpoint | Purpose |
+|----------|---------|
+| `POST /v1/auth/login` | Admin authentication |
+| `GET /v1/auth/refresh` | Token refresh |
+| `GET /v1/earnings/*` | Earnings data (planned) |
+| `POST /v1/refunds/*` | Refund operations (planned) |
+
+---
+
+## Change Log
+
+| Date | Feature | Description |
+|------|---------|-------------|
+| 2026-01-07 | Dashboard | Added sidebar nav with Earnings/Refunds, work area panels |
+| 2026-01-07 | Auth | JWT admin validation, login view with environment selector |
+| 2026-01-06 | Init | Project setup with GPUI, basic login UI |
+
+---
+
+**Status:** 🚧 In Progress  
+**Last Updated:** 2026-01-07

.agent/task/readme.md

@@ -106,7 +106,7 @@ Any unresolved decisions.
 
 | Domain | Plan | Status | Date |
 |--------|------|--------|------|
-| *No plans yet* | — | — | — |
+| admin | [newm-admin.md](admin/newm-admin.md) — NEWM Admin Desktop App | 🚧 In Progress | 2026-01-07 |
 
 ---
 

.agent/workflows/admin.md

@@ -191,3 +191,19 @@ gpui_component::init(cx);
 ```bash
 sudo apt install libxkbcommon-dev libwayland-dev
 ```
+
+---
+
+## Visual Verification
+
+This is a **desktop application**, not a web app. You cannot use browser tools to verify UI changes.
+
+When visual verification of UI changes is needed:
+
+1. **Run the application** using `cargo run`
+2. **Ask the user to take a screenshot** of the relevant window/view
+3. **Request the user provide the screenshot** so you can verify the UI appears correctly
+4. Document what specific UI elements should be visible in the screenshot
+
+Example prompt to user:
+> "Please run the application and take a screenshot of [specific view]. I need to verify that [specific UI element] appears correctly. Attach the screenshot to your reply."

.github/workflows/newm-admin.yml

@@ -0,0 +1,110 @@
+# Based on https://github.com/actions-rs/meta/blob/master/recipes/quickstart.md
+
+on:
+  push:
+    paths:
+      - 'newm-admin/**'
+
+name: Validate
+
+jobs:
+  build:
+    name: Build
+    strategy:
+      fail-fast: false
+      matrix:
+        job:
+          - { os: ubuntu-22.04, label: ubuntu22, target: x86_64-unknown-linux-gnu }
+          - { os: ubuntu-22.04, label: ubuntu22, target: x86_64-unknown-linux-musl, use-cross: true }
+          - { os: macos-latest, label: macos, target: aarch64-apple-darwin }
+          - { os: windows-latest, label: windows, target: x86_64-pc-windows-msvc }
+        rust: [ nightly ]
+
+    runs-on: ${{ matrix.job.os }}
+
+    defaults:
+      run:
+        working-directory: newm-admin
+
+    steps:
+      - name: Checkout sources
+        uses: actions/checkout@v2
+
+      - name: Install nightly toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: nightly
+          components: rustfmt, clippy
+
+      - name: Install cross
+        if: ${{ matrix.job.use-cross }}
+        run: cargo install cross
+
+      - name: Run cargo check
+        if: ${{ matrix.job.target == 'x86_64-unknown-linux-gnu' }}
+        run: cargo check
+
+      - name: Run cargo fmt
+        if: ${{ matrix.job.target == 'x86_64-unknown-linux-gnu' }}
+        run: cargo fmt --all -- --check
+
+      - name: Run cargo clippy (cross)
+        if: ${{ matrix.job.use-cross }}
+        run: cross clippy --release --target ${{ matrix.job.target }} -- -D warnings
+
+      - name: Run cargo clippy
+        if: ${{ !matrix.job.use-cross }}
+        run: cargo clippy --release --target ${{ matrix.job.target }} -- -D warnings
+
+      - name: Run cargo test (cross)
+        if: ${{ matrix.job.use-cross }}
+        run: cross test --release --target ${{ matrix.job.target }}
+
+      - name: Run cargo test
+        if: ${{ !matrix.job.use-cross }}
+        run: cargo test --release --target ${{ matrix.job.target }}
+
+      - name: Build Release (cross)
+        if: ${{ matrix.job.use-cross }}
+        run: cross build --release --target ${{ matrix.job.target }} --locked
+
+      - name: Build Release
+        if: ${{ !matrix.job.use-cross }}
+        run: cargo build --release --target ${{ matrix.job.target }} --locked
+
+      - name: Package
+        id: package
+        shell: bash
+        run: |
+          PROJECT_NAME=$(sed -n 's/^name = "\(.*\)"/\1/p' Cargo.toml)
+          PROJECT_VERSION=$(sed -n 's/^version = "\(.*\)"/\1/p' Cargo.toml | head -n1)
+          if [[ "${{ matrix.job.target }}" == *-pc-windows-* ]]; then
+            PKG_SUFFIX=".zip"
+          else
+            PKG_SUFFIX=".tar.gz"
+          fi
+          PKG_NAME=${PROJECT_NAME}-${PROJECT_VERSION}-${{ matrix.job.label }}-${{ matrix.job.target }}${PKG_SUFFIX}
+          
+          if [[ "${{ matrix.job.target }}" == *-pc-windows-* ]]; then
+            7z -y a "${PKG_NAME}" ./target/${{matrix.job.target}}/release/newm-admin.exe | tail -2
+          else
+            tar -C target/${{matrix.job.target}}/release -czf "${PKG_NAME}" newm-admin
+          fi
+
+          echo ::set-output name=PKG_NAME::${PKG_NAME}
+          echo ::set-output name=PKG_PATH::${PKG_NAME}
+
+      - name: Upload Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ steps.package.outputs.PKG_NAME }}
+          path: ${{ steps.package.outputs.PKG_PATH }}
+
+      - name: Release
+        uses: softprops/action-gh-release@v1
+        if: startsWith(github.ref, 'refs/tags/v')
+        with:
+          prerelease: "${{ contains(github.ref, 'alpha') || contains(github.ref, 'beta') || contains(github.ref, 'rc') }}"
+          files: ${{ steps.package.outputs.PKG_PATH }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

newm-admin/Cargo.lock

@@ -25,3 +25,6 @@ tracing-subscriber = { version = "0.3", features = ["env-filter"] }
 
 # Error Handling
 anyhow = "1"
+
+# JWT Parsing
+base64 = "0.22"

newm-admin/Cargo.toml

@@ -1,20 +1,55 @@
 use gpui::*;
 
+use crate::views::dashboard::DashboardView;
 use crate::views::login::LoginView;
 
+/// Current view state of the application
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
+pub enum AppView {
+    #[default]
+    Login,
+    Dashboard,
+}
+
 pub struct AdminApp {
+    current_view: AppView,
     login_view: Entity<LoginView>,
+    dashboard_view: Entity<DashboardView>,
 }
 
 impl AdminApp {
     pub fn new(window: &mut Window, cx: &mut Context<Self>) -> Self {
         let login_view = cx.new(|cx| LoginView::new(window, cx));
-        Self { login_view }
+        let dashboard_view = cx.new(|cx| DashboardView::new(window, cx));
+
+        // Subscribe to login success events
+        cx.subscribe(
+            &login_view,
+            |this, _login, _event: &LoginSuccessEvent, cx| {
+                this.current_view = AppView::Dashboard;
+                cx.notify();
+            },
+        )
+        .detach();
+
+        Self {
+            current_view: AppView::default(),
+            login_view,
+            dashboard_view,
+        }
     }
 }
 
 impl Render for AdminApp {
     fn render(&mut self, _window: &mut Window, _cx: &mut Context<Self>) -> impl IntoElement {
-        div().size_full().child(self.login_view.clone())
+        div().size_full().child(match self.current_view {
+            AppView::Login => self.login_view.clone().into_any_element(),
+            AppView::Dashboard => self.dashboard_view.clone().into_any_element(),
+        })
     }
 }
+
+/// Event emitted when login succeeds
+pub struct LoginSuccessEvent;
+
+impl EventEmitter<LoginSuccessEvent> for LoginView {}