Getting started
STRUXTURE lets you design reusable folder structures, include reusable template files, save them as named presets, and generate new project folders from them. You can export a preset together with its files and import it on another computer.
STRUXTURE is a Windows desktop app that uses Microsoft Edge WebView2. You don't need an account. Your presets and files are stored on your computer.
Create your first reusable project
- Choose New structure for an empty tree, or load the Web App starter for an example hierarchy.
- Select a folder and use Add folder or Add sibling. Double-click a folder to rename it, then press Enter to apply the name.
- Open File Manager and choose Import files to store reusable text documents, PSD templates, or other files.
- Select the destination folder in the tree and choose Add file. Pick a managed template, set the output filename, and choose Apply file.
- Choose Save preset and enter a preset name. This name is separate from the folder name of any project you generate.
- Choose Generate project. Enter a project name, choose a destination, review the preview, and generate. Use Open folder to see the result.
Example
A preset called Studio project might contain Brief/Instructions.txt, Design/Design.psd, and an empty Delivery folder. Generating it as Client Launch creates a new Client Launch folder containing those folders and independent copies of the two files.
→Changing the preset later doesn't change a project you've already generated. Editing a generated file doesn't change its template.
The interface
| Area | What's there |
|---|---|
| Sidebar | New structure, + Import Structure, your saved presets with their counts and active state, a three-dot menu for each preset, the Web App starter, and local status. |
| Document header | The current preset name and save state, save controls, and Generate project. |
| Workspace header | The Structure heading, the File Manager button, and the keyboard shortcuts and help button. |
| Tree toolbar | Add folder, Add sibling, Add file, undo and redo, and expand or collapse all. |
| Tree rows | Each folder or file with its indentation, expand/collapse arrow, icon, name, item count or file assignment state, and row actions. |
| Selection bar and footer | The selected path, move controls, folder/file/depth totals, workflow hints, and the app version. |
Key terms
- Structure
- The editable tree of folders and file items.
- Preset
- A saved structure.
- Managed template
- A stored copy of a file you imported through File Manager.
- File item
- A position in the tree that points to a managed template and sets its output filename.
- Project root
- The top container of the tree. It gets its real folder name when you generate a project.
Building a structure
Add and edit items
Add folder creates a child of the selected folder. Add sibling creates a folder alongside the selected item. When a file is selected, adding a child adds it alongside the file instead, because files can't contain other items.
Add file inserts a file item and opens its assignment dialog. Choose a managed file and an output name, then choose Apply file. If you cancel, an unassigned placeholder stays in the tree; assign or remove it before you generate or export.
Double-click, press F2, or press Enter to rename a folder or change a file assignment. While renaming, press Enter or select the checkmark to apply, or press Escape or select the X to cancel.
Move and organize
Drag an item onto the middle of a folder to nest it inside. Drop it at the top or bottom edge of an item to place it before or after. Dragging near the edge of the tree scrolls it.
Without dragging, you can move items up or down, move them out one level, or nest them inside the folder above (this needs a folder directly above). Move branch to lets you pick a new parent folder from a list.
A folder can't be moved into itself or into one of its own subfolders, and a file can't contain other items. Invalid moves leave the tree unchanged.
Duplicate creates a separate copy of a branch with the same file assignments. Duplicated files keep their extension, for example Design Copy.psd. Delete removes only the selected item or branch; you'll be asked to confirm before deleting a folder that has contents. The project root can't be deleted.
Visibility and history
Expand or collapse branches one at a time, or all at once from the toolbar. Collapsing only changes what you see. Undo and redo cover your last 100 tree edits, including file items and their assignments. Undo history is cleared when you restart the app.
Press Escape to cancel a drag. A drag is also cancelled, without moving anything, if the window loses focus or you release outside a valid drop target.
Names and limits
| Rule | Behavior |
|---|---|
| Sibling names | Files and folders in the same folder share one set of names, ignoring case. Two items in the same folder can't have the same name. |
| Windows names | Names can't contain illegal or control characters, can't be . or .., can't end with a space or period, and can't be a reserved device name such as CON (including CON.txt). |
| Limits | Names: up to 255 characters. Structures: up to 48 levels deep and 9,999 items below the root. Full generated Windows paths: up to 240 characters. |
Presets and recovery
Save and manage presets
| Action | Result |
|---|---|
| Save preset | Updates the loaded preset. A new, unsaved structure asks for a preset name first. |
| Save as a new preset | Creates a separate named preset and leaves the previous one unchanged. |
| Select a preset | Loads its structure. If you have unsaved changes, you're asked to Save, Discard, or Cancel first. |
| Rename preset | Changes the preset's display name. It doesn't rename projects you've generated. |
| Duplicate preset | Creates another saved preset. Its file items use the same managed templates. |
| Delete preset | Removes only the saved preset. If it was open, the tree stays on screen as an unsaved structure. Generated projects aren't affected. |
| Export Preset | Exports the saved version of the preset for sharing. Save your current edits first to include them. |
Preset names must contain text and must be unique, ignoring case. Spaces at the start and end are removed. The maximum length is 200 bytes, so the number of characters allowed depends on the language.
Unsaved changes
If you start a new structure, switch presets, or close the app with unsaved edits, STRUXTURE offers Save, Discard, and Cancel. Save includes a folder name you're still editing, as long as it's valid. Cancel keeps your current work open. If a dialog is open or an operation is running, finish it before closing.
Automatic draft recovery
Every change to the tree updates a local recovery draft. When you restart STRUXTURE, it restores that draft along with the preset it came from. Choosing Discard clears the draft. Draft recovery is a safety net, not a replacement for saved presets or a backup.
Your preset library is saved safely. If the library file can't be read, STRUXTURE keeps it and reports the problem instead of replacing it.
Where your data is stored
| Data | Location |
|---|---|
| Presets | %APPDATA%\com.projecttree.desktop\presets.json |
| Managed file list | %APPDATA%\com.projecttree.desktop\templates.json |
| Managed files | The templates folder next to the file list. |
| Recovery draft | The app's local storage. |
→To back up your whole library, copy presets.json, templates.json, and the templates folder together.
File Manager
Import reusable files
Open File Manager from the workspace header and choose Import files. You can select several files at once. Each file is stored as an exact, independent copy. Text, PSD, and other file types are all supported; STRUXTURE doesn't open or change their contents.
Moving, renaming, or editing the original file doesn't affect the stored copy. When you have a new version, import it again and update the file items that should use it.
| Feature | Behavior |
|---|---|
| File list | Shows each file's name, size, import time, and whether it's available or in use. |
| Search | Filters stored files by name. |
| Import files | Copies the selected files into storage in the background. |
| Remove | Asks for confirmation. Unavailable while the file is used by a saved preset, the current tree, or your undo/redo history. |
| After removal | The file leaves the list, but a recovery copy stays on disk. Your original files and generated projects aren't affected. |
Assign a template to a file item
- Select a folder and choose Add file. If a file is selected, the new item is added alongside it.
- Choose a template from the list. If you haven't imported it yet, open File Manager from the assignment dialog.
- Set the output filename. It defaults to the template's original name, but you can change it.
- Choose Apply file, then save the preset. To change the assignment later, double-click the item or press F2 or Enter.
You can use one template in several places and in several presets. Each file item has its own output name. Moving or duplicating an item keeps its assignment.
File states and limits
Each file row shows whether it's assigned, unassigned, or points to a missing template. Unassigned or missing files block generation, before anything is created, and block export. Fix the assignment or remove the item.
→STRUXTURE copies files exactly as stored. It doesn't preview or edit their contents, replace variables, sync changes from the original, or open files in other apps. Removing a template doesn't free disk space, because a recovery copy is kept.
Generating a project
Choose Generate project, enter a project name, and type or browse to a destination. The preview shows the full output path and the number of folders and files; the folder count includes the new project folder. Generate becomes available once the preview is valid.
STRUXTURE never merges into or overwrites an existing project. If a file, folder, or link already exists at the chosen location, use Generate with a new name to try a numbered name, or change the name or destination.
Before writing anything, STRUXTURE checks the whole structure and every required template. It then creates the folders and copies the files in the background. When it finishes, it shows the counts, the output path, and an Open folder button.
→If generation fails partway, STRUXTURE reports the path that failed and leaves what it already created in place so you can inspect it.
Keyboard and pointer
Tree shortcuts work when a tree row has focus, not while you're typing in a field or a row button is focused. App shortcuts pause while a dialog is open. While you're typing, undo and redo apply to the text field.
| Where | Shortcut | Action |
|---|---|---|
| App | Ctrl + N | New structure (asks about unsaved changes) |
| App | Ctrl + S | Save preset |
| App | Ctrl + Shift + S | Save as a new preset |
| App | Ctrl + Z | Undo a tree edit |
| App | Ctrl + Shift + Z or Ctrl + Y | Redo a tree edit |
| Tree | Up / Down | Previous or next visible item |
| Tree | Home / End | Root or last visible item |
| Tree | Right | Expand a collapsed branch or select its first child |
| Tree | Left | Collapse an expanded branch or select its parent |
| Tree | F2 or Enter | Rename a folder or edit a file assignment |
| Tree | Insert | Add a child folder (alongside, when a file is selected) |
| Tree | Shift + Insert | Add a sibling folder |
| Tree | Alt + Up / Alt + Down | Move the item earlier or later among its siblings |
| Tree | Alt + Right | Nest inside the folder above |
| Tree | Alt + Left | Move the item out one level |
| Tree | Shift + F10 | Open the selected item's actions |
| Tree | Delete or Backspace | Delete the selected item or branch (the root is protected) |
| Renaming | Enter / Escape | Apply or cancel the folder name |
| Dragging | Escape | Cancel the drag |
| Dialog | Escape | Close or cancel, when the dialog isn't busy |
| Controls | Tab / Shift + Tab | Move focus forward or backward |
Pointer controls
Click to select. Double-click to rename a folder or edit a file. Right-click, or use the row's action menu, for item commands. Drag a branch onto the middle of a folder to nest it, or onto an item's edge to reorder. Use the arrows to expand and collapse.
→File Manager, Add file, Generate project, Import Structure, and Export Preset don't have shortcuts. Reach them with Tab or the pointer. The help panel in the app shows a shorter list of these shortcuts.
Troubleshooting
| Problem | What to do |
|---|---|
| Generate is unavailable | Check for invalid names, duplicate names in the same folder, missing or unassigned files, output paths that are too long, and whether the project folder already exists. |
| A template can't be removed | It's used by a saved preset, the current tree, or your undo/redo history. Remove or reassign those uses, then try again. |
| An export is missing recent changes | Save the preset before exporting. Export uses the saved version. |
| Import can't find the files | Keep preset.json next to its complete assets folder. Extract ZIP files first, and don't edit the file paths inside. |
| An imported preset didn't open | Your unsaved work was kept open. Find the imported preset in the sidebar and select it when you're ready. |
| Generation stopped partway | Look at the partial output STRUXTURE reported. It won't overwrite it if you try again, so choose a new project name or destination. |