Project Tab
The Project tab is where you manage metadata about your map project. None of the fields here change how the map looks or what gets exported visually. Instead, they help you organize, identify, and track your work, especially when managing multiple projects or collaborating with others.
The tab is divided into three areas: a read-only File Info section showing automatically tracked statistics, editable Project Fields for naming and describing your project, and a History section (coming in a future release).
File Info
Display-only metadata — no user-editable controls. These values are calculated and tracked automatically by the application. They give you a quick snapshot of your project's current state without needing to count anything manually.
| Feature | Control | Property | Description |
|---|---|---|---|
| Created date | Display | settings.projectCreated | Shows when the project was first created. This timestamp is set automatically the moment you start a new project and never changes afterward, even if you re-import the JSON file later. Displayed in MM/dd/yyyy format in the project info grid. Useful for tracking when a project originated, especially if you're managing multiple map files for different deals or presentations. |
| Last saved | Display | _lastSaved | Shows the date and time the project was last saved. In the signed-in app this updates on each automatic save to your account. In the standalone tool it is stamped the first time you Export JSON in a session and does not advance on later exports in that same session. Does not track PNG exports. |
| Last edited by | Display | settings.lastEditedBy | Shows the name of the person who last saved the project, taken from the Author field. It is written on each automatic save in the signed-in app; the standalone tool's Export JSON button does not update it. In multi-person workflows where a project file gets passed between team members, this field tells you who made the most recent changes. |
| Schema version | Display | CFG.projectSchema (v4) | Shows the internal data format version used by this project file (currently v4). You generally don't need to worry about this value. It exists for backward compatibility: when you load an older project file saved in v3 or earlier format, pitchmappr automatically migrates the data to the current schema. If migration happens, it's seamless and invisible. |
| Location count | Display | locations.length | Auto-counted total of all location markers across all datasets in the project. Updates in real-time as locations are added, imported, or removed. Gives you a quick overview of project size without needing to open the Manage locations table. |
| Dataset count | Display | datasets.length | Auto-counted total of all datasets in the project. Each dataset is an independent group of locations that share the same marker color, shape, and visibility settings. Every project has at least one dataset, so the minimum value is always 1. |
| View count | Display | savedViews.length | Auto-counted total of saved map views. Each view captures a specific zoom level, center position, and crop ratio so you can consistently reproduce the same export framing. |
Project Fields (rendered outside sections)
These fields let you attach identifying information to your project. All values are saved in the JSON export file. They're entirely optional, but filling them in makes it much easier to manage projects over time, especially when you have dozens of map files for different clients or deals.
| Feature | Control | Property | Description |
|---|---|---|---|
| Project | Dropdown | — | Selects which project folder this map belongs to (signed-in app only). Changing it moves the map into that folder. |
| Project Name | Display | settings.projectName | The display name for the project, shown read-only in the app header bar as the primary project identifier. It comes from the map's name in the signed-in app rather than being typed here. It's also used as the fallback filename when exporting: if no Project ID is set, exported PNGs and JSON files use the Project Name as their filename prefix. |
| Project ID | Text input | settings.projectJobNumber | An optional reference number shown in the header subtitle area, below the Project Name. This is designed for deal IDs, project codes, matter numbers, or any internal tracking identifier your team uses. Max 60 characters; auto-generated if left blank. When set, it takes priority over Project Name for export filenames, so your exported files automatically carry the reference number (e.g. "PRJ-2026-0142_20260710_1430.png"). This keeps exports organized and easy to file. |
| Author | Display (read-only) | settings.projectCreator | The person who created the project. Filled in automatically from your account name and shown greyed out — you can't type into it. This is the name written to "Last edited by" on each save. |
| Description | Textarea | settings.projectDescription | Free-text project description or notes. Metadata only — stored in JSON for documentation purposes. Supports multiple lines, so you can include context like "Map showing all target portfolio companies for the 2026 Q2 review" or any internal notes about scope, status, or special instructions. Does not appear on the map or in exports. |
History
Placeholder section — currently displays "Change history will appear here in a future update." This will eventually provide a timeline of project changes, making it easier to track what was modified and when. For now, use the "Last saved" timestamp and "Last edited by" fields to track recent activity.