feat: Enhance category customization with modal

Introduce a new modal for comprehensive category styling, allowing users to select from curated themes or choose custom background and text colors. This also includes fixes for drag-and-drop reordering issues and blank loading screens.

Author: beNative

CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.8.0]
+
+### Fixed
+- **CRITICAL:** Fixed a persistent and critical bug that prevented drag-and-drop reordering of repository cards within the same category and in the "Uncategorized" section.
+- Fixed an issue where the application would show a blank "Loading settings..." screen when run in a web browser. It now loads instantly with default settings.
+
+### Changed
+- **Category Customization:** Replaced the simple color palette popover with a full-featured modal. Users can now choose from curated themes or select custom background and text colors for each category.
+- **UI Consistency:** Updated all tooltips on category headers to use the same styled component as the rest of the application for a more polished look.
+
 ## [0.7.0]
 
 ### Changed
@@ -166,4 +176,4 @@ All notable changes to this project will be documented in this file.
 -   Global settings for package manager and build commands.
 -   **Electron Packaging:** Application is fully packaged for Windows, macOS, and Linux using Electron and esbuild.
 -   **Automatic Updates:** Integrated `electron-updater` to automatically check for and install new versions from GitHub Releases.
--   **In-App Documentation Viewer:** Added an "Info Hub" to view the README, functional manual, technical manual, and this changelog directly within the application.
+-   **In-App Documentation Viewer:** Added an "Info Hub" to view the README, functional manual, technical manual, and this changelog directly within the application.

FUNCTIONAL_MANUAL.md

@@ -22,7 +22,7 @@ The dashboard is divided into collapsible sections called categories. This allow
 
 -   **Creating Categories:** Click the "Add Category" button at the bottom of the dashboard to create a new section.
 -   **Renaming & Deleting:** **Double-click** a category's name to edit it. Hover over the title to reveal a **trash icon** for deleting it.
--   **Color Customization:** Hover over a category's title and click the **paintbrush icon**. This opens a popover with a curated palette of predefined color themes, ensuring your dashboard always looks great. A "Reset" button is available to revert to the default theme.
+-   **Color Customization:** Hover over a category's title and click the **paintbrush icon**. This opens a dedicated dialog where you can style the category. You can choose from a curated list of predefined themes for a polished look, or select custom colors for both the background and text using color pickers. A "Reset to Default" button is available to clear any custom styling.
 -   **Collapsing Sections:** Click the chevron icon (▶) next to a category's title to hide or show the repositories within it. This state is saved automatically, so your layout will be preserved the next time you open the app.
 -   **Assigning Repositories:** Simply drag a repository card and drop it onto a category header to assign it.
 -   **Reordering:**
@@ -171,4 +171,7 @@ The application is designed to keep itself up-to-date automatically.
 
 -   **Checking:** On startup, the dashboard silently checks for a new version from the project's official GitHub repository.
 -   **Downloading:** If a new version is found, a small notification will appear indicating that the download has started. The download happens in the background.
--   **Installation:** Once the download is complete, a prominent blue banner will appear at the top of the application window. To install the update, simply click the **"Restart & Install"** button. The application will close and restart as the new version.
+-   **Installation:** Once the download is complete, a prominent blue banner will appear at the top of the application window. To install the update, simply click the **"Restart & Install"** button. The application will close and restart as the new version.
+
+## 9. Web Mode (Preview)
+When the application is run in a standard web browser (outside of the Electron desktop app), it will load in a "simulation mode" with default settings. This is intended for preview and demonstration purposes, as features that rely on accessing your local file system (like running tasks or cloning repositories) are not available.

README.md

@@ -5,7 +5,7 @@ This application provides a simple, powerful dashboard to manage and automate th
 ## Core Features
 
 -   **Centralized Dashboard:** View the status, branch, and build health of all your repositories in one place.
--   **Customizable Dashboard Categories:** Organize your repositories into collapsible sections with configurable colors, full drag-and-drop support, and a global expand/collapse control.
+-   **Customizable Dashboard Categories:** Organize your repositories into collapsible sections with configurable colors (via a new modal with presets and custom pickers), full drag-and-drop support, and a global expand/collapse control.
 -   **Multi-VCS Support:** Manage both Git and Subversion (SVN) repositories seamlessly.
 -   **Repository-Specific Tasks:** Create custom, multi-step automation scripts (e.g., pull/update, install, build) for each repository.
 -   **Quick Actions:** Manually refresh repository state, copy URLs/paths with a single click, and access all common actions via a right-click context menu.
@@ -44,4 +44,4 @@ This application provides a simple, powerful dashboard to manage and automate th
     -   Click a task button or use the task selection menu to run your task.
     -   The resizable log panel will automatically appear at the bottom, showing the progress of your script.
 ---
-_For developer information, including how to run this project in development mode or build it from source, please see the **Technical Manual** tab in the Info Hub._
+_For developer information, including how to run this project in development mode or build it from source, please see the **Technical Manual** tab in the Info Hub._

TECHNICAL_MANUAL.md

@@ -49,14 +49,14 @@ The application is split into three main processes, which is standard for Electr
 -   **Primary State:** The root `App.tsx` component manages the entire application state, including the list of repositories, global settings, **dashboard categories**, the active view, and the state of modals and panels. UI-specific state, such as the position and visibility of the right-click `ContextMenu`, is also managed here to ensure a single source of truth.
 -   **VCS State:** `App.tsx` also holds state for `detailedStatuses` and `branchLists` which are fetched periodically and after tasks complete to keep the UI in sync with the file system.
 -   **Parallel Task Execution:** To support running multiple tasks concurrently, a unique `executionId` is generated for each task run. This ID is passed between the renderer and main processes, allowing log output (`task-log`) and completion events (`task-step-end`) to be correctly routed to the appropriate repository and UI components without conflict.
--   **Component Architecture:** Key new components include `CategoryHeader.tsx` for managing category sections and a heavily refactored `Dashboard.tsx` that now handles complex drag-and-drop logic for both repositories and categories.
+-   **Component Architecture:** Key new components include `CategoryHeader.tsx` for managing category sections, a new `CategoryColorModal.tsx` for a comprehensive customization experience, and a heavily refactored `Dashboard.tsx` that now handles complex drag-and-drop logic.
 
 ### Data Persistence
 
 All application data, including repositories, **categories,** and global settings, is persisted to a single `settings.json` file.
 
 -   **Location:** The file is stored in the standard application user data directory for your operating system (e.g., `%APPDATA%` on Windows, `~/Library/Application Support` on macOS). This ensures that user settings are preserved across application updates.
--   **Management:** A `SettingsProvider` context handles loading this data on startup and saving it whenever it changes. The context was expanded to include functions for creating, updating, deleting, and reordering categories (`addCategory`, `updateCategory`, etc.), as well as managing their collapsed state (`toggleCategoryCollapse`, `toggleAllCategoriesCollapse`). The `Category` data structure now includes a `collapsed` property, as well as optional `color` and `backgroundColor` fields, which are also saved to `settings.json` to persist the UI state across sessions.
+-   **Management:** A `SettingsProvider` context handles loading this data on startup and saving it whenever it changes. To resolve persistent bugs with drag-and-drop reordering, the data model was updated to include an `uncategorizedOrder` array in `settings.json`. The `SettingsContext` now explicitly manages this list, and the `moveRepositoryToCategory` function was significantly refactored to robustly handle all reordering and moving scenarios.
 -   **Migration:** A one-time migration process runs on startup to move `settings.json` for users updating from versions prior to `0.2.2`, where the file was incorrectly stored next to the application executable.
 
 ## 4. Development Workflow
@@ -96,4 +96,4 @@ The application is configured to automatically check for updates on startup usin
     1.  Ensure the `version` in `package.json` is incremented.
     2.  Create a `GH_TOKEN` (GitHub Personal Access Token) with `repo` scopes and make it available as an environment variable.
     3.  Run the command `npm run publish`. This will build the application, create installers, and upload them to a new draft release on GitHub.
-    4.  Navigate to the GitHub release, add release notes, and publish it.
+    4.  Navigate to the GitHub release, add release notes, and publish it.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "git-automation-dashboard",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "A dashboard to manage and automate the workflow for a set of Git repositories.",
   "main": "dist/main.js",
   "author": "AI Assistant",
@@ -73,4 +73,4 @@
       }
     ]
   }
-}
+}