sovd_web_ui

Simple, open-source web UI for browsing SOVD (Service-Oriented Vehicle Diagnostics) entity trees via discovery endpoints.

What is sovd_web_ui?

sovd_web_ui is a lightweight single-page application that connects to a SOVD server and visualizes the entity hierarchy. It provides:

• Server Connection Dialog - Enter the URL of your SOVD server (supports both http://ip:port and ip:port formats)
• Entity Tree Sidebar - Browse the hierarchical structure of SOVD entities with lazy-loading
• Entity Detail Panel - View raw JSON details of any selected entity

This tool is designed for developers and integrators working with SOVD-compatible systems who need a quick way to explore and debug the entity structure.

Status

Early prototype / work in progress

This is an open source project for exploring SOVD entity discovery. APIs and features may change as the project evolves.

Target Use Cases

• Exploring SOVD entity hierarchy on a connected server
• Debugging SOVD discovery endpoints
• Quick inspection of entity metadata and structure
• Learning about SOVD entity models

Quick Start

Using Docker

docker build -t sovd_web_ui .
docker run -p 8080:80 sovd_web_ui

Then open http://localhost:8080 in your browser.

Development

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

Usage

1. Open the application in your browser
2. Enter the SOVD server URL in the connection dialog (e.g., 192.168.1.100:8080 or http://localhost:3000)
3. Click "Connect" to establish connection
4. Browse the entity tree in the left sidebar
5. Click on any entity to view its details in the main panel

Tech Stack

• React 19 - UI framework
• TypeScript - Type safety
• Vite - Build tool
• TailwindCSS 4 - Styling
• shadcn/ui - UI components
• Zustand - State management
• lucide-react - Icons

Contributing

Contributions and feedback are welcome! Please read CONTRIBUTING.md for guidelines.

By contributing, you agree to follow the CODE_OF_CONDUCT.md.

Security

If you discover a security vulnerability, please follow the process in SECURITY.md.

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.