Holarch

Getting Started

Project Folders

Group projects in folders inside folders on the Projects page, in your own folders or in an organization's shared folder tree, and move them by drag, menu or keyboard.

How to use it →

On this page
  1. Overview
  2. Concepts
    1. Which tree a project is in
    2. Who can do what
  3. How to use it
    1. When and why
    2. Create a folder
    3. Move projects into a folder
    4. Arrange folders
    5. Find a project in any folder
    6. Worked example: a CubeSat program
    7. Tips and good practice
    8. Common mistakes
    9. How it connects
  4. The Projects page
    1. Folder tree
    2. Above the list
    3. In the list
    4. Project Preferences
  5. Keyboard and screen readers
  6. Limits
  7. Messages
  8. Related

Overview

Folders keep a program's projects together: the system project, its subsystem projects, test projects and supplier models. Folders go inside folders, up to eight levels deep. The Projects page (Manage Projects) shows them as a tree beside the project list.

There are two kinds of folder tree:

  • My Folders: your own folders. Only you see them. They hold your projects that are not in an organization you belong to, and projects that other people shared with you.
  • An organization's folders: one tree per organization you belong to, the same for every member. Administrators arrange it; administrators and a project's owners file projects in it.

Folders are on every plan. Organization folder trees exist wherever organizations do.

Concepts

Which tree a project is in

Each project is in exactly one tree for you, and in at most one folder of that tree.

The projectIts tree for you
Belongs to an organization you are a member ofThat organization's tree
Any other project you can openMy Folders

A project at the top of a tree, in no folder, is listed when you select the tree itself.

Who can do what

ActionMy FoldersAn organization's folders
See the foldersYouEvery member
Create, rename, move and delete foldersYouOrganization administrators
Move a project into or out of a folderYou, for any project you can openOrganization administrators and the project's owners
Recorded in the organization's audit logNoYes: every folder created, renamed, moved or deleted, and every project moved between folders

Someone outside the organization who has one of its projects shared with them never sees the organization's folder names. To them the project sits in their own My Folders, at the top until they file it.

A project moves to another tree only when its organization changes (Share…). It then starts at the top of its new tree.

How to use it

When and why

Make folders when you link projects to each other: a program becomes one folder, with a subfolder per subsystem or supplier. The folder is then also the scope of the Program Map, which shows how the projects in it link to each other.

Create a folder

  1. Open Manage Projects.
  2. Select the tree or folder the new folder goes in.
  3. Click New Folder above the list.
  4. Type a name and press Enter.

You see the new folder in the tree, with 0 beside it. A folder's ⋯ menu also has New Subfolder…, and ⌘K / Ctrl+K → New Project Folder… makes one at the top of My Folders.

Move projects into a folder

  1. Select the folder that holds the projects, or All Projects.
  2. Drag a project row onto a folder in the tree, or onto a folder row in the list.

You see "Moved Mars Rover to Avionics." with Undo.

To move several projects at once:

  1. Tick the box at the start of each row. Shift+click ticks every row between the last one and this one; the box in the header ticks the whole list.
  2. Drag one of the ticked rows onto a folder, or click Move to Folder… in the bar above the list.
  3. In Move to Folder, choose the folder and click Move.

Without dragging, use Move to Folder… in a project's ⋯ menu, or ⌘K / Ctrl+K → Move Project to Folder… while the project is open. New Folder… in that dialog makes a folder inside the chosen one.

Arrange folders

  • Rename: select the folder in the tree and press F2, or ⋯ → Rename….
  • Move: drag the folder onto another folder of the same tree, or ⋯ → Move Folder…. A folder never moves into itself or one of its subfolders.
  • Delete: ⋯ → Delete Folder…, or Delete in the tree. Its projects and subfolders move up into its parent folder; no project is deleted. A moved-up subfolder whose name is already used there gets a number, such as Power (2).

Every change shows a message with Undo.

Find a project in any folder

Type in Find a project. The search looks in every folder, whatever is selected, and matches names, descriptions, project ids and folder paths. The Folder column shows where each match is.

Worked example: a CubeSat program

  1. Create the CubeSat EO-1 demo (Project Files ▾ → New Demo Project).
  2. Click My Folders, then New Folder, and name it EO-1 Program.
  3. With EO-1 Program selected, click New Folder twice: Spacecraft and Ground Segment.
  4. Select All Projects and drag CubeSat EO-1 onto Spacecraft.
  5. Open EO-1 Program ⋯ → Open in Program Map. The map shows every project in the program folder and its subfolders.

Tips and good practice

  • Name folders after programs, systems and suppliers, not after people: folder trees outlive teams.
  • Keep an organization's shared folders for its programs. File personal experiments in My Folders.
  • Use Open in Program Map on a program folder before a review to see which links are missing.

Common mistakes

  • "Avionics is a folder of Acme. Move … into Acme with Share… first." You dropped a project of another tree onto an organization folder. Change the project's organization in Share…, or file it in My Folders.
  • "Only the project's owners and … administrators can file …" In an organization's tree, members who are not owners cannot move projects. Ask an owner or an administrator.
  • A folder looks empty after a search. The list is showing search matches from every folder. Clear Find a project.

How it connects

  • Program Map: a folder is a scope (Scope menu, or a folder's ⋯ → Open in Program Map).
  • Links to Other Projects: folders group the projects that link to each other.
  • API and MCP: list_projects and GET /api/v1/projects give each project's folder path.
  • Import and Export: a project export records its folder path; an import makes it again in My Folders.

The Projects page

Folder tree

ElementWhat it does
All ProjectsEvery project you can open, in one list
An organization's nameThat organization's shared tree: its projects at the top level and its folders
My FoldersYour own tree
A folderLists its subfolders and the projects directly in it
Number beside a nodeProjects in it and in its subfolders
▸ / ▾Shows or hides the subfolders (remembered in this browser)

Right-click a folder, or press Shift+F10, for its menu: New Subfolder…, Rename…, Move Folder…, Open in Program Map, Delete Folder…. In an organization's tree, members who are not administrators see only Open in Program Map.

Above the list

  • Breadcrumbs: the selected folder's path, such as My Folders › EO-1 Program › Spacecraft. Click a part to go up.
  • Selection bar: shown while rows are ticked: n projects selected, Move to Folder…, Clear Selection.

In the list

  • Folder rows come first: the folder's name and project count, and ⋯ for its menu. Click the name to open the folder.
  • Project rows start with a tick box. Drag a row by any part that is not its link, button or box.
  • An empty folder says "This folder is empty." with New Subfolder and, in My Folders, + New Project. A new project goes into the selected folder of My Folders; choose another in Folder in the New Project dialog.

Project Preferences

Folder in Project Preferences… lists the folders of the project's tree. It is greyed out where you cannot file the project.

Keyboard and screen readers

The folder tree is one tab stop.

KeyAction
↑ / ↓Previous or next folder
→Show a folder's subfolders, or go to the first one
←Hide the subfolders, or go to the parent folder
Home / EndFirst or last folder
Enter or SpaceShow the folder in the list
F2Rename the folder
DeleteDelete the folder (asks first)
Shift+F10The folder's menu
A letterThe next folder whose name starts with it

Screen readers hear each folder's name and project count, whether it is expanded, and every move, rename, delete and undo as it happens.

Limits

LimitValue
Folder name1 to 80 characters
Folder depth8 levels
Folders per tree1,000
Same nameNot twice in one folder (capital letters do not count)

Messages

MessageMeaning
A folder named "…" is already there. Choose another name.The folder you are naming or moving into already has a folder with that name
Folders nest at most 8 levels deep. Choose a folder higher up.The new or moved folder would be deeper than 8 levels
A folder cannot move into itself or one of its subfolders.Choose a folder outside the one you are moving
Only an administrator of this organization can change its folders.Ask an organization administrator
The selected projects are in different folder trees (…). Select projects from one tree.Move projects of each tree separately