A SwiftUI Mastodon client
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Gareth Simpson 0a0e985e33
match intended mastodon presentation (#557)
2 hours ago
.github Update issue templates 2 weeks ago
IceCubesActionExtension Update polish translation (#545) 4 hours ago
IceCubesApp Update polish translation (#545) 4 hours ago
IceCubesApp.xcodeproj Bump to 1.3 13 hours ago
IceCubesNotifications Change notification sound back to caf 5 days ago
IceCubesShareExtension Swift format 1 day ago
Images New promo image 2 weeks ago
Packages match intended mastodon presentation (#557) 2 hours ago
ci_scripts Translate Toot using DeepL close #153 1 week ago
.gitignore xcconfig Support (#342) 7 days ago
.swiftformat Swiftformat 2 weeks ago
IceCubesApp-release.xcconfig xcconfig Support (#342) 7 days ago
IceCubesApp.xcconfig.template xcconfig Support (#342) 7 days ago
LICENSE Initial commit 2 months ago
PRIVACY.MD Add privacy.md 1 month ago
README.md Update README.md 3 days ago

README.md

IceCubesApp

You can now download it on the App Store

IceCubesApp is an open source application for accessing the decentralized social network Mastodon! It's built entirely in SwiftUI, making it fast, lightweight, and easy to use.

You can connect to any Mastodon instance and browse your timeline, interact with other users, and post updates and media.

The project is split into different Swift Packages to make it easier to manage and maintain the codebase. Each package is focused on a specific aspect of the application, such as the UI, network communication, or data models. This modular approach allows for easier collaboration and ensures that the code is organized and easy to understand.

It's a great starting point for learning SwiftUI. The app covers many of the basic concepts of SwiftUI, such as building layouts, working with data, and handling user interaction. By exploring the code, you can gain a solid understanding of how to use SwiftUI in your daily life. Plus, the open source nature of IceCubesApp means that you can see how real-world applications are built and get a sense of best practices for using SwiftUI.

The architecture is straightforward MVVM for most parts, no redux on this one ;)

Please note that IceCubesApp is currently in an early stage of development and as such, there are many features that are still missing. While the app is functional and can be used to browse and interact with Mastodon, there are still many features that are planned for the future.

Thanks!

Icon

Building the project

To build the project, you need to clone the repo and create a copy of the included .xcconfig file to create your config before you can compile the project. Otherwise, you will get an error.

Here are the steps:

  1. Clone the repo
  2. In the same folder that contains the IceCubesApp.xcconfig.template, run this command:
  • cp IceCubesApp.xcconfig.template IceCubesApp.xcconfig
  1. Fill in the DEVELOPMENT_TEAM and BUNDLE_ID_PREFIX values. The first should have your Apple Team ID (which you can find by logging into the Apple Developer Portal). The latter is your domain in reverse notation or whatever you use as the prefix for your projects.
  2. Save your changes, and then you should be able to compile the project without any issues.