Skip to content

Conversation

@cabaucom376
Copy link
Contributor

@cabaucom376 cabaucom376 commented Aug 18, 2025

Overview

This PR introduces a comprehensive folder-based organization system for the query view, transforming the way users manage and organize their surrealist environment.

Watch the demo video
Screen.Recording.2025-08-19.at.9.36.12.PM_.1.mp4

✨ Key Features

📁 Comprehensive Folder Management

  • Create and organize folders hierarchically with unlimited nesting depth
  • Rich context menu operations including:
    • Open/navigate to folder
    • Duplicate entire folder (including all nested content)
    • Rename
    • Move to any location via dedicated browser modal
    • Execute all queries within folder (recursive)
    • Delete with granular options
  • Smart folder deletion - Choose to either move contents to current directory or delete everything
  • Recursive query execution - Execute all queries within a folder and its subfolders in one action

📄 Enhanced Query Management

  • Advanced context menu operations for queries including:
    • Context aware quick move options (to root, to parent folder)
    • Browse and move to any folder via dedicated modal
  • Intelligent name conflict resolution - Automatically handles naming conflicts when moving items
  • Scoped query closing - Query closing is now scoped to the folder they are within, eliminating accidental closures

🎯 Intuitive Drag and Drop

- [ ] Visual drag and drop reordering - Reorder both folders and queries within their current location with smooth animations.
- [ ] Clean visual feedback - Dragged items indicate whether they are being sorted between other items or within items, using intuitive drop targets.

Implementing a quality drag and drop system turns out to be a challenge and would make this PR much bigger than it already is. This could be implemented in a future PR.

🧭 Advanced Navigation

  • Interactive breadcrumb navigation - Click any breadcrumb to jump directly to that folder
    • Breadcrumb truncation - Smart ellipsis menu for deeply nested paths
  • Back/Home navigation buttons - Quick navigation controls
  • Navigate to active query - New keyboard shortcut (Cmd+Shift+A) to quickly locate the active query in the folder tree

🔄 Move Operations

  • Dedicated move modal - Browse folder structure to select destination
  • Contextual move options - Quick move to root or parent folder via context menu
  • Cycle prevention - Prevents moving folders into their own descendants
  • Visual feedback - Clear indication of excluded locations during moves

Related Issues

Closes #583 - Feature: Query designer folders
Closes #703 - Feature: Folders to Organize Queries and Functions

@rowan-baker
Copy link
Contributor

rowan-baker commented Aug 18, 2025

🎉 Snyk checks have passed. No issues have been found so far.

security/snyk check is complete. No issues have been found. (View Details)

license/snyk check is complete. No issues have been found. (View Details)

code/snyk check is complete. No issues have been found. (View Details)

@cabaucom376 cabaucom376 changed the title feat: Add folder-based organization with drag-and-drop and enhanced query browser feat: Add folder-based organization with drag-and-drop Aug 18, 2025
@cabaucom376 cabaucom376 changed the title feat: Add folder-based organization with drag-and-drop feat: Add folder-based organization for queries Aug 27, 2025
}
});

// x.x.x -> x.x.x: Add folder support and timestamp-based ordering
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update before release

#### QueryTab
- [x] Open file based queries in system explorer
- [x] Scoped close operations to a folder and hide unusable ones

#### TabsPane
- [x] New query
- [ ] Open query (file)
- [x] New folder
- [ ] Conditional Execute all
- [ ] Conditional scoped Delete/Close all
- [x] Conditional Navigate
  - [x] Root
  - [x] Back
@cabaucom376 cabaucom376 marked this pull request as ready for review August 28, 2025 17:18
@cabaucom376 cabaucom376 requested a review from macjuul as a code owner August 28, 2025 17:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Feature: Folders to Organize Queries and Functions Feature: Query designer folders

2 participants