UI_README.mdā¢4.13 kB
# šØ Beautiful UI Design - User Guide
## ⨠New Attractive Web Interface
A modern, beautiful web interface has been created for the Semiconductor Component Search system!
### š Access the UI
**Open in your browser:**
```
http://localhost:8001/
```
This provides a beautiful, user-friendly interface with:
- ā
Modern dark theme design
- ā
Drag & drop file upload
- ā
Interactive question answering
- ā
Real-time status indicators
- ā
Beautiful animations and transitions
- ā
Responsive design for all devices
- ā
Toast notifications
- ā
Loading indicators
### šØ Features
#### 1. **Upload Section**
- **Drag & drop** Excel files directly
- **Click to browse** for files
- **Progress indicator** during upload
- **Success/Error notifications**
- **Visual feedback** for all actions
#### 2. **Question Section**
- **Interactive search bar** with icon
- **Quick question buttons** for common queries
- **Real-time answer display**
- **Context visualization**
- **Copy to clipboard** functionality
- **Auto-scroll to answers**
#### 3. **Information Panel**
- **Live collection statistics**
- **Document count** display
- **Status indicators**
- **Refresh button** for real-time updates
#### 4. **Design Elements**
- **Dark theme** with gradient accents
- **Smooth animations** and transitions
- **Modern card-based layout**
- **Color-coded status badges**
- **Professional typography**
- **Responsive grid layouts**
### š± Responsive Design
The UI is fully responsive and works on:
- ā
Desktop computers
- ā
Tablets
- ā
Mobile phones
### šÆ Quick Start
1. **Open browser**: Go to `http://localhost:8001/`
2. **Upload file**: Drag and drop or click to upload Excel file
3. **Ask questions**: Type your question or click quick question buttons
4. **View answers**: See formatted answers with context
5. **Copy results**: Click copy button to copy answers
### š” User Experience Features
- **Real-time status**: Connection status indicator
- **Loading overlays**: Visual feedback during processing
- **Toast notifications**: Success/error messages
- **Smooth animations**: Professional transitions
- **Keyboard shortcuts**: Press Enter to ask questions
- **Quick actions**: Pre-defined question buttons
### šØ Design Highlights
- **Color Scheme**: Modern dark theme with purple/indigo gradients
- **Typography**: Inter font family for readability
- **Icons**: Font Awesome icons throughout
- **Shadows**: Subtle depth with layered shadows
- **Borders**: Rounded corners and subtle borders
- **Hover Effects**: Interactive elements respond to user actions
### š Visual Elements
- **Status Badge**: Shows connection status with pulsing indicator
- **Progress Bar**: Animated progress during file upload
- **Answer Cards**: Formatted answer display with context
- **Info Cards**: Statistics with icons and numbers
- **Quick Buttons**: Styled question buttons with hover effects
### š Technical Details
- **Framework**: Vanilla JavaScript (no dependencies)
- **Styling**: Custom CSS with CSS Variables
- **API Integration**: Fetch API for backend communication
- **File Handling**: Drag & drop with file validation
- **Error Handling**: User-friendly error messages
### š File Structure
```
static/
āāā index.html # Main UI page
āāā styles.css # Beautiful styling
āāā script.js # Interactive functionality
```
### šÆ Usage
1. **Server must be running**: `python main.py`
2. **Open browser**: Navigate to `http://localhost:8001/`
3. **Start using**: Upload files and ask questions!
### šØ Customization
The UI uses CSS variables for easy customization:
- Colors: `--primary-color`, `--secondary-color`, etc.
- Spacing: Modify padding/margin values
- Fonts: Change font-family in CSS
- Theme: Adjust color variables for different themes
### ā
Benefits
- **User-Friendly**: Intuitive interface
- **Professional**: Modern design
- **Fast**: Lightweight and responsive
- **Accessible**: Clear visual feedback
- **Beautiful**: Attractive design
## š Ready to Use!
**Just open**: http://localhost:8001/
**Enjoy the beautiful UI!** š