Getting Started

Backing Up Your Projects

Learn how to export your Farline AI projects for use with other tools or to inspect the raw data.

Where Are My Projects Stored?

All your Farline AI projects are securely stored in the cloud database. Your data is:

  • Automatically saved: Every change is saved instantly
  • Always accessible: Access from any device with your account
  • Backed up by Farline AI: Our infrastructure includes automated backups

You don't need to export for backup purposes - your projects are safe in the cloud.

Why Export?

Export is useful when you want to:

  • Use with other tools: Import project data into spreadsheets, scripts, or other planning tools
  • Inspect raw data: View the underlying project definition or JSON structure
  • Share project definitions: Send project structure to colleagues
  • Version control: Store project snapshots in Git or other version control systems

Export All Projects

The "Export All Projects" feature downloads all your projects as a single JSON file.

How to Export All Projects

  1. Click the Menu button (top-left)
  2. Select Export/Import
  3. Choose Export all projects (JSON)
  4. A JSON file downloads containing all your projects

What's Included

The export file contains:

  • All project names and project definitions
  • Project metadata (creation date, last modified)
  • Complete project structure in machine-readable JSON format

What's NOT Included

  • Chat history with the AI assistant
  • Undo/redo history within projects

Common Uses

  • Data analysis: Parse the JSON in Python, JavaScript, or other languages
  • Integration: Feed project data into other planning or reporting tools
  • Archival: Keep historical snapshots of your project portfolio

Export Individual Projects

For a single project backup:

Project Definition Export

  1. In the editor, your project definition is always visible
  2. Select all text (Ctrl+A or Cmd+A)
  3. Copy and paste into a text file
  4. Save with .yaml extension

Best for: Version control, sharing definitions

Session ZIP Export

  1. Click MenuExport/Import
  2. Select Export session
  3. Choose ZIP format
  4. Download includes project definition and session metadata

Best for: Complete project restoration

Import Projects

Import All Projects (JSON)

  1. Click MenuExport/Import
  2. Select Import projects (JSON)
  3. Choose your backup JSON file
  4. Projects are restored to your account

Note: Importing will merge with existing projects. Projects with the same name may be duplicated.

Import Project Definition

  1. Create a new project
  2. Paste your project definition into the editor
  3. The project updates automatically

Best Practices

Naming Convention

Use descriptive filenames for your exports:

farline-export-2025-01-25.json
project-name-v2.yaml

Before Major Changes

Consider exporting before:

  • Deleting projects you might want to reference later
  • Major restructuring of project definitions
  • Experimenting with significantly different scenarios

Troubleshooting

Export Not Working?

  • Check browser download permissions
  • Try a different browser
  • Clear browser cache and retry

Import Not Loading?

  • Verify the file format (JSON or YAML)
  • Check for file corruption
  • Ensure the file wasn't modified incorrectly

Missing Projects After Import?

  • Check if projects have different names
  • Look for duplicate entries
  • Try exporting again from the original source

Last updated: 2025-01-25