DevDash Development Environment Setup

Development environment setup for the devdash-project ecosystem.

Quick Start

On a fresh Ubuntu 24.04 Server ARM64 VM (UTM on macOS):

curl -fsSL https://raw.githubusercontent.com/devdash-project/devdash-dev-setup/main/setup-vm.sh | bash

Or clone and run:

git clone https://github.com/devdash-project/devdash-dev-setup.git
cd devdash-dev-setup
./setup-vm.sh

What Gets Installed

Category	Components
Desktop	LXQt, SDDM, SPICE agent (clipboard sharing)
Build Tools	CMake, Ninja, Clang, GCC, clang-format, clang-tidy
Qt 6	Qt 6.2 (system), instructions for Qt 6.10+
Media	GStreamer (all plugins), PipeWire audio
CAN Bus	can-utils, vcan0 systemd service
Containers	Docker, docker-compose
Python	python3, venv, haltech-mock
Node.js	LTS via nvm
AI Tools	Claude Code CLI
IDE	VS Code (ARM64)

Qt 6.10+ for qml-gauges

The system Qt 6.2 works for devdash, but qml-gauges requires Qt 6.10+ for:

• QtQuick.Effects (MultiEffect for glow/shadow)
• CurveRenderer for smooth needle animations

See docs/qt-6.10-setup.md for installation instructions.

VM Configuration (UTM on macOS)

See docs/utm-setup.md for:

• Creating the Ubuntu VM in UTM
• VirtioFS shared folder configuration
• Display and input settings
• Resource allocation recommendations

DevDash Project Ecosystem

Repository	Description
devdash	Main dashboard application (C++/QML)
qml-gauges	Standalone gauge component library
haltech-mock	Haltech ECU CAN bus simulator (Python)
devdash-mcp	MCP server for AI tool integration
devdash-dev-setup	This repo - environment setup

After Setup

1. Reboot to start the graphical desktop
2. Verify the installation:

   docker run hello-world
   ip link show vcan0
   ls ~/Projects

3. Clone projects:

   cd ~/Projects/personal/devDashProject
   git clone git@github.com:devdash-project/devdash.git
   git clone git@github.com:devdash-project/qml-gauges.git

License

MIT