Templates
Templates
Save, share, and reuse gear list configurations
Overview
Templates let you save a gear list configuration as a reusable blueprint. Instead of recreating the same equipment setup for every production, save it once as a template and apply it to new projects instantly.
Requirements
Functional Requirements
| ID | Requirement | Acceptance Criteria | Priority | Source |
|---|---|---|---|---|
| REQ-TPL-001 | The system shall allow saving a project's gear list as a named template with optional description | Click "Save as Template" → name dialog; enter name + description; save → template appears in list; duplicate name → error | Must | useTemplates |
| REQ-TPL-002 | The system shall capture all categories, items, quantities, notes, attributes, and category order when saving a template | Save template → re-apply → all categories, items, quantities, notes, attributes match original; order preserved | Must | useTemplates |
| REQ-TPL-003 | The system shall allow creating a new project pre-populated from a selected template | Click "New from Template" → template picker; select → new project created with template data; project name editable | Must | useTemplates |
| REQ-TPL-004 | The system shall allow applying a template to an existing project in Replace or Merge mode | Apply "Replace" → existing items cleared, template items loaded; "Merge" → template items added to existing; confirmation dialog shown | Must | useTemplates |
| REQ-TPL-005 | The system shall allow editing, duplicating, and deleting templates | Edit → name/description editable; duplicate → copy created with "(Copy)" suffix; delete → confirmation → removed | Must | useTemplates |
| REQ-TPL-006 | The system shall display a confirmation dialog before deleting a template | Click delete → dialog shows template name; confirm → deleted; cancel → no change; template with projects → extra warning | Must | useTemplates |
| REQ-TPL-007 | The system shall sync templates to the cloud alongside projects and contacts | Create template → syncs to cloud; edit on device B → reflects on device A; offline → queued; reconnect → synced | Must | useTemplates |
Non-Functional Requirements
| ID | Requirement | Metric | Priority |
|---|---|---|---|
| NFR-TPL-001 | Template application to new project shall complete within 500ms | Apply latency | Should |
| NFR-TPL-002 | Template list shall support keyboard navigation | WCAG 2.1 AA | Must |
Data Requirements
- Required fields: Template name (string, non-empty)
- Optional fields: Description, metadata
- Persistence: IndexedDB → cloud sync
- Content: Snapshot of categories array with nested items
Constraints & Limits
[!IMPORTANT] Templates is a Pro feature. Free-tier users cannot access the Templates page, create templates from the project card menu, or save templates from the workspace. An upgrade prompt is shown when attempting these actions.
- Free tier: one template, not zero —
FREE_TEMPLATE_LIMIT= 1, enforced astemplateCount < FREE_TEMPLATE_LIMIT, so the upgrade prompt appears when you try to save a second. The constant's own comment says why: the free seat exists "so the upgrade prompt has context". Pro tier: unlimited. This page said "No access (paywall enforced)" until 2026-09-07. - Template size limited by underlying project data structure (no explicit byte cap)
Offline Behavior
- Fully available offline — create, apply, edit, delete all work without network
- Template changes sync to cloud when connectivity is restored
Dependencies
- Requires: Projects (REQ-PRJ-001) — templates are derived from projects
- Required by: Projects — new project creation from template
Creating a Template
From an Existing Project
- Open a project workspace
- Click the ⋯ (More options) menu in the project header → Save As Template
- Enter a template name, an optional description and tags
- Tick the sections to include — the groups cascade to their rows, and locked rows always travel
- Click Save Template
The template captures:
- All categories and their items
- Item quantities, notes, and attributes
- Category order and structure
From Scratch
- Open the Dashboard and click View Templates
- Click Create Template
- Add categories and items manually
- Save the template
Applying a Template
To a New Project
- From the Dashboard, click New Project
- In the project creation form, select Use Template
- Choose a template from the list
- The new project is pre-populated with the template's gear list
To an Existing Project
- Open a project workspace
- Click ⋮ (More) menu → Apply Template
- Choose a template
- Select whether to Replace or Merge with existing items
| Mode | Behavior |
|---|---|
| Replace | Removes existing items and applies the template |
| Merge | Adds template items alongside existing items |
Managing Templates
Viewing Templates
Click View Templates on the Dashboard to see all saved templates. Each card shows:
- Template name and description
- Number of categories and items
- Last modified date
Editing a Template
- Click a template card to open it
- Modify categories, items, or metadata
- Click Save
Duplicating a Template
Click the ⋮ (More) menu on a template card → Duplicate to create a copy you can modify independently.
Deleting a Template
Click the ⋮ (More) menu → Delete. A confirmation dialog prevents accidental removal.
Common Template Examples
| Template Name | Use Case |
|---|---|
| Documentary Standard | Minimal camera + audio kit for doc shoots |
| Narrative Feature | Full camera, lighting, grip, and support package |
| Commercial Shoot | High-end camera with studio lighting setup |
| Interview Setup | 2-camera interview with audio and lighting |
| ENG/News Kit | Run-and-gun setup with shoulder rig and on-camera |
Cloud Sync
Templates sync to the cloud alongside projects and contacts. Changes to templates are tracked and synchronized across devices.
Tips
- Start generic: Create broad templates (e.g., "Documentary Base Kit") and customize per project
- Version your templates: Duplicate and rename when making significant changes (e.g., "Narrative v2")
- Use merge mode: When applying to existing projects, merge mode preserves work already done
- Keep descriptions: Add notes about when and why to use each template
Related Documentation
Last Updated: 2026-09-07 Version: 0.790.2
