Folder Management

Overview

Folders let you organize test cases and test cycles into logical hierarchies within the Jira plugin. The folder structure is shared with TestKase -- folders created or modified in the plugin appear in TestKase and vice versa.

Where Folders Appear

Folder trees are used in several plugin modals:

• LinkTestcasesModal -- Left panel shows the test case folder tree
• CreateTestcaseModal -- Folder selection button opens the FolderSelectionModal
• GenerateTestcaseModal -- Folder picker for choosing the AI generation destination
• AddToCycleModal -- Left panel shows the test cycle folder tree
• CreateCycleModal -- Folder selection button opens the FolderSelectionModal

Folder Types

The plugin manages two separate folder hierarchies:

• TESTCASE folders -- Organize test cases. Appear when browsing or creating test cases.
• TESTCYCLE folders -- Organize test cycles. Appear when browsing or creating test cycles.

These are independent hierarchies -- test case folders do not contain test cycles, and vice versa.

Folder Hierarchy

Folders support up to 3 levels of nesting. If you attempt to create a subfolder at a deeper level, a tooltip displays: "Nested folders cannot exceed 3 levels."

Example hierarchy:

Root
├── Authentication
│   ├── Login Tests
│   │   └── SSO Tests (max depth)
│   └── Registration Tests
├── Payment
│   └── Checkout Tests
└── API Tests

Folder Tree UI

The folder tree displays in the left panel of modals with these interactions:

• Expand/collapse -- Click the ChevronRight/ChevronDown icon to toggle child folders
• Folder icon + name -- Each row shows a folder icon followed by the folder name
• Select -- Click a folder row to select it and load its contents in the adjacent panel

Folder Actions

Three-Dot Menu Per Folder

Each folder has a three-dot menu (⋮) with two actions:

1. Rename (Edit3 icon) -- Triggers inline editing:

   • The folder name becomes an editable text input, auto-focused
   • Press Enter to save the new name
   • Press Escape to cancel
   • A spinner displays while saving
   • Validation error if the name is empty

2. Delete (Trash2 icon) -- Deletes the folder with confirmation.

Root-Level Actions

Hover over the workspace root to reveal action icons:

1. Create Folder (FolderPlus icon) -- An inline input appears. Type the folder name, then:

   • Press Enter or click the check icon to create
   • Press Escape or click the X icon to cancel

2. Create Test Case / Test Cycle (FilePlus2 icon) -- Quick-create at the root level

FolderSelectionModal

Some actions (e.g., Create Testcase, Generate Testcase, Create Cycle) open a standalone FolderSelectionModal for choosing a destination folder.

Modal contents:

• Breadcrumb navigation -- Clickable path segments showing the current location in the folder hierarchy
• Folder tree -- Expandable/collapsible tree with all folders
• Per-folder actions -- Three-dot menu (⋮) with Rename and Delete options

Bottom actions:

• Cancel -- Close without selecting
• Select -- Confirms the chosen folder and closes the modal