Gridflow Gridflow is a simple, easy-to-use macOS task planner built around the Eisenhower matrix. It helps you sort work into four priority quadrants, keep projects organized, and stay focused with a clean workflow.

Highlights

• Four-quadrant planning board for urgent vs. important work
• Drag-and-drop task movement between quadrants
• Project sidebar with quick creation, rename, and delete actions
• Completed log with restore and delete actions
• JSON import and export for backup or migration
• English and Russian localization
• Theme and language preferences
• Local persistence in ~/Library/Application Support/Gridflow/storage.json

Requirements

• macOS 26 or newer
• Xcode 26 or newer, or a recent Swift 6.2-compatible toolchain

Run Locally

cd Gridflow
export SWIFTPM_MODULECACHE_OVERRIDE="$PWD/.build/module-cache"
export CLANG_MODULE_CACHE_PATH="$PWD/.build/clang-module-cache"
swift run --disable-sandbox --scratch-path "$PWD/.build/swiftpm" Gridflow

Build A DMG

cd Gridflow
APP_VERSION=1.0.0 APP_BUILD_NUMBER=1 ./scripts/build_dmg.sh

This creates a versioned DMG in Gridflow/dist/.

Releases

Tagging v* on GitHub triggers the release workflow. Each GitHub Release publishes:

• GitHub's autogenerated source archives
• A versioned Gridflow-<version>.dmg
• A matching .sha256 checksum file

See docs/RELEASING.md for the release checklist.

Repository Layout

• Gridflow/ Swift package and macOS app source
• .github/workflows/ CI and release automation
• docs/demo/ public demo media used in the README
• docs/assets/ public brand assets used in the README
• CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md community docs

Data And Privacy

Gridflow stores live app data outside the repository in:

~/Library/Application Support/Gridflow/storage.json

This repository ignores local exports, recovered imports, build artifacts, DMGs, and other machine-specific files so personal task data does not get committed by accident.

Contributing

Bug reports, feature ideas, and pull requests are welcome. Please read CONTRIBUTING.md before opening a PR, especially the notes about demo data and release hygiene.

Contributors

Gridflow is maintained through ongoing project contributions and product iteration.

See CONTRIBUTORS.md for contributor notes.

License

Gridflow is available under the MIT License. See LICENSE.

Stars