Configuration and Session Storage¶

WireFrame stores user configuration and session data in a JSON file via the configuration system. This page documents file locations, session behavior, and how to reset configuration.

Config File Location¶

OS	Path
Linux	`~/.config/wireframe/user_config.json`
Windows	`%APPDATA%\WireFrame\user_config.json`
macOS	`~/Library/Application Support/WireFrame/user_config.json`

WireFrame ensures the directory exists and creates the file if it doesn't already exist.

Config File Structure¶

The config file is a JSON document with the following sections:

{
  "session": {
    "openProjects": [
      "/home/user/Projects/MyBoard.prjxml"
    ],
    "openDocs": [
      "/home/user/Projects/main.schxml",
      "/home/user/Projects/board.pcbxml"
    ]
  }
}

Sections¶

Section	Description
`session`	Session restoration data (open projects and documents)

Session Data¶

Session data tracks:

Field	Type	Description
`openProjects`	Array of strings	Paths to project files (`.prjxml`) open during last session
`openDocuments`	Array of strings	Paths to schematic/PCB files (`.schxml`, `.pcbxml`) open during last session

Startup behavior¶

WireFrame reads the config file.
WireFrame reopens listed projects (if files still exist on disk).
the document manager reopens listed documents.
The Project Structure and Editor tabs are re-populated.

Automatic saving¶

The config is updated automatically when:

You open or close a project or document.
The app is closed normally (session snapshot).

Resetting Configuration¶

Reset layout and session¶

Method	Steps
Delete config	Remove `user_config.json` — the app recreates it with defaults on next launch
Delete ImGui config	Remove `imgui.ini` in the working directory to reset panel layout

Reset everything¶

# Linux
rm ~/.config/wireframe/user_config.json
rm imgui.ini  # if present in the app directory

# Windows (PowerShell)
Remove-Item "$env:APPDATA\WireFrame\user_config.json"
Remove-Item imgui.ini

Data loss

Deleting the config file removes all saved session data. You will need to reopen your projects.