IceCubesApp  by Dimillian

SwiftUI Mastodon client for accessing the decentralized social network

created 2 years ago
6,453 stars

Top 8.1% on sourcepulse

GitHubView on GitHub
Project Summary

IceCubesApp is a feature-rich, open-source Mastodon client built entirely with SwiftUI for iOS, macOS, iPadOS, and visionOS. It offers a comprehensive user experience for interacting with the decentralized social network, catering to both casual users and power users seeking deep customization and advanced features.

How It Works

The application leverages SwiftUI for a native, performant UI across Apple platforms, including dedicated sidebar layouts for macOS and iPadOS. It heavily utilizes Mastodon's streaming API for real-time updates and features like live post editing/deletion. Timeline positions are synced via the Mastodon marker API and cached locally using the Bodega SQLite wrapper for seamless resumption across devices. Unique features include custom tag groups and remote instance timeline browsing.

Quick Start & Requirements

  • Install: Clone the repository and create a copy of IceCubesApp.xcconfig.template to IceCubesApp.xcconfig, filling in DEVELOPMENT_TEAM and BUNDLE_ID_PREFIX.
  • Prerequisites: Xcode, Apple Developer account for DEVELOPMENT_TEAM.
  • Resources: Building requires Xcode.
  • Docs: https://github.com/Dimillian/IceCubesApp

Highlighted Details

  • Multi-platform support (iOS, macOS, iPadOS, visionOS) with platform-specific UI adaptations.
  • Real-time timeline updates via Mastodon streaming API.
  • Advanced posting features including threads, media uploads, AI-assisted text tools (OpenAI API), polls, and custom emojis.
  • Comprehensive notification handling with a dedicated proxy for APNS integration.
  • Extensive customization options for themes, gestures, and UI elements.
  • Support for unlimited Mastodon accounts with secure keychain storage.

Maintenance & Community

The project is actively maintained by Dimillian. Further community engagement details are not explicitly provided in the README.

Licensing & Compatibility

The project is licensed under the MIT License, permitting commercial use and integration with closed-source applications.

Limitations & Caveats

Building the project requires manual configuration of .xcconfig files with Apple developer credentials. AI features rely on an external OpenAI API key, which may incur costs.

Health Check
Last commit

1 week ago

Responsiveness

1 day

Pull Requests (30d)
2
Issues (30d)
2
Star History
358 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.