Bootspring
HomeGet Started

Cloud Sync

Sync your preseed documents with the Bootspring dashboard.

Keep your preseed documents synchronized between your local development environment and the Bootspring dashboard.

Overview#

Cloud sync allows you to:

  • Push local documents to the dashboard for backup and team access
  • Pull dashboard documents to your local machine
  • Keep multiple machines in sync
  • Collaborate with team members

Requirements#

  • Bootspring account (free or paid)
  • Authentication: bootspring auth login
  • Project linked to dashboard

Commands#

preseed pull#

Download documents from the dashboard to your local machine.

1# Pull all preseed documents 2bootspring preseed pull 3 4# Pull specific document 5bootspring preseed pull --doc=VISION 6 7# Pull from specific project 8bootspring preseed pull --project=abc123 9 10# Force overwrite without prompting 11bootspring preseed pull --force

Options:

FlagDescription
--project=<id>Project ID (uses current if not specified)
--doc=<name>Pull single document (VISION, PRD, etc.)
--forceOverwrite without prompting

preseed push#

Upload local documents to the dashboard.

1# Push all preseed documents 2bootspring preseed push 3 4# Push specific document 5bootspring preseed push --doc=PRD 6 7# Push to specific project 8bootspring preseed push --project=abc123

Options:

FlagDescription
--project=<id>Project ID
--doc=<name>Push single document

Synced Content#

The following are synced:

ContentLocationSynced
Generated documents.bootspring/preseed/*.mdYes
Configuration.bootspring/preseed/PRESEED_CONFIG.jsonYes
Context files.bootspring/preseed/context/No
Prompts.bootspring/preseed/prompts/No

Context files and prompts remain local to protect potentially sensitive source materials.

Workflow Examples#

Starting on a New Machine#

1# Clone your project 2git clone https://github.com/you/project 3 4# Login to Bootspring 5bootspring auth login 6 7# Pull preseed documents 8bootspring preseed pull 9 10# Continue working 11bootspring preseed workflow resume

Team Collaboration#

Developer A:

# Make changes to PRD bootspring preseed doc prd edit # Push to dashboard bootspring preseed push --doc=PRD

Developer B:

# Pull latest changes bootspring preseed pull --doc=PRD # Review cat .bootspring/preseed/PRD.md

Backup Before Major Changes#

1# Push current state 2bootspring preseed push 3 4# Make experimental changes 5bootspring preseed init --force 6 7# If unhappy, restore 8bootspring preseed pull --force

Dashboard Integration#

Viewing Documents Online#

  1. Go to bootspring.com/dashboard
  2. Select your project
  3. Navigate to "Preseed Documents"
  4. View, edit, or comment on documents

Online Editing#

Documents can be edited in the dashboard:

  1. Open document in dashboard
  2. Make changes using the rich editor
  3. Save changes
  4. Locally: bootspring preseed pull --doc=VISION

Version History#

The dashboard maintains version history:

  • View previous versions
  • Compare changes
  • Restore older versions
  • See who made changes

Conflict Resolution#

Automatic Resolution#

When pulling, if local changes exist:

Local VISION.md has uncommitted changes. Options: 1. Overwrite local (lose local changes) 2. Skip this file 3. View diff 4. Cancel Choice:

Manual Resolution#

For complex conflicts:

  1. Pull with different filename:

    bootspring preseed pull --doc=VISION --output=VISION.cloud.md

  2. Compare files:

    diff .bootspring/preseed/VISION.md .bootspring/preseed/VISION.cloud.md

  3. Merge manually

  4. Push resolved version:

    bootspring preseed push --doc=VISION

Offline Mode#

Bootspring works fully offline:

  • Documents are stored locally
  • All commands work without internet
  • Sync when you reconnect
1# Work offline 2bootspring preseed init 3bootspring preseed workflow start 4bootspring preseed doc vision approve 5 6# When back online 7bootspring preseed push

Security#

Data Protection#

  • All transfers use HTTPS
  • Documents encrypted at rest
  • Access controlled by authentication

Privacy#

  • Context files (drop zone) never synced
  • Only generated documents uploaded
  • You control what gets pushed

Team Access#

Control who can access your documents:

  1. Dashboard > Project Settings > Team
  2. Add team members
  3. Set permissions (view/edit)

Troubleshooting#

"Authentication required"#

bootspring auth login

"Project not found"#

Link your local project to dashboard:

bootspring project link

"Sync failed"#

Check your connection and try again:

# Check status bootspring auth status # Retry bootspring preseed push

Quota Exceeded#

Free tier has sync limits. Upgrade for unlimited sync:

bootspring subscription upgrade

Related#