Skip to main content

Design Principles

Foldr prioritizes safety and predictability over speed.

These principles guide every feature.

Preview Before Action​

Users should be able to see planned changes before files move.

foldr ~/Downloads --preview

No files are modified during preview.

Never Overwrite Files​

Foldr never replaces an existing file.

photo.jpg
photo_(1).jpg
photo_(2).jpg

A unique filename is generated instead.

Undo Whenever Possible​

Every organize operation creates history.

Users should be able to restore files without relying on backups.

Prefer Standard Library​

Core functionality should avoid unnecessary dependencies.

External dependencies increase maintenance burden and platform-specific issues.

Cross-Platform First​

Features should work on:

  • Linux
  • macOS
  • Windows

Platform-specific behavior must be isolated.

Safe Failure​

A failure should affect a single operation, not the entire application.

Users should receive useful information for debugging.