Project Management
Project Types
GEEC has two distinct project types that use the same .geec file format:
| Type | Purpose |
|---|---|
| Circuit | A complete electrical circuit - the main use case |
| Component | A reusable custom component symbol (admin only at the moment) |
The top bar always shows the current project type. Circuits and components are handled with the same save/load workflow, but their settings dialogs differ slightly.
The .geec File Format
All projects are stored as .geec files:
- Encoding: JSON serialised with LZMA compression
- Contents: circuit topology, component values, analysis configurations, and stored analysis results
- Compatibility: supported across GEEC versions (the loader handles formats v3-v5 transparently)
- Not human-editable: because LZMA-compressed, cannot be opened in a text editor
Creating a New Project
In the General tab of the top bar, Project section:
- New circuit - clears the canvas and starts a blank circuit
- New component - starts a blank component editor (admin users only)
Warning
Creating a new project clears the current canvas. Save your work first if you want to keep it.
Saving Projects
Save to File
The primary save method downloads a .geec file to your computer.
General tab ? File section:
| Button | Action |
|---|---|
| Save | Serialises the current project and downloads it as <project-name>.geec |
| Save as | Opens a dialog to enter a new name, then downloads the file with that name (also clears the server ID so the renamed copy is treated as a new project) |
The filename is derived from the project title (folder prefix stripped, spaces kept).
Save to Server
Saves the project to the server database so it can be loaded from any device.
General tab ? Server section ? Save to server
Tips
Save to server is only available to admin users. Regular users must use Save to download a file.
When saving to the server for the first time the project gets assigned a numeric ID. Subsequent saves update the same record. The browser URL updates to reflect the project ID (e.g. https://geec.../42), so you can bookmark or share the direct link.
In-session History
GEEC keeps an undo/redo history for the current session (shown in the General tab as History N/M):
| Button | Shortcut | Action |
|---|---|---|
| Back | Ctrl+Z / Cmd+Z | Undo the last canvas change |
| Front | Ctrl+Y / Cmd+Shift+Z | Redo the undone change |
History is in-memory only - it is lost when the page is reloaded. Save to file frequently to avoid losing work.
Loading Projects
Load from File
General tab / File section / Load
Opens a file picker. Select a .geec or legacy .json file from your computer. The project replaces the current canvas immediately.
Load from Server
General tab / Server section / Load from server
Opens the Load project from server dialog which shows all publicly available circuits organised into folders:
- Click a folder to see the circuits inside it
- Click a circuit card to load it
- Admin users additionally see their own private circuits at the top
Folders in the server browser are derived from the project title using the folder/name naming convention (see Naming Conventions below).
Open by URL
If a project has been saved to the server, its direct URL (e.g. https://geec.../42) loads it automatically when visited. This is the easiest way to share a public circuit.
Project Settings
Click the gear icon in the top-right of the right panel to open the Circuit settings dialog.
Circuit Settings
| Field | Description |
|---|---|
| Circuit name | Display name shown in the right panel and used as the filename when saving |
| Folder | Optional folder prefix for organising circuits in the server browser (see Naming Conventions) |
| Circuit description | Free-text description saved with the project |
Naming Conventions and Folders
GEEC uses a single folder/name string as the project title to encode both the folder and the circuit name:
| Title string | Folder | Display name |
|---|---|---|
RC Filter | (none) | RC Filter |
Filters/RC LowPass | Filters | RC LowPass |
Lab 1/Voltage Divider | Lab 1 | Voltage Divider |
Setting a Folder in the settings dialog prepends folder/ to the title automatically. Circuits with the same folder string are grouped together in the server browser.
Tips
Folders exist only in the title string - there is no separate folder object to create. Simply set the Folder field before saving to the server.
Loading Custom Components from File
Admin users can import .geec component files into the left-panel component library for use in the current session:
General tab / File section / Load components
- Accepts multiple files at once
- Loaded components appear under User Components in the left menu
- Available for the current session only (not permanently saved to the server)
Next: Go to Keyboard Shortcuts for a complete hotkey reference.