mirror of
https://github.com/NVIDIA/dgx-spark-playbooks.git
synced 2026-04-22 18:13:52 +00:00
53 lines
1.6 KiB
Markdown
53 lines
1.6 KiB
Markdown
# Frontend
|
|
|
|
Next.js React application providing the user interface for the chatbot demo.
|
|
|
|
## Overview
|
|
|
|
The frontend provides a chat interface with support for:
|
|
- Multi-model conversations
|
|
- Document upload and RAG (Retrieval Augmented Generation)
|
|
- Image processing capabilities
|
|
- Real-time streaming responses via WebSocket
|
|
- Theme switching (light/dark mode)
|
|
- Sidebar configuration for models and data sources
|
|
|
|
## Key Components
|
|
|
|
- **QuerySection**: Main chat interface with message display and input
|
|
- **Sidebar**: Configuration panel for models, sources, and chat history
|
|
- **DocumentIngestion**: File upload interface for RAG functionality
|
|
- **WelcomeSection**: Landing page with quick-start templates
|
|
- **ThemeToggle**: Dark/light mode switcher
|
|
|
|
## Architecture
|
|
|
|
Built with Next.js 14, TypeScript, and CSS modules. Communicates with the backend via REST API and WebSocket connections for real-time chat streaming.
|
|
|
|
## Docker Troubleshooting
|
|
|
|
### Container Issues
|
|
- **Port conflicts**: Ensure port 3000 is not in use by other applications
|
|
- **Build failures**: Clear Docker cache with `docker system prune -a`
|
|
- **Hot reload not working**: Restart the container or check volume mounts
|
|
|
|
### Common Commands
|
|
```bash
|
|
# View frontend logs
|
|
docker logs frontend
|
|
|
|
# Restart frontend container
|
|
docker restart frontend
|
|
|
|
# Rebuild frontend
|
|
docker-compose up --build -d frontend
|
|
|
|
# Access container shell
|
|
docker exec -it frontend /bin/sh
|
|
```
|
|
|
|
### Performance Issues
|
|
- Check available memory: `docker stats`
|
|
- Increase Docker memory allocation in Docker Desktop settings
|
|
- Clear browser cache and cookies for localhost:3000
|