Skip to content

mfzzf/todo-list

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

English | δΈ­ζ–‡

ToDo List Icon

ToDo List

A modern, feature-rich todo app for macOS built with SwiftUI and SwiftData.

Platform Swift License


Screenshots

Main Interface Menu Bar
Main Menu Bar

Features

  • Three-Column Layout β€” Sidebar filters, task list, and detail editor in a clean NavigationSplitView.
  • Priority & Categories β€” Set priority levels (None / Low / Medium / High) and assign multiple tags to each task.
  • Due Dates β€” Inline calendar picker with smart relative date display (Today, Tomorrow, Overdue, etc.).
  • Markdown Notes β€” Write notes in Markdown and preview rendered output with full block-level support (headings, lists, code blocks, tables) powered by MarkdownUI.
  • File Attachments β€” Attach files via drag-and-drop or file picker. Open files or reveal in Finder with one click. Security-scoped bookmarks ensure persistent access across app launches.
  • Smart Filtering β€” Filter by All / Today / Upcoming / Completed. Sort by due date, priority, or creation date. Full-text search across titles, notes, and categories.
  • Menu Bar Quick Access β€” View and manage pending tasks directly from the macOS menu bar without opening the main window.
  • Multilingual β€” Full support for English, Chinese (δΈ­ζ–‡), and Japanese (ζ—₯本θͺž).
  • Keyboard Shortcuts β€” ⌘N to create a new task, and more.
  • Persistent Storage β€” SwiftData powers reliable local data persistence with automatic lightweight migration.

Requirements

  • macOS 26.2+
  • Xcode 26.2+

Getting Started

  1. Clone the repository:
    git clone https://github.com/mfzzf/todo-list.git
  2. Open ToDo List.xcodeproj in Xcode.
  3. Wait for Swift Package Manager to resolve dependencies.
  4. Build and run (⌘R).

Dependencies

Package Purpose
MarkdownUI Markdown rendering in SwiftUI

Architecture

ToDo List/
β”œβ”€β”€ ToDo_ListApp.swift        # App entry point & MenuBarExtra
β”œβ”€β”€ ContentView.swift         # Three-column NavigationSplitView
β”œβ”€β”€ SidebarView.swift         # Filter navigation (All/Today/Upcoming/Completed)
β”œβ”€β”€ ToDoListView.swift        # Task list with search & sort
β”œβ”€β”€ ToDoRowView.swift         # Individual task row
β”œβ”€β”€ DetailView.swift          # Task detail editor
β”œβ”€β”€ AddToDoSheet.swift        # New task creation sheet
β”œβ”€β”€ MenuBarView.swift         # Menu bar popover
β”œβ”€β”€ SettingsView.swift        # App preferences
β”œβ”€β”€ Item.swift                # SwiftData model
β”œβ”€β”€ Priority.swift            # Priority enum
β”œβ”€β”€ Localization.swift        # i18n (EN/ZH/JA)
β”œβ”€β”€ DateFormatting.swift      # Smart date utilities
β”œβ”€β”€ AttachmentService.swift   # File open & Finder reveal
β”œβ”€β”€ FileTypeIcon.swift        # File extension β†’ SF Symbol mapping
└── Assets.xcassets/          # Colors & icons

License

Apache License 2.0. See LICENSE for details.


About

A modern, feature-rich todo app for macOS built with SwiftUI and SwiftData.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages