A simplified, discussion-driven Mastodon app for iOS

by iOS Example

Fedigardens

Fedigardens is a small, personal client for the Mastodon social network (along with any Mastodon API-compatible networks in the fediverse). The app stems from a capstone project I completed in college about humane social media design, and it aims to further this concept while providing a native Apple-like app experience.

⚠️ This project is currently in a prototype state. Designs and features are not final and may change over the course of the project.

Primary Objectives

This project aims to experiment with the following:

  • Making social media less addictive and more conducive to discussion.
  • Creating a humane design by allowing more humane interactions, being inclusive, and being accountable in source.
  • Being frugally designed by being lightweight, network-efficient, and native with SwiftUI and other iOS/macOS technologies.

More information on the objectives of this project can be discovered in the OBJECTIVES.md file, located in the docs of the project’s source code.

Building from Source

Required Tools

  • Xcode 13 or later
  • SwiftFormat

Optional (but Recommended) Tools

  • SwiftLint

Clone the repository via git clone, then open the Shout.xcodeproj file in the root directory.

ℹ️ To prevent collisions with the normal app available in the App Store and/or TestFlight, it is recommended that you change the URL scheme from gardens:// to your own URL scheme. Change this in the URL Types section of each target, then change the corresponding line inGardens.swift to match your URL prefix:

37 .onAppear {
38    Chica.shared.setRequestPrefix(to: "<your-url-prefix-here>")
39 }

Press the Run button in the toolbar or go to Product > Run in the menu bar to run the project in the iOS Simulator.

Archiving the Project

To archive the project, change the device target to Any iOS Device (arm64). Then go to Product > Archive to create an archive of the app that can be distributed through TestFlight or the App Store.

⚠️ If you plan to archive the project and submit to the App Store, change the bundle identifier of the project on both targets to the identifier you are using for your app in App Store Connect.

Bug Reporting

If you have found a bug or would like to make a feature request, please reach out to me on my Discord at (https://chatwith.marquiskurt.net) or send me an email at software @ marquiskurt.net.

Licensing

The source code for this project is licensed under Cooperative Non-Violent License, v7+. You can read your rights in this software in LICENSE.md.

Some parts of the project are licensed under different licenses, where applicable. You may view the terms for these licenses on their respective projects:

  • Chica: Non-Violent Public License v4+
  • SafariView: Mozilla Public License v2
  • HTML2Markdown: MIT License

GitHub

View Github