diff --git a/UX_UI_RECOMMENDATIONS.md b/UX_UI_RECOMMENDATIONS.md
new file mode 100644
index 0000000..565c19c
--- /dev/null
+++ b/UX_UI_RECOMMENDATIONS.md
@@ -0,0 +1,1077 @@
+# UX/UI Recommendations & Control Panel Design
+
+**Generated:** 2026-01-23
+**Focus:** User Experience, Interface Design, Navigation, Control Panel Look & Feel
+
+---
+
+## Executive Summary
+
+The application has solid functionality but needs significant UX/UI polish. The Dashboard is currently a placeholder, navigation is basic, and user feedback mechanisms are not integrated. This document provides detailed recommendations for creating a professional, regulator-grade control panel interface.
+
+**Current UX Score:** 6/10
+**Target UX Score:** 9/10
+
+---
+
+## 1. CRITICAL UX GAPS
+
+### 1.1 Dashboard Page - Empty Placeholder
+
+**Current State:**
+- ❌ Dashboard shows only a dashed border box
+- ❌ No content, statistics, or information
+- ❌ Charts.tsx component exists but not used
+
+**Impact:** CRITICAL - Users see nothing useful on the main page
+
+**Required Implementation:**
+- Statistics cards (transactions, volume, reporting required)
+- Recent activity feed
+- Compliance status indicators
+- Charts and visualizations
+- Quick actions
+
+**Priority:** IMMEDIATE (Week 1)
+
+---
+
+### 1.2 Toast Notification System - Not Integrated
+
+**Current State:**
+- ✅ Toast component exists (`components/Toast.tsx`)
+- ✅ useToast hook exists (`hooks/useToast.ts`)
+- ❌ **NOT USED ANYWHERE** in the application
+- ❌ All errors go to console.error
+- ❌ No user feedback for actions
+
+**Impact:** HIGH - Users don't know if actions succeeded or failed
+
+**Required Actions:**
+- Integrate useToast in all pages
+- Replace console.error with toast notifications
+- Add success toasts for form submissions
+- Add error toasts with user-friendly messages
+- Add warning toasts for validation issues
+
+**Priority:** IMMEDIATE (Week 1)
+
+---
+
+### 1.3 Navigation - Basic Implementation
+
+**Current State:**
+- ⚠️ Functional but minimal
+- ❌ No icons on menu items
+- ❌ No active state indicators
+- ❌ No user menu/profile
+- ❌ No notifications indicator
+- ❌ No breadcrumbs
+- ❌ No search functionality
+
+**Impact:** MEDIUM - Navigation works but lacks polish
+
+**Priority:** HIGH (Week 2-3)
+
+---
+
+## 2. CONTROL PANEL LOOK & FEEL
+
+### 2.1 Header/App Bar Design
+
+#### Current Implementation:
+```tsx
+// Basic text-only navigation
+
+ Brazil SWIFT Operations
+ Dashboard
+ Transactions
+ // ...
+
+```
+
+#### Recommended Design:
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│ [🏦 Logo] Brazil SWIFT Operations │ Nav │ [🔔 3] [👤] [⚙] [❓] │
+├─────────────────────────────────────────────────────────────────────┤
+│ Dashboard │ Transactions │ Treasury │ Reports │ Audit │ Settings │
+│ (active) │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+#### Implementation Details:
+
+1. **Logo Section:**
+ ```tsx
+
+
+
+
+
Total Transactions
+
1,234
+
↑ 12% from last month
+
+
+
+
+
+
+ // ... more cards
+
+```
+
+**Features:**
+- Icon for each metric
+- Trend indicators (↑/↓ with percentage)
+- Hover effects
+- Clickable to drill down
+- Color-coded by type
+
+---
+
+### 3.3 Charts Integration
+
+**Current State:**
+- Charts.tsx exists with basic SVG charts
+- Not used in Dashboard
+
+**Recommendation:**
+- Option 1: Enhance Charts.tsx with more features
+- Option 2: Replace with Chart.js or Recharts
+
+**Chart.js Implementation Example:**
+```tsx
+import { Line } from 'react-chartjs-2';
+
+
+```
+
+**Features Needed:**
+- Interactive tooltips
+- Zoom and pan
+- Export as image
+- Real-time updates
+- Responsive design
+
+---
+
+## 4. NAVIGATION ENHANCEMENTS
+
+### 4.1 Active State Styling
+
+#### Current:
+```tsx
+
Transactions
+// No visual indication of active page
+```
+
+#### Recommended:
+```tsx
+
+
+ Transactions
+
+```
+
+---
+
+### 4.2 Menu Icons
+
+**Icon Library Recommendation:**
+- React Icons (comprehensive, tree-shakeable)
+- Heroicons (Tailwind-friendly)
+- Lucide React (modern, consistent)
+
+**Implementation:**
+```tsx
+import {
+ HomeIcon,
+ DocumentTextIcon,
+ BanknotesIcon,
+ ChartBarIcon,
+ ShieldCheckIcon
+} from '@heroicons/react/24/outline';
+
+
+
+ Dashboard
+
+```
+
+---
+
+### 4.3 User Menu
+
+#### Design:
+```
+┌─────────────────┐
+│ 👤 John Doe │
+│ john@bank.com │
+├─────────────────┤
+│ Profile │
+│ Preferences │
+│ Notifications │
+│ Help │
+├─────────────────┤
+│ Logout │
+└─────────────────┘
+```
+
+**Features:**
+- User avatar/initials
+- User name and email
+- Dropdown menu
+- Logout option
+- Profile link
+- Settings link
+
+---
+
+### 4.4 Notifications System
+
+#### Design:
+```
+┌─────────────────────────────┐
+│ 🔔 Notifications (3) │
+├─────────────────────────────┤
+│ ⚠️ Transaction TXN-123 │
+│ requires approval │
+│ 2 hours ago │
+├─────────────────────────────┤
+│ ✅ Report generated │
+│ BCB_Report_2026-01-23 │
+│ 5 hours ago │
+├─────────────────────────────┤
+│ [View All] │
+└─────────────────────────────┘
+```
+
+**Features:**
+- Badge count on bell icon
+- Dropdown with recent notifications
+- Mark as read
+- Click to navigate to related item
+- Notification types (success, warning, error, info)
+- Auto-dismiss after read
+
+---
+
+## 5. FORM & INPUT IMPROVEMENTS
+
+### 5.1 Input Field Enhancements
+
+#### Current:
+```tsx
+
+```
+
+#### Recommended:
+```tsx
+
+
+ Amount *
+ (USD)
+
+
+
+ $
+
+
+
+ {error && (
+
+
+ {error}
+
+ )}
+ {helpText && (
+
{helpText}
+ )}
+
+```
+
+**Features:**
+- Input icons/prefixes
+- Help text below inputs
+- Error messages with icons
+- Focus states
+- Validation feedback
+- Required field indicators
+
+---
+
+### 5.2 Form Layout Improvements
+
+**Current Issues:**
+- Forms are functional but basic
+- No visual grouping
+- No progress indicators
+- No field dependencies
+
+**Recommendations:**
+1. **Visual Grouping:**
+ ```tsx
+
+
+ Transaction Details
+ {/* Fields */}
+
+
+ Customer Information
+ {/* Fields */}
+
+
+ ```
+
+2. **Multi-Step Forms:**
+ ```tsx
+
+ ```
+
+3. **Field Dependencies:**
+ ```tsx
+ {formData.direction === 'outbound' && (
+
+ )}
+ ```
+
+---
+
+## 6. TABLE IMPROVEMENTS
+
+### 6.1 Enhanced Table Features
+
+#### Current:
+- Basic table with data
+- No sorting
+- No filtering
+- No pagination
+- No row selection
+
+#### Recommended Features:
+
+1. **Sorting:**
+ ```tsx
+
handleSort('amount')}>
+ Amount
+ {sortField === 'amount' && (
+ {sortDirection === 'asc' ? '↑' : '↓'}
+ )}
+
+ ```
+
+2. **Filtering:**
+ ```tsx
+
+ setSearchTerm(e.target.value)}
+ />
+ setStatusFilter(e.target.value)}>
+ All Status
+ Pending
+ {/* ... */}
+
+
+ ```
+
+3. **Pagination:**
+ ```tsx
+
+
+ Showing 1-10 of 100 transactions
+
+
+ Previous
+ Page {page} of {totalPages}
+ Next
+
+
+ ```
+
+4. **Row Selection:**
+ ```tsx
+
+ toggleRow(row.id)}
+ />
+
+ ```
+
+5. **Bulk Actions:**
+ ```tsx
+ {selectedRows.length > 0 && (
+
+
{selectedRows.length} items selected
+
Export Selected
+
Approve Selected
+
+ )}
+ ```
+
+6. **Column Visibility:**
+ ```tsx
+
setShowColumns(!showColumns)}>
+ Columns
+
+ {showColumns && (
+
+ {columns.map(col => (
+
+
+ {col.label}
+
+ ))}
+
+ )}
+ ```
+
+---
+
+## 7. MODAL & DIALOG IMPROVEMENTS
+
+### 7.1 Modal Enhancements
+
+#### Current:
+- Basic modals exist
+- No size variants
+- No animations
+- Basic styling
+
+#### Recommended:
+
+1. **Size Variants:**
+ ```tsx
+ const sizes = {
+ sm: 'max-w-md',
+ md: 'max-w-lg',
+ lg: 'max-w-2xl',
+ xl: 'max-w-4xl',
+ full: 'max-w-full'
+ };
+ ```
+
+2. **Animations:**
+ ```tsx
+ // Fade in backdrop
+
+ {/* Slide up modal */}
+
+ {/* Content */}
+
+
+ ```
+
+3. **Focus Trap:**
+ ```tsx
+ // Use focus-trap-react library
+
+
+ {/* Content */}
+
+
+ ```
+
+4. **Close on Escape:**
+ ```tsx
+ useEffect(() => {
+ const handleEscape = (e: KeyboardEvent) => {
+ if (e.key === 'Escape') onClose();
+ };
+ window.addEventListener('keydown', handleEscape);
+ return () => window.removeEventListener('keydown', handleEscape);
+ }, [onClose]);
+ ```
+
+---
+
+## 8. LOADING STATES
+
+### 8.1 Skeleton Loaders
+
+#### Current:
+- LoadingSpinner component exists
+- Used in some places
+- No skeleton loaders
+
+#### Recommended:
+
+**Replace spinners with skeletons:**
+
+```tsx
+// Table skeleton
+
+ {[1,2,3,4,5].map(i => (
+
+ ))}
+
+
+// Card skeleton
+
+```
+
+**Benefits:**
+- Better perceived performance
+- Users see structure while loading
+- Less jarring than spinners
+
+---
+
+### 8.2 Progress Indicators
+
+**For Long Operations:**
+```tsx
+
+
+ Processing... {progress}% (Estimated time: {estimatedTime}s)
+
+```
+
+---
+
+## 9. EMPTY STATES
+
+### 9.1 Empty State Design
+
+#### Current:
+- Basic "No data" messages
+- No illustrations
+- No action buttons
+
+#### Recommended:
+
+```tsx
+
+
+
+ No transactions yet
+
+
+ Get started by creating your first transaction
+
+
+ Create Transaction
+
+
+```
+
+**Features:**
+- Illustrations (SVG or images)
+- Helpful messages
+- Action buttons
+- Examples or templates
+
+---
+
+## 10. ERROR STATES
+
+### 10.1 Error Page Design
+
+#### Current:
+- ErrorBoundary exists
+- Basic error display
+
+#### Recommended:
+
+```tsx
+
+
+
+
Something went wrong
+
{errorMessage}
+
+ Try Again
+ Go Home
+ Report Issue
+
+ {errorCode && (
+
+ Error Code: {errorCode}
+
+ )}
+
+
+```
+
+---
+
+## 11. COLOR SCHEME & BRANDING
+
+### 11.1 Design Tokens
+
+#### Recommended Color Palette:
+
+```css
+/* Primary Colors */
+--color-primary: #2563eb; /* Blue-600 */
+--color-primary-dark: #1d4ed8; /* Blue-700 */
+--color-primary-light: #3b82f6; /* Blue-500 */
+
+/* Status Colors */
+--color-success: #10b981; /* Green-500 */
+--color-warning: #f59e0b; /* Amber-500 */
+--color-error: #ef4444; /* Red-500 */
+--color-info: #3b82f6; /* Blue-500 */
+
+/* Neutral Colors */
+--color-gray-50: #f9fafb;
+--color-gray-100: #f3f4f6;
+--color-gray-900: #111827;
+```
+
+#### Typography Scale:
+```css
+--font-size-xs: 0.75rem; /* 12px */
+--font-size-sm: 0.875rem; /* 14px */
+--font-size-base: 1rem; /* 16px */
+--font-size-lg: 1.125rem; /* 18px */
+--font-size-xl: 1.25rem; /* 20px */
+--font-size-2xl: 1.5rem; /* 24px */
+--font-size-3xl: 1.875rem; /* 30px */
+```
+
+---
+
+## 12. RESPONSIVE DESIGN
+
+### 12.1 Mobile Optimization
+
+#### Current Issues:
+- Desktop-first design
+- Tables may not be mobile-friendly
+- Navigation may overflow on mobile
+
+#### Recommendations:
+
+1. **Mobile Navigation:**
+ ```tsx
+ {/* Hamburger menu for mobile */}
+
setMobileMenuOpen(!mobileMenuOpen)}>
+
+
+
+ {/* Slide-out menu */}
+ {mobileMenuOpen && (
+
+
+ {/* Menu items */}
+
+
+ )}
+ ```
+
+2. **Responsive Tables:**
+ ```tsx
+ {/* Desktop: Table */}
+
+ {/* Table content */}
+
+
+ {/* Mobile: Cards */}
+
+ {data.map(item => (
+
+ {/* Card content */}
+
+ ))}
+
+ ```
+
+3. **Touch-Friendly Buttons:**
+ ```tsx
+
+ {/* Minimum touch target size */}
+
+ ```
+
+---
+
+## 13. ACCESSIBILITY
+
+### 13.1 WCAG 2.1 Compliance
+
+#### Recommendations:
+
+1. **ARIA Labels:**
+ ```tsx
+
+
+
+ ```
+
+2. **Keyboard Navigation:**
+ - Tab order should be logical
+ - All interactive elements should be keyboard accessible
+ - Skip links for main content
+
+3. **Focus Indicators:**
+ ```css
+ *:focus-visible {
+ outline: 2px solid var(--color-primary);
+ outline-offset: 2px;
+ }
+ ```
+
+4. **Color Contrast:**
+ - Ensure WCAG AA compliance (4.5:1 for text)
+ - Don't rely solely on color for information
+
+5. **Screen Reader Support:**
+ ```tsx
+
+ {errorMessage}
+
+ ```
+
+---
+
+## 14. IMPLEMENTATION PRIORITY
+
+### Phase 1: Critical (Week 1)
+1. ✅ Implement Dashboard page (2-3 days)
+2. ✅ Integrate Toast notifications (1 day)
+3. ✅ Add navigation icons and active states (1 day)
+
+### Phase 2: High Priority (Week 2-3)
+4. Add user menu and profile section
+5. Add notifications system
+6. Enhance forms with better UX
+7. Add table sorting/filtering
+
+### Phase 3: Polish (Week 4-5)
+8. Create design system
+9. Add skeleton loaders
+10. Improve empty/error states
+11. Add breadcrumbs
+12. Add global search
+
+### Phase 4: Advanced (Week 6+)
+13. Add keyboard shortcuts
+14. Add dark mode (optional)
+15. Add animations/transitions
+16. Performance optimization
+
+---
+
+## 15. COMPONENT LIBRARY RECOMMENDATIONS
+
+### Recommended Libraries:
+
+1. **Icons:**
+ - `react-icons` or `@heroicons/react`
+ - Comprehensive, tree-shakeable
+
+2. **Charts:**
+ - `recharts` (React-friendly)
+ - `chart.js` with `react-chartjs-2`
+ - Both are good choices
+
+3. **UI Components:**
+ - `@headlessui/react` (unstyled, accessible)
+ - `radix-ui` (accessible primitives)
+ - Or build custom with Tailwind
+
+4. **Form Handling:**
+ - `react-hook-form` (already could use)
+ - `zod` for validation
+
+5. **Animations:**
+ - `framer-motion` (smooth animations)
+ - Or CSS transitions
+
+---
+
+## 16. SPECIFIC PAGE RECOMMENDATIONS
+
+### 16.1 Dashboard Page
+
+**Layout:**
+- 4-column statistics cards at top
+- 2-column chart layout below
+- Full-width recent activity table
+- Compliance status section at bottom
+
+**Components Needed:**
+- StatCard component
+- Chart components (enhance existing or replace)
+- ActivityFeed component
+- ComplianceStatus component
+
+---
+
+### 16.2 Transactions Page
+
+**Enhancements:**
+- Add search bar at top
+- Add filters (date range, status, currency)
+- Add bulk actions toolbar
+- Add export button
+- Add transaction templates dropdown
+- Add batch upload button
+
+---
+
+### 16.3 Treasury Page
+
+**Enhancements:**
+- Add account hierarchy tree view
+- Add transfer history table (not just modal)
+- Add account search
+- Add balance alerts configuration
+- Add account reconciliation UI
+
+---
+
+### 16.4 Reports Page
+
+**Enhancements:**
+- Add report templates
+- Add scheduled reports configuration
+- Add report comparison view
+- Add report sharing
+- Add report preview before generation
+
+---
+
+## 17. QUICK WINS (This Week)
+
+1. **Implement Dashboard** (2-3 days)
+ - Use existing Charts.tsx
+ - Add statistics cards
+ - Add recent activity
+
+2. **Integrate Toasts** (1 day)
+ - Add to all form submissions
+ - Replace console.error
+
+3. **Add Navigation Icons** (1 day)
+ - Install react-icons
+ - Add icons to all menu items
+
+4. **Add Active State Styling** (1 day)
+ - Highlight current page
+ - Add visual indicators
+
+5. **Add User Menu** (1 day)
+ - Dropdown with profile/logout
+ - Place in header
+
+**Total: ~1 week of work**
+
+---
+
+## 18. CONCLUSION
+
+The application has solid functionality but needs significant UX polish. The most critical items are:
+
+1. **Dashboard implementation** (currently empty)
+2. **Toast notification integration** (exists but unused)
+3. **Navigation enhancements** (icons, active states)
+4. **User menu/profile** (missing)
+
+With focused effort, these can be completed in 1-2 weeks, significantly improving the user experience.
+
+**Target:** Professional, regulator-grade control panel interface that matches the quality of the backend functionality.
+
+---
+
+**Document Version:** 1.0
+**Last Updated:** 2026-01-23