# Track Spec: Comprehensive Dashboard UI/UX Redesign

**Track ID**: `comprehensive_ui_uplift_20260311`
**Status**: Draft
**Persona**: PO (Vision), Dev (Architecture), QA (Validation)

## 1. Goal
Apply a complete UI/UX design uplift to every page in the Jomblo Admin Dashboard using `uncodixfy` principles and `shadcn/ui` components. Replace legacy elements with premium, high-signal components (e.g., metric pills, clean tables, optimized forms).

## 2. Requirements
- **Global Redesign**:
    - Every page in `app/(private)/dashboard/` must be audited and updated.
    - Use `uncodixfy` to ensure minimalist, functional, and honest interfaces.
    - Standardize all pages to use the new `Sidebar` and `Header` shell (already implemented).
- **Component Standardization**:
    - Implement a new `MetricPill` component using `shadcn/ui` and `uncodixfy` (no floating effects, subtle shadows).
    - Update all data tables to use `shadcn/ui` `Table` primitives with clean borders and hover states.
    - Redesign all forms using `shadcn/ui` `Form`, `Input`, and `Button` with standardized 8-10px radii.
- **Visual Language**:
    - Follow the **Graphite Pro** or **Porcelain Clean** color schemes from `uncodixfy`.
    - No hero sections, no decorative copy, no oversized rounded corners.
    - 100% responsive check on mobile and desktop viewports.

## 3. Architecture
- **Components**: `components/dashboard/shared/` for new reusable primitives (e.g., `MetricPill.tsx`).
- **Pages**: `app/(private)/dashboard/**/*` (all entity overviews, create/edit forms).
- **Styles**: Use Tailwind CSS with `shadcn/ui` configurations.

## 4. Resource Budgets
- **LCP (Largest Contentful Paint)**: < 1.0s for all overview pages.
- **Build**: Zero errors.
- **Verification**: 100% test success for existing functionality.

## 5. Acceptance Criteria
- [ ] Metric Pills implemented and used across all overview pages.
- [ ] All entity tables (Products, Orders, Customers, etc.) updated to the new style.
- [ ] All entity forms (Create/Edit) updated to use `shadcn/ui` and `uncodixfy` standards.
- [ ] Responsive layouts verified for all pages.
- [ ] Zero linting/TSC errors.