@kb-labs/studio-app 0.6.0

package/.env.example

@@ -0,0 +1,10 @@
+# API Configuration
+# All traffic goes through Gateway — auth, namespacing, host dispatch
+KB_API_BASE_URL=http://localhost:4000/api/v1
+
+# Gateway auth token (staticTokens in .kb/kb.config.json → gateway.staticTokens)
+KB_GATEWAY_TOKEN=dev-studio-token
+
+# Data Source Mode
+# Options: 'mock' | 'http'
+KB_DATA_SOURCE_MODE=http

package/README.md

@@ -0,0 +1,74 @@
+# kb-labs-studio-app
+
+KB Labs Studio application — web UI for interacting with KB Labs plugins and products.
+
+## Vision & Purpose
+
+**kb-labs-studio-app** is the main Studio frontend.  
+It renders dashboards, plugin widgets, workflow runs, analytics views, and release/audit results powered by the KB Labs REST API and Mind.
+
+### Core Goals
+
+- Provide a unified web UI for all KB Labs products (Audit, Release, Mind, DevLink, AI tools)
+- Render plugin-provided Studio widgets (via `@kb-labs/plugin-adapter-studio`)
+- Offer dashboards, gallery, and per-product pages on top of `@kb-labs/data-client`
+
+## Package Status
+
+- **Version**: 0.1.0  
+- **Stage**: Stable (internal)  
+- **Status**: Production Ready for internal use ✅
+
+## Architecture
+
+### Stack
+
+- **Framework**: React 18 + React Router
+- **UI**: `@kb-labs/ui-core`, `@kb-labs/ui-react`, Ant Design, Lucide
+- **Data**: `@tanstack/react-query` with `@kb-labs/data-client`
+
+### Structure
+
+```
+apps/studio/
+├── src/
+│   ├── App.tsx              # Root React tree and providers
+│   ├── router.tsx           # Route definitions
+│   ├── modules/             # Feature modules (analytics, dashboard, mind, workflows, settings)
+│   ├── components/          # Shared layout and widget host components
+│   ├── layouts/             # Layouts (TwoPane, DashboardGrid, etc.)
+│   ├── providers/           # Auth, data sources, registry providers
+│   ├── registry/            # Studio registry loader and types
+│   ├── plugins/             # Plugin discovery and registry integration
+│   ├── hooks/               # Custom hooks (polling, widget data)
+│   └── styles/              # Theme and CSS variables
+└── vite.config.ts           # Vite configuration
+```
+
+The app uses a plugin registry to dynamically render Studio widgets exposed by plugins.
+
+## Scripts
+
+From `kb-labs-studio` repo root:
+
+```bash
+pnpm install
+pnpm --filter kb-labs-studio-app dev      # Start Vite dev server
+pnpm --filter kb-labs-studio-app build    # Build for production
+pnpm --filter kb-labs-studio-app preview  # Preview built bundle
+pnpm --filter kb-labs-studio-app test     # Run Vitest tests
+```
+
+## Integration Points
+
+- **REST API**: uses `@kb-labs/data-client` with `VITE_API_BASE_URL` (usually `/api/v1`)
+- **Plugins**: consumes Studio manifests via `@kb-labs/plugin-adapter-studio` and registry loader
+- **Mind**: uses `@kb-labs/mind-cli` and Mind surfaces for advanced views
+
+## Environment
+
+Key environment variables (via Vite):
+
+- `VITE_API_BASE_URL` — base URL of REST API (defaults to `/api/v1`)
+
+