SuperNotes

SuperNotes is a native SwiftUI notes application for macOS, iPhone, and iPad built from a single shared Swift codebase. It is designed as an experimental testing and validation client for the SuperSync notes integration.

It provides a clean, offline-first notes experience with local revisions, WYSIWYG + Markdown editing, attachments, custom folders, and full SuperSync synchronization — used primarily to explore, stress-test, and validate SuperSync’s notes, folders, attachments, encryption, and sync behavior.

Built to Test SuperSync Notes Capabilities

SuperNotes serves as a reference implementation and active testing tool for SuperSync’s notes integration:

• Offline-First Architecture — Full local persistence, revisions, and editing without network
• SuperSync Sync Layer — Encrypted note, folder, and attachment payloads with versioned conflict handling
• Rich Editor — Native WYSIWYG mode + raw Markdown with seamless round-tripping
• Attachments — Image and file support with inline placement, optimization, and conflict review
• Custom Folders — Nested folder hierarchy with sync and conflict resolution
• Revisions & Conflicts — Local revision history, diff previews, and safe merge flows

Every major SuperSync notes feature is exercised through real usage and automated validation.

Core Testing Features

• Local note CRUD, search, pinning, Recently Deleted, and permanent delete
• Structured WYSIWYG editing with native blocks (headings, lists, checklists, tables, quotes, code, images)
• Markdown-compatible storage with rich inline formatting and attachment markers
• Encrypted SuperSync payloads using AES-GCM with Keychain-backed content keys
• Folder sync with hierarchy, rename/move conflicts, and tombstone handling
• Attachment upload/download/archive with resumable large-file support and conflict preview
• Revision history with full preview, line-level diffs, and restore
• Conflict-safe sync with optimistic updates and manual merge paths
• Live SuperSync validation executable for regression testing

Native Apple Experience

• Clean NavigationSplitView layout with sidebar, note list, and editor
• System folders (Notes, Recently Deleted, Conflicts)
• Native keyboard shortcuts, search, and focus behavior
• macOS, iPhone, and iPad support from one codebase
• Settings for SuperSync server, bucket, and credential management

Current Status

SuperNotes is a highly experimental and internal project. It exists primarily as a testing and validation client for SuperSync’s notes, folders, attachments, and sync capabilities. It is not positioned as a general end-user notes app and has no public releases.

It is actively used to:

• Validate new SuperSync notes features
• Reproduce sync, encryption, and conflict edge cases
• Serve as a reference implementation for native clients
• Run automated live validation against real SuperSync instances

SuperNotes is for developers and platform engineers who want to:

• deeply test SuperSync notes integration,
• validate offline-first sync behavior,
• explore encryption and conflict handling,
• and build a clean native SwiftUI client on top of SuperSync.

Built specifically as a testing client to push and validate SuperSync’s notes capabilities.