Topleaf / 顶笺

简体中文 | English

Topleaf is a menu bar notes app for macOS.

It gives you a single place to capture notes, keep clipboard snippets, preview attachments, and bring things back when you need them.

Preview

Demo slots are reserved in the repo so they can be dropped in later without rewriting the README:

• docs/assets/demo-main-panel.gif
• docs/assets/demo-clipboard-quick-access.gif
• docs/assets/demo-markdown-attachments.gif

Highlights

• Opens from the menu bar with a large panel designed for quick capture and retrieval.
• Lets each note open in place or in a separate window, and click behavior can be tuned for copy-first or open-first workflows.
• Supports colors, two-level categories, pinning, priority, retention rules, and bulk deletion.
• Captures clipboard content manually or automatically, with filters for text, images, and files.
• Previews Markdown, images, and PDFs, and keeps imported attachments inside the app container.
• Includes backup and restore, storage analysis, rotating logs, and support package export.
• GitHub Releases can be packaged as direct-download DMGs with a bundled uninstall helper.
• Ships in Simplified Chinese and English.

Requirements

• macOS 14 or later
• Xcode 26 or later for development
• xcodegen, swiftformat, and xcbeautify

Local Development

Install helper tools:

brew install xcodegen swiftformat xcbeautify

Generate the Xcode project:

xcodegen generate

Build:

xcodebuild -project Topleaf.xcodeproj -scheme Topleaf -configuration Debug -derivedDataPath /tmp/TopleafDerivedData build

Test:

xcodebuild -project Topleaf.xcodeproj -scheme Topleaf -configuration Debug -derivedDataPath /tmp/TopleafDerivedData test

Format:

swiftformat Sources Tests scripts

Docs

• Development setup: docs/dev-setup.md
• Project memory: docs/project-memory.md
• Roadmap: docs/implementation-roadmap.md
• Review log: docs/review-log.md
• Manual QA checklist: docs/manual-test-checklist.zh-Hans.md
• GitHub release guide: docs/github-release-guide.md
• GitHub open-source guide in Chinese: docs/open-source-release-guide.zh-Hans.md
• GitHub open-source guide in English: docs/open-source-release-guide.md

Support

• Issues and pull requests are welcome.
• For direct feedback: ytemail163@163.com
• When reporting a bug, include:
  • what happened
  • when it happened
  • a screenshot if relevant
  • exported logs or a support package if available

Sponsor

If Topleaf is useful to you, you can support its development here later.

The repo already reserves space for donation assets under docs/assets/.

License

MIT