Skip to main content
By the end of this page your app will have a Support row that opens Feddy, and a message sent from it will be sitting in your inbox. It takes about five minutes.

Before you start

  • A Feddy project and its project ID. You’ll find the ID under Settings → Install in the dashboard. No project yet? Create one first.
  • An app that compiles against API 35 or later. The SDK runs on Android 6.0 (API 23) and up, and its only dependencies are Google’s own AndroidX libraries and kotlinx-coroutines.
1

Add the dependency

In your app module’s build.gradle.kts:
build.gradle.kts
It comes from Maven Central, which new Android projects already list under repositories. There are no permissions to add: the SDK’s own manifest declares INTERNET, and the photo picker it uses needs none.
2

Tell Feddy which project this is

Do this once, when the app starts, before anything else can open Feddy. Calling it again later does nothing. Application.onCreate is the place:
MyApplication.kt
If your app doesn’t have an Application class yet, add this one and register it in AndroidManifest.xml with android:name=".MyApplication" on the <application> element.
The project ID isn’t a secret. It’s built into your app, so anyone who downloads the app can find it, and that’s fine: it only tells Feddy which inbox a message belongs to. Commit it to your repository like any other setting. There’s nothing to protect, so keep it out of local.properties and your secrets.
3

Give users a way in

Add a row wherever users already go looking for help. For most apps that’s Settings:
SettingsScreen.kt
present() opens Feddy full screen, in an activity of its own, on its home: a greeting, a button to send a new message, and the user’s recent conversations. The system back gesture closes it. If you’d rather skip straight to the new-message screen, call presentNewConversation() instead.FeddyUnreadDot shows a count when a reply is waiting and draws nothing when there’s nothing unread.
4

Send yourself a message

Run the app, tap the row, and send a message. Then open your inbox at dash.feddy.app: it’s there, with the device model and app version alongside.Reply from the inbox. Back in the app, the reply appears in the conversation, and the Support row shows a 1 until the user opens it.
That’s the whole loop: a user writes in, you answer, and the answer reaches them inside the app.

Next steps

Identify users

Tell Feddy who’s logged in, so you see their name in the inbox and replies can reach them by email.

Unread badge

Put the count on a navigation bar item, a custom row, or anywhere else.

Conversations

What you’re looking at in the inbox, and what happens on its own.

Android SDK reference

Every call in the library, with its signature and what it does.