Docs — Dreamilia

Getting started

Dreamilia is a local‑first backup app for macOS that snapshots your projects, keeps a versioned timeline, and optionally syncs encrypted backups to your preferred cloud provider.

Requirements: macOS 13.5+, 100MB disk space, Intel or Apple Silicon, 2GB RAM recommended.

Installation

Download the latest release and drag Dreamilia.app into your Applications folder.

# Optional: install CLI helper
curl -L https://example.com/dreamilia-cli.sh | bash

# Verify
which dreamilia

Quick start

Open Dreamilia → New Project.
Select your project folder and a backup location.
Click Backup now to create the first snapshot.
Optionally connect iCloud/Dropbox/Drive/OneDrive under Cloud sync.

# CLI equivalent
# Create a project and run a backup now
dreamilia project add ~/work/myapp --name "MyApp"
dreamilia backup run --project "MyApp" --note "first snapshot"

Core concepts

Concept	Description
Project	A folder (and subpaths) you want to protect.
Snapshot	A point‑in‑time backup recorded on the timeline.
Rollback	Selectively restore files/folders from any snapshot.
Sync	Encrypted mirror of snapshots to your cloud provider.

Automation

Automate backups with schedules, macOS Shortcuts, and Git‑aware hooks.

Schedules

Create hourly/daily rules per project. Use quiet hours to pause at night; missed runs catch up automatically.

# Run backups every hour
# (cron-like syntax depends on your scheduler; shown is CLI sugar)
dreamilia schedule add --project MyApp --every "1h" --quiet "23:00-08:00"

Shortcuts

Trigger backups from the Shortcuts app or assign keyboard shortcuts.

Git hooks

Capture metadata after commits and tags to annotate snapshots.

Cloud sync

Connect iCloud, Dropbox, Google Drive, or OneDrive. OAuth is used for sign‑in; Dreamilia keeps per‑project links.

Conflicts are handled via configurable policies (e.g., last‑writer wins). Conflict snapshots are preserved so you can merge safely.

# Link a provider to a project
dreamilia cloud link --project MyApp --provider dropbox
# View status
dreamilia cloud status --project MyApp

Security

AES‑256 encryption at rest, TLS in transit, and zero‑knowledge architecture. Keys are generated and stored locally.

Per‑project keys with optional rotation
Checksum verification (SHA‑256)
Offline‑friendly, no telemetry

CLI reference

The helper CLI lets you script backups and inspect status.

# Create project
 dreamilia project add /path/to/folder --name "Project"
# Run backup
 dreamilia backup run --project "Project" --note "nightly"
# List snapshots
 dreamilia timeline list --project "Project" --limit 10
# Restore a file
 dreamilia restore --project "Project" --path src/app.ts --at 2025-09-01

FAQ

Does Dreamilia upload my files?

No, not unless you connect a cloud provider. Even then, data is encrypted client‑side first.

Can I exclude paths?

Yes. Add ignore patterns in Project → Settings → Exclusions.

How do refunds work?

One‑time Pro purchases have a 14‑day refund window. Contact support with your order email.

Changelog (highlights)

v1.0 — Initial public release with timeline, rollback, automation, and multi‑cloud sync.

Build confidently with Dreamilia

On this page