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.
Options:
| Flag | Description |
|---|---|
--project=<id> | Project ID (uses current if not specified) |
--doc=<name> | Pull single document (VISION, PRD, etc.) |
--force | Overwrite without prompting |
preseed push#
Upload local documents to the dashboard.
Options:
| Flag | Description |
|---|---|
--project=<id> | Project ID |
--doc=<name> | Push single document |
Synced Content#
The following are synced:
| Content | Location | Synced |
|---|---|---|
| Generated documents | .bootspring/preseed/*.md | Yes |
| Configuration | .bootspring/preseed/PRESEED_CONFIG.json | Yes |
| 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#
Team Collaboration#
Developer A:
Developer B:
Backup Before Major Changes#
Dashboard Integration#
Viewing Documents Online#
- Go to bootspring.com/dashboard
- Select your project
- Navigate to "Preseed Documents"
- View, edit, or comment on documents
Online Editing#
Documents can be edited in the dashboard:
- Open document in dashboard
- Make changes using the rich editor
- Save changes
- 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:
-
Pull with different filename:
Loading code block... -
Compare files:
Loading code block... -
Merge manually
-
Push resolved version:
Loading code block...
Offline Mode#
Bootspring works fully offline:
- Documents are stored locally
- All commands work without internet
- Sync when you reconnect
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:
- Dashboard > Project Settings > Team
- Add team members
- Set permissions (view/edit)
Troubleshooting#
"Authentication required"#
"Project not found"#
Link your local project to dashboard:
"Sync failed"#
Check your connection and try again:
Quota Exceeded#
Free tier has sync limits. Upgrade for unlimited sync:
Related#
- Authentication - Login and account management
- Dashboard - Online project management
- Workflow Approval - Document approval process