Fix TreeView nesting for ColumnLayout.

Parent folders will now be hidden based on the root folder selection in
the GUI.

README.md

@@ -19,6 +19,22 @@ And of course, [Rust](https://www.rust-lang.org/tools/install).
 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 ```
 
+This project requires at least Qt 6.7. To check your Qt version
+
+```bash
+qmake6 -query QT_VERSION
+```
+
+Use the [Qt Installer](https://www.qt.io/development/download) to download and install the Qt version of your choice.
+
+**You must set the QMAKE variable before building clide**. This should be a path to `qmake6` binary installed on your system.
+The following export is the default installation path for Qt 6.7 on Ubuntu 24.04
+
+```bash
+export QMAKE=$HOME/Qt/6.7.3/gcc_64/bin/qmake6
+export LD_LIBRARY_PATH=$HOME/Qt/6.7.3/gcc_64/lib
+```
+
 ## Usage 
 
 To install and run clide
@@ -126,6 +142,7 @@ Some helpful links for reading up on QML if you're just getting started.
 * [All QML Controls Types](https://doc.qt.io/qt-6/qtquick-controls-qmlmodule.html)
 * [KDAB CXX-Qt Book](https://kdab.github.io/cxx-qt/book/)
 * [github.com/KDAB/cxx-qt](https://github.com/KDAB/cxx-qt)
+* [QML and C++ Intergration](https://doc.qt.io/qt-6/qtqml-cppintegration-overview.html)
 
 
 ### Plugins

build.rs

@@ -18,6 +18,7 @@ fn main() {
     .qt_module("Gui")
     .qt_module("Svg")
     .qt_module("Xml")
+    .qrc("./resources.qrc")
     .files(["src/gui/colors.rs", "src/gui/filesystem.rs"])
     .build();
 }

qml/ClideAboutWindow.qml

@@ -1,4 +1,6 @@
-// TODO: Header
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
 
 import QtQuick
 import QtQuick.Controls.Basic
@@ -29,7 +31,7 @@ ApplicationWindow {
         anchors.top: parent.top
         anchors.margins: 20
 
-        source: "../icons/kilroy-256.png"
+        source: "qrc:/images/kilroy.png"
         sourceSize.width: 80
         sourceSize.height: 80
         fillMode: Image.PreserveAspectFit

qml/ClideEditor.qml

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts

qml/ClideMenuBar.qml

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 import QtQuick
 import QtQuick.Controls
 

qml/ClideProjectView.qml

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts
@@ -39,11 +43,26 @@ SplitView {
         SplitView.preferredWidth: 200
         SplitView.maximumWidth: 250
 
-        StackLayout {
-            anchors.fill: parent
+        ColumnLayout {
+            spacing: 2
+            Rectangle {
+                width: navigationView.width
+                height: breadCrumb.height + 5
+
+                color: RustColors.explorer_text
+                Text {
+                    id: breadCrumb
+                    text: clideTreeView.rootDirectory
+                    elide: Text.ElideLeft
+                    horizontalAlignment: Text.AlignHCenter
+                }
+            }
+
             ClideTreeView {
                 id: clideTreeView
                 onFileClicked: path => root.projectDir = path
+                width: navigationView.width
+                height: navigationView.height
 
                 // Path to the directory opened in the file explorer.
                 rootDirectory: root.projectDir

qml/ClideTreeView.qml

@@ -1,151 +1,172 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 import QtQuick
+import QtQuick.Effects
 import QtQuick.Controls
-import QtQuick.Layouts
 
 import clide.module 1.0
 
-Rectangle {
-    id: root
-    color: RustColors.explorer_background
+TreeView {
+    id: fileSystemTreeView
+    model: FileSystem
+
+    property int lastIndex: -1
 
     required property string rootDirectory
 
     signal fileClicked(string filePath)
 
-    TreeView {
-        id: fileSystemTreeView
-        anchors.margins: 15
 
-        property int lastIndex: -1
+    rootIndex: FileSystem.rootIndex
+    leftMargin: 5
+    boundsBehavior: Flickable.StopAtBounds
+    boundsMovement: Flickable.StopAtBounds
+    clip: true
 
-        model: FileSystem
-        anchors.fill: parent
-        boundsBehavior: Flickable.StopAtBounds
-        boundsMovement: Flickable.StopAtBounds
-        clip: true
+    Component.onCompleted: {
+        FileSystem.rootIndex = FileSystem.setDirectory(fileSystemTreeView.rootDirectory)
+    }
 
-        Component.onCompleted: {
-            FileSystem.setDirectory(root.rootDirectory)
-            fileSystemTreeView.expandRecursively(0, -1)
+    // The delegate represents a single entry in the filesystem.
+    delegate: TreeViewDelegate {
+        id: treeDelegate
+        indentation: 6
+        implicitWidth: fileSystemTreeView.width > 0 ? fileSystemTreeView.width : 250
+        implicitHeight: 25
+
+        required property int index
+        required property url filePath
+        required property string fileName
+
+        indicator: Image {
+            id: directoryIcon
+
+            function setSourceImage() {
+                let folderOpen = "data:image/svg+xml;utf8,<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 576 512\"><!--!Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.--><path d=\"M88.7 223.8L0 375.8 0 96C0 60.7 28.7 32 64 32l117.5 0c17 0 33.3 6.7 45.3 18.7l26.5 26.5c12 12 28.3 18.7 45.3 18.7L416 96c35.3 0 64 28.7 64 64l0 32-336 0c-22.8 0-43.8 12.1-55.3 31.8zm27.6 16.1C122.1 230 132.6 224 144 224l400 0c11.5 0 22 6.1 27.7 16.1s5.7 22.2-.1 32.1l-112 192C453.9 474 443.4 480 432 480L32 480c-11.5 0-22-6.1-27.7-16.1s-5.7-22.2 .1-32.1l112-192z\"/></svg>";
+                let folderClosed = "data:image/svg+xml;utf8,<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 512 512\"><!--!Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.--><path d=\"M64 480H448c35.3 0 64-28.7 64-64V160c0-35.3-28.7-64-64-64H288c-10.1 0-19.6-4.7-25.6-12.8L243.2 57.6C231.1 41.5 212.1 32 192 32H64C28.7 32 0 60.7 0 96V416c0 35.3 28.7 64 64 64z\"/></svg>";
+                let file = "data:image/svg+xml;utf8,<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 384 512\"><!--!Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.--><path d=\"M0 64C0 28.7 28.7 0 64 0L224 0l0 128c0 17.7 14.3 32 32 32l128 0 0 288c0 35.3-28.7 64-64 64L64 512c-35.3 0-64-28.7-64-64L0 64zm384 64l-128 0L256 0 384 128z\"/></svg>";
+                // If the item has children, it's a directory.
+                if (treeDelegate.hasChildren) {
+                    return treeDelegate.expanded ?
+                        folderOpen : folderClosed;
+                } else {
+                    return file
+                }
+            }
+
+            x: treeDelegate.leftMargin + (treeDelegate.depth * treeDelegate.indentation)
+            anchors.verticalCenter: parent.verticalCenter
+            source: setSourceImage()
+            sourceSize.width: 15
+            sourceSize.height: 15
+            fillMode: Image.PreserveAspectFit
+
+            smooth: true
+            antialiasing: true
+            asynchronous: true
         }
 
-        // The delegate represents a single entry in the filesystem.
-        delegate: TreeViewDelegate {
-            id: treeDelegate
-            indentation: 8
-            implicitWidth: fileSystemTreeView.width > 0 ? fileSystemTreeView.width : 250
-            implicitHeight: 25
+        contentItem: Text {
+            text: treeDelegate.fileName
+            color: RustColors.explorer_text
+        }
 
-            required property int index
-            required property url filePath
-            required property string fileName
+        background: Rectangle {
+            // TODO: Fix flickering from color transition on states here.
+            color: (treeDelegate.index === fileSystemTreeView.lastIndex)
+                ? RustColors.explorer_text_selected
+                : (hoverHandler.hovered ? RustColors.explorer_hovered : "transparent")
+            radius: 2.5
+            opacity: hoverHandler.hovered ? 0.75 : 1.0
 
-            indicator: Image {
-                id: directoryIcon
-
-                function setSourceImage() {
-                    let folderOpen = "data:image/svg+xml;utf8,<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 576 512\"><!--!Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.--><path d=\"M88.7 223.8L0 375.8 0 96C0 60.7 28.7 32 64 32l117.5 0c17 0 33.3 6.7 45.3 18.7l26.5 26.5c12 12 28.3 18.7 45.3 18.7L416 96c35.3 0 64 28.7 64 64l0 32-336 0c-22.8 0-43.8 12.1-55.3 31.8zm27.6 16.1C122.1 230 132.6 224 144 224l400 0c11.5 0 22 6.1 27.7 16.1s5.7 22.2-.1 32.1l-112 192C453.9 474 443.4 480 432 480L32 480c-11.5 0-22-6.1-27.7-16.1s-5.7-22.2 .1-32.1l112-192z\"/></svg>";
-                    let folderClosed = "data:image/svg+xml;utf8,<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 512 512\"><!--!Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.--><path d=\"M64 480H448c35.3 0 64-28.7 64-64V160c0-35.3-28.7-64-64-64H288c-10.1 0-19.6-4.7-25.6-12.8L243.2 57.6C231.1 41.5 212.1 32 192 32H64C28.7 32 0 60.7 0 96V416c0 35.3 28.7 64 64 64z\"/></svg>";
-                    let file = "data:image/svg+xml;utf8,<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 384 512\"><!--!Font Awesome Free 6.7.2 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free Copyright 2025 Fonticons, Inc.--><path d=\"M0 64C0 28.7 28.7 0 64 0L224 0l0 128c0 17.7 14.3 32 32 32l128 0 0 288c0 35.3-28.7 64-64 64L64 512c-35.3 0-64-28.7-64-64L0 64zm384 64l-128 0L256 0 384 128z\"/></svg>";
-                    // If the item has children, it's a directory.
-                    if (treeDelegate.hasChildren) {
-                        return treeDelegate.expanded ?
-                            folderOpen : folderClosed;
-                    } else {
-                        return file
-                    }
-                }
-
-                x: treeDelegate.leftMargin + (treeDelegate.depth * treeDelegate.indentation)
-                anchors.verticalCenter: parent.verticalCenter
-                source: setSourceImage()
-                sourceSize.width: 15
-                sourceSize.height: 15
-                fillMode: Image.PreserveAspectFit
-
-                smooth: true
-                antialiasing: true
-                asynchronous: true
-            }
-
-            contentItem: Text {
-                text: treeDelegate.fileName
-                color: RustColors.explorer_text
-            }
-
-            background: Rectangle {
-                // TODO: Fix flickering from color transition on states here.
-                color: (treeDelegate.index === fileSystemTreeView.lastIndex)
-                    ? RustColors.explorer_text_selected
-                    : (hoverHandler.hovered ? RustColors.explorer_hovered : "transparent")
-                radius: 2.5
-                opacity: hoverHandler.hovered ? 0.75 : 1.0
-
-                Behavior on color {
-                    ColorAnimation {
-                        duration: 300
-                    }
-                }
-            }
-
-            HoverHandler {
-                id: hoverHandler
-            }
-
-            TapHandler {
-                acceptedButtons: Qt.LeftButton | Qt.RightButton
-                onSingleTapped: (eventPoint, button) => {
-                    switch (button) {
-                        case Qt.LeftButton:
-                            fileSystemTreeView.toggleExpanded(treeDelegate.row)
-                            fileSystemTreeView.lastIndex = treeDelegate.index
-                            // If this model item doesn't have children, it means it's
-                            // representing a file.
-                            if (!treeDelegate.hasChildren)
-                                root.fileClicked(treeDelegate.filePath)
-                            break;
-                        case Qt.RightButton:
-                            if (treeDelegate.hasChildren)
-                                contextMenu.popup();
-                            break;
-                    }
-                }
-            }
-
-            Menu {
-                id: contextMenu
-                Action {
-                    text: qsTr("Set as root index")
-                    onTriggered: {
-                        console.log("Setting directory: " + treeDelegate.filePath)
-                        FileSystem.setDirectory(treeDelegate.filePath)
-                    }
-                }
-                Action {
-                    text: qsTr("Reset root index")
-                    onTriggered: {
-                        FileSystem.setDirectory("")
-                    }
+            Behavior on color {
+                ColorAnimation {
+                    duration: 300
                 }
             }
         }
 
-        // Provide our own custom ScrollIndicator for the TreeView.
-        ScrollIndicator.vertical: ScrollIndicator {
-            active: true
-            implicitWidth: 15
+        MultiEffect {
+            id: iconOverlay
 
-            contentItem: Rectangle {
-                implicitWidth: 6
-                implicitHeight: 6
+            anchors.fill: directoryIcon
+            source: directoryIcon
+            colorization: 1.0
+            brightness: 1.0
+            colorizationColor: {
+                const isFile = !treeDelegate.hasChildren;
+                if (isFile)
+                    return Qt.lighter(RustColors.explorer_folder, 2)
 
-                color: RustColors.scrollbar
-                opacity: fileSystemTreeView.movingVertically ? 0.5 : 0.0
+                const isExpandedFolder = treeDelegate.expanded && treeDelegate.hasChildren;
+                if (isExpandedFolder)
+                    return Qt.darker(RustColors.explorer_folder, 2)
+                else
+                    return RustColors.explorer_folder
+            }
+        }
 
-                Behavior on opacity {
-                    OpacityAnimator {
-                        duration: 500
-                    }
+        HoverHandler {
+            id: hoverHandler
+            acceptedDevices: PointerDevice.Mouse
+        }
+
+        TapHandler {
+            acceptedButtons: Qt.LeftButton | Qt.RightButton
+            onSingleTapped: (eventPoint, button) => {
+                switch (button) {
+                    case Qt.LeftButton:
+                        fileSystemTreeView.toggleExpanded(treeDelegate.row)
+                        fileSystemTreeView.lastIndex = treeDelegate.index
+                        // If this model item doesn't have children, it means it's
+                        // representing a file.
+                        if (!treeDelegate.hasChildren)
+                            root.fileClicked(treeDelegate.filePath)
+                        break;
+                    case Qt.RightButton:
+                        if (treeDelegate.hasChildren)
+                            contextMenu.popup();
+                        break;
+                }
+            }
+        }
+
+        Menu {
+            id: contextMenu
+            Action {
+                text: qsTr("Set as root index")
+                onTriggered: {
+                    console.log("Setting directory: " + treeDelegate.filePath)
+                    FileSystem.rootIndex = FileSystem.setDirectory(treeDelegate.filePath)
+                }
+            }
+            Action {
+                text: qsTr("Reset root index")
+                onTriggered: {
+                    console.log("Reset root index")
+                    FileSystem.rootIndex = FileSystem.setDirectory(fileSystemTreeView.rootDirectory)
+                }
+            }
+        }
+    }
+
+    // Provide our own custom ScrollIndicator for the TreeView.
+    ScrollIndicator.vertical: ScrollIndicator {
+        active: true
+        implicitWidth: 15
+
+        contentItem: Rectangle {
+            implicitWidth: 6
+            implicitHeight: 6
+
+            color: RustColors.scrollbar
+            opacity: fileSystemTreeView.movingVertically ? 0.5 : 0.0
+
+            Behavior on opacity {
+                OpacityAnimator {
+                    duration: 500
                 }
             }
         }

qml/main.qml

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 import QtQuick
 import QtQuick.Controls
 import QtQuick.Layouts

resources.qrc

@@ -0,0 +1,5 @@
+<RCC>
+    <qresource prefix="/images">
+        <file alias="kilroy.png">images/kilroy-256.png</file>
+    </qresource>
+</RCC>

src/gui.rs

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 use crate::AppContext;
 use anyhow::Result;
 use cxx_qt_lib::{QMapPair, QMapPair_QString_QVariant, QString, QVariant};

src/gui/colors.rs

@@ -1,4 +1,9 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 #[cxx_qt::bridge]
+
 pub mod qobject {
     unsafe extern "C++" {
         include!("cxx-qt-lib/qcolor.h");
@@ -83,10 +88,10 @@ impl Default for RustColorsImpl {
             gutter: QColor::try_from("#1e1f22").unwrap(),
             explorer_hovered: QColor::try_from("#4c5053").unwrap(),
             explorer_text: QColor::try_from("#3b3b3b").unwrap(),
-            explorer_text_selected: QColor::try_from("#8b8b8b").unwrap(),
-            explorer_background: QColor::try_from("#676c70").unwrap(),
+            explorer_text_selected: QColor::try_from("#262626").unwrap(),
+            explorer_background: QColor::try_from("#1E1F22").unwrap(),
             explorer_folder: QColor::try_from("#54585b").unwrap(),
-            explorer_folder_open: QColor::try_from("#FFF").unwrap(),
+            explorer_folder_open: QColor::try_from("#2b2b2b").unwrap(),
         }
     }
 }

src/gui/filesystem.rs

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 #[cxx_qt::bridge]
 pub mod qobject {
     unsafe extern "C++" {

src/main.rs

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 use anyhow::{Context, Result, anyhow};
 use clap::Parser;
 use log::{info, trace};

src/tui.rs

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 mod about;
 mod app;
 mod component;

src/tui/about.rs

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 use ratatui::buffer::Buffer;
 use ratatui::layout::{Constraint, Direction, Layout, Rect};
 use ratatui::text::{Line, Span};

src/tui/app.rs

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 use crate::tui::about::About;
 use crate::tui::app::AppComponent::{AppEditor, AppExplorer, AppLogger};
 use crate::tui::component::{Action, Component, Focus, FocusState, Visibility, VisibleState};

src/tui/component.rs

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 #![allow(dead_code, unused_variables)]
 
 use crate::tui::component::Focus::Inactive;

src/tui/editor.rs

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 use crate::tui::component::{Action, Component, ComponentState, Focus, FocusState};
 use anyhow::{Context, Result, bail};
 use edtui::{

src/tui/editor_tab.rs

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 use crate::tui::component::{Action, Component, Focus, FocusState};
 use crate::tui::editor::Editor;
 use anyhow::{Context, Result, anyhow};

src/tui/explorer.rs

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 use crate::tui::component::{Action, Component, ComponentState, Focus, FocusState};
 use anyhow::{Context, Result, bail};
 use log::trace;

src/tui/logger.rs

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 use crate::tui::component::{Action, Component, ComponentState, Focus, FocusState};
 use log::{LevelFilter, trace};
 use ratatui::buffer::Buffer;

src/tui/menu_bar.rs

@@ -1,3 +1,7 @@
+// SPDX-FileCopyrightText: 2026, Shaun Reed <shaunrd0@gmail.com>
+//
+// SPDX-License-Identifier: GNU General Public License v3.0 or later
+
 use crate::tui::component::{Action, Component, ComponentState, FocusState};
 use crate::tui::menu_bar::MenuBarItemOption::{
     About, CloseTab, Exit, Reload, Save, ShowHideExplorer, ShowHideLogger,