The Projects tab (ProjectsPage.qml, route Projects) is the entry point of DeepHistoImageAI Desktop. A project binds a local directory on disk (managed under your configured Projects folder) with a per-project SQLite database tracking whole-slide image references, annotations, datasets, and local model associations.
Projects Overview header buttons (New Project, Import Project, Import QuPath Project) above the searchable project table.
Availability & Prerequisites
Active Project Required: None (this is where you create or open a project).
Folder Requirement: Creating a new project or importing a QuPath project requires a configured Projects folder in Admin → Settings. Otherwise, the noPathDialog prompts you to configure one first.
Step-by-Step User Workflows
1. Create a New Project
Click New Project in the top-right header.
In Create New Project (createProjectDialog), verify the Projects folder parent directory (click Browse if you want to override it for this project).
Enter a Project name. Notice the live preview banner confirming the exact folder path (<Projects folder>/<Project name>).
Click Create. Once created, the toast confirms readiness and the project appears in the table.
2. Open, Rename, or Delete a Project
Open project: Click the Play (▶) action button on a project row. Opening a project activates it globally across the desktop and automatically navigates to the Viewer tab.
Rename project: Click the Pencil icon (Rename project) to open renameProjectDialog, edit the name, and confirm.
Delete project: Click the Trash icon to open deleteProjectConfirmDialog. Optionally choose whether to remove only the project list entry or delete files from disk before confirming.
3. Import a QuPath Project
Click Import QuPath Project.
Select the source QuPath project directory (.qpproj) in the qupathProjectDialog workflow and choose the destination project settings.
Imported slide references and supported annotations are converted into a DeepHistoImageAI project ready for inspection in Viewer.
flowchart LR
Empty["No active project"] --> NewProj["New Project / Import QuPath Project"]
Empty --> OpenProj["Click Open (Play icon) on existing row"]
NewProj --> Active["Project Active in SQLite"]
OpenProj --> Active
Active --> Viewer["Auto-navigate to Viewer tab"]
UI Controls & Table Columns Reference
Header Actions
Control
Object Name / Label
State Behavior
Action
New Project
newProjectButton (New Project)
Disabled while projectViewModel.busy is true
Opens createProjectDialog (or noPathDialog if no root projects folder exists)
Import Project
importProjectButton (Import Project)
Currently disabled (disabled: true in UI)
Reserved for importing an existing DeepHistoImageAI project folder
Import QuPath Project
importQuPathProjectButton (Import QuPath Project)
Disabled while projectViewModel.busy or quPathImportViewModel.busy
Opens QuPath project import flow
Projects Table (projectsDataTableSection)
Column Key
Header Label
Width / Display
Description
name
Name
Fixed 180px, colored via nameColor
Project display name
root_path
Path
Flex fill, monospace font
Filesystem directory path containing the project database and artifacts
actions
Actions
Row action icons
Open project (play), Rename project (pencil), Delete (trash-2)
Additional table controls:
Search bar:"Search projects..." filters rows incrementally by name or path.
Summary text:"Showing <count> projects".
Empty state: Displays "No projects yet — Create a new project to get started with WSI analysis" when projectCount === 0.
Dialogs & Modals
Dialog
Trigger
Key Inputs / Confirmations
createProjectDialog
New Project
Parent folder (Browse), live target path preview, Project name input
Source .qpproj selection and import mapping summary
noPathDialog
Create/Import without Projects folder
Quick action button navigating to Settings
Technical Reference
Persistence: Each project stores its metadata in a per-project SQLite database inside its root_path; WSI slide binaries are referenced by filesystem path rather than copied unnecessarily.
Toast Feedback Signals:onProjectCreated, onProjectOpened, onProjectRenamed, onProjectDeletionStarted, onProjectDeleted, and onValidationErrorOccurred.