Drag & Drop Organization

​

Overview

​

Why Drag & Drop?

1. Select snippet
2. Right-click → “Move to…”
3. Navigate folder tree in dialog
4. Click OK
5. Repeat for each snippet

1. Drag snippet to folder
2. Done

​

How It Works

​

Dragging Snippets to Folders

​

Single Snippet

1. Click and hold on a snippet in the main panel
2. Drag toward the folder sidebar on the left
3. Hover over the target folder
   • Folder highlights when ready to receive
4. Drop the snippet
   • Snippet moves to that folder

​

Multiple Snippets

1. Select snippets:
   • Cmd/Ctrl + Click to select individual snippets
   • Shift + Click to select a range
2. Drag the selection to target folder
3. Drop to move all selected snippets

• Badge shows number of snippets being dragged (e.g., “5 snippets”)
• All selected snippets move together

​

Nested Folders

📁 Engineering
  📁 Frontend
    📁 React Components  ← Drop here
    📁 CSS Utilities
  📁 Backend

• Folders automatically expand when you hover during drag
• Wait ~1 second hovering over a folder to expand it
• Navigate deep hierarchies without releasing the drag

​

Reordering Within Folder

1. Drag snippet within the snippet list
2. Blue line shows insertion point
3. Drop to reorder

​

Dragging Snippets to Tags

​

Applying Tags

1. Select one or more snippets
2. Drag to the Tags section in sidebar
3. Hover over target tag
   • Tag highlights
4. Drop
   • Tag is applied to all dragged snippets
   • Snippets remain in their current folder

​

Multiple Tags

1. Select snippets
2. Drag to first tag → Drop
3. Snippets remain selected
4. Drag to second tag → Drop
5. Both tags now applied

​

Removing Tags

• Drag tag pill from snippet → Drag outside → Drop to remove

• Click X on tag pill in snippet

​

Tag Organization

• Drag tags up/down in tag list
• Most-used tags at top for easy access
• Visual organization, doesn’t affect functionality

​

Advanced Drag & Drop

​

Drag to Create Folders

1. Drag a snippet to the folder sidebar
2. Hover over ”+ New Folder” area (if available)
3. Drop → Dialog appears
4. Name new folder → Enter
5. Snippet moves to new folder

1. Drag snippet between existing folders
2. Drop in empty space
3. “Create folder here” option appears

​

Drag Folders to Reorganize

• Drag Folder A onto Folder B
• Folder A becomes a child of Folder B

• Drag nested folder to workspace root
• Folder becomes top-level

• Drag folder up/down
• Changes position in sidebar

​

Drag Files from Desktop

1. Open Finder/Explorer
2. Select .txt, .md, .js, or any text files
3. Drag files to Snippets AI window
4. Drop onto:
   • Specific folder → Files imported there
   • Main panel → Files imported to current folder
   • Tags → Files imported and tagged

​

Drag to Trash

1. Drag snippet(s) toward bottom of window
2. Trash icon appears
3. Drop to delete
4. Snippets move to trash (recoverable for 30 days)

​

Drag Between Teams/Workspaces

• Open source team in one window
• Open destination team in another (or use split view)
• Drag snippet from source → Drop in destination
• Snippet is copied (original remains)

​

Visual Feedback & Indicators

​

During Drag

• ✋ Grab hand when dragging
• 🚫 Not allowed when hovering invalid drop targets
• ✅ Valid drop when over valid targets

• Folders highlight when ready to receive
• Tags highlight when hovering
• Blue insertion lines show reorder position

• Semi-transparent preview of what you’re dragging
• Shows snippet thumbnail or count
• Follows cursor

​

After Drop

• Brief highlight animation on target
• Snippet appears in new location
• Selection clears (by default)

• Toast notification: “Moved snippet to Folder”
• Click “Undo” to revert
• Available for ~5 seconds

​

Keyboard Modifiers

​

Copy Instead of Move

• Snippet is copied to destination instead of moved
• Original remains in source folder
• Cursor shows ”+” icon

​

Force Move

• Ensures snippet is moved (not copied)
• Useful when default behavior is copy

​

Multi-Select During Drag

• Add more snippets to current drag operation mid-drag
• Advanced technique for power users

​

Best Practices

​

Common Workflows

​

Bulk Organization

1. Select all unorganized snippets
2. For each category:
   • Select relevant snippets
   • Drag to appropriate folder
   • Repeat
3. Apply tags as needed:
   • Select by topic
   • Drag to tags

​

Project Cleanup

1. Create “Project Archive” folder
2. Select all project snippets
3. Drag to archive folder
4. Remove project-specific tags

​

Tag Application Sprint

1. Sort snippets by type or topic
2. Select first batch
3. Drag to appropriate tag
4. Select next batch
5. Drag to next tag
6. Repeat until all tagged

​

Folder Restructuring

1. Drag subfolder out of parent (unnest)
2. Create new parent folder
3. Drag related folders into new parent
4. Reorder folders by dragging up/down
5. Review and adjust

​

Troubleshooting

​

Drag Not Working

1. Selection Issue: Ensure snippet is actually selected (click once)
2. Permissions: Check if you have edit permissions for the folder
3. App State: Try refreshing the app or restarting
4. Conflicting Modifiers: Release all keyboard keys and try again

​

Drop in Wrong Location

1. Immediately Undo: Cmd/Ctrl + Z or click Undo toast
2. Try Again: Use more precise hovering before dropping
3. Zoom In: If sidebar is cramped, expand it for easier targeting

​

Can’t Drag to Certain Folders

1. Permission Restricted: You may not have edit access to that folder
2. Read-Only Team: Team may be configured as read-only
3. Archived Folder: Can’t add snippets to archived folders

​

Accidental Deletions

1. Open Trash folder
2. Select deleted snippet(s)
3. Click “Restore”
4. Snippets return to original location

​

Performance Tips

​

Large Selections

• May have slight delay before operation completes
• Progress indicator appears for large operations
• Don’t interrupt-wait for completion

​

Over Slow Network

• Drag operations may take longer to sync
• Continue working-changes queue and sync when ready
• Check sync status icon

​

What’s Next