ISC QtQuick App

Small PySide6 + Qt Quick application scaffold for the ISenseCloud desktop UI shell.

Requirements

• Python 3.10+ (tested with Python 3.14 in this workspace)
• macOS, Linux, or Windows with GUI support

Setup

From the project root:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -r requirements.txt

Run

source .venv/bin/activate
python main.py

This launches the Qt window and loads the ISC QML module from ISC/Main.qml.

Project Structure

• main.py: PySide6 bootstrap; creates the Qt app and loads QML module ISC/Main.
• ISC/Main.qml: top-level window definition.
• ISC/HomePage.qml: main UI layout (left action rail, workspace panel, footer tabs).
• ISC/Theme.qml: shared theme constants and dark/light mode tokens.
• ISC/qmldir: QML module registration.

Window Configuration

Window dimensions and constraints are defined in ISC/Main.qml:

• Default size: 1400 × 820 pixels
• Minimum size: 1100 × 700 pixels
• Title bar: "ISenseCloud"

To adjust the window, edit the Window block in ISC/Main.qml:

Window {
    width: 1400
    height: 820
    minimumWidth: 1100
    minimumHeight: 700
    visible: true
    title: qsTr("ISenseCloud")
}

Customization

• Toggle dark/light mode in ISC/Theme.qml via isDarkMode.
• Update sidebar and footer labels in ISC/HomePage.qml through sideActions and bottomTabs.

Troubleshooting

• If the app does not start, verify the venv is active and dependencies are installed:

  source .venv/bin/activate
  pip install -r requirements.txt
  

• If no window appears, ensure you are running in a desktop session with GUI access.