A supporter is worth a thousand followers.

Buy Me a Coffee is a modern creator platform. It takes two minutes to start your page and has all the features that you need to build your creative business.

Donations 💰
Give your audience a friendly way to thank you.

Memberships 🗓
Earn recurring revenue by offering a monthly or yearly membership.

Sell Extras ✨
A new, creative way to offer Zoom calls, art commissions, anything.

Features

• [X] Apple Pay
• [X] iCloud Keychain

Requirements

App Store Review

These are the two App Store Review Guidelines articles you have to know before using this framework:

3.1.1 In-App Purchase

• Apps may use in-app purchase currencies to enable customers to “tip” digital content providers in the app.

3.2.1 Acceptable:

(vii) Apps may enable individual users to give a monetary gift to another individual without using in-app purchase, provided that (a) the gift is a completely optional choice by the giver, and (b) 100% of the funds go to the receiver of the gift. However, a gift that is connected to or associated at any point in time with receiving digital content or services must use in-app purchase.

Implement Buy Me a Coffee

1. Import the BuyMeACoffee framework in your UIApplicationDelegate:

import BuyMeACoffee

2. Configure the BMCManager shared instance with the username you've chosen on www.buymeacoffee.com, typically in your app's application:didFinishLaunchingWithOptions: method:

BMCManager.shared.configure(username: "appcraftstudio")

3. In the view controller, override the viewDidLoad method to set the presenting view controller of the BMCManager object.

BMCManager.shared.presentingViewController = self
// You can also set a custom thank you message
BMCManager.shared.thankYouMessage = "Thank you for supporting 🎉 App Craft Studio !"

4. Add a BMCButton to your storyboard, XIB file, or instantiate it programmatically. To add the button to your storyboard or XIB file, add a View and set its custom class to BMCButton.
5. Optional: If you want to customize the button, do the following:

let button = BMCButton(configuration: .default)
button.configuraton = .init(color: .orange, font: .cookie)

(Optional) Configure In-App Purchase

Depending the legal receiver of the gift configured on Buy Me a Coffee, App Store reviewers can ask for In-App Purchase implementation.
If the following In-App Purchase if configured for your application, it will be displayed as primary flow when user tap on the BMCButton.

If the framework can't retrieve In-App Purchase informations, the web flow will be used as fallback.

App Store Connect

Go to App Store Connect, search for the In-App Purchases section of your app, and then, create a new one with the following informations:

Capabilities

1. Select the current workspace in the project navigator.
2. Then, select the app target in the left panel.
3. Go to the Signing & Capabilities tab.
4. Add the In-App Purchase capability.

Installation

CocoaPods

You want to add pod 'BuyMeACoffee', '~> 1.0' similar to the following to your Podfile:

target 'MyApp' do
  pod 'BuyMeACoffee', '~> 1.0'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Swift Package Manager

1. Using Xcode 11 or above go to File > Swift Packages > Add Package Dependency
2. Paste the project URL: https://github.com/appcraftstudio/buymeacoffee.git
3. Click on next and select the project target

Copyright © 2020 App Craft Studio. All rights reserved.