mirror of https://github.com/NVIDIA/dgx-spark-playbooks.git synced 2026-04-22 18:13:52 +00:00

History

GitLab CI 24114f735c chore: Regenerate all playbooks		2025-10-06 12:57:08 +00:00
..
public	chore: Regenerate all playbooks	2025-10-04 21:21:42 +00:00
src	chore: Regenerate all playbooks	2025-10-06 12:57:08 +00:00
Dockerfile	chore: Regenerate all playbooks	2025-10-04 21:21:42 +00:00
eslint.config.mjs	chore: Regenerate all playbooks	2025-10-04 21:21:42 +00:00
next-env.d.ts	chore: Regenerate all playbooks	2025-10-04 21:21:42 +00:00
next.config.ts	chore: Regenerate all playbooks	2025-10-04 21:21:42 +00:00
package-lock.json	chore: Regenerate all playbooks	2025-10-04 21:21:42 +00:00
package.json	chore: Regenerate all playbooks	2025-10-04 21:21:42 +00:00
postcss.config.mjs	chore: Regenerate all playbooks	2025-10-04 21:21:42 +00:00
README.md	chore: Regenerate all playbooks	2025-10-05 22:27:47 +00:00
tailwind.config.ts	chore: Regenerate all playbooks	2025-10-04 21:21:42 +00:00
tsconfig.json	chore: Regenerate all playbooks	2025-10-04 21:21:42 +00:00

README.md

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

# 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