> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moca.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Flutter troubleshooting

> Resolve common AIR Kit Flutter integration issues — installation errors, platform configuration, login failures, WebView problems, and SDK initialization.

## Installation and OnePub

| Issue                      | What to try                                                                                           |
| -------------------------- | ----------------------------------------------------------------------------------------------------- |
| `onepub` command not found | Add `$HOME/.pub-cache/bin` to PATH                                                                    |
| Package resolve failures   | `onepub login`, verify hosted URL and version in [Flutter installation](/airkit/flutter/installation) |

## Android

| Issue                            | What to try                                                                                                    |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Passkey / asset links            | [Android setup](/airkit/flutter/android-setup): `strings.xml`, manifest `meta-data`, signing cert allowlisting |
| `minSdk` / manifest merge errors | Set `minSdk` 26+, `compileSdk` 34+                                                                             |

## iOS

| Issue              | What to try                                                                               |
| ------------------ | ----------------------------------------------------------------------------------------- |
| Associated Domains | [iOS setup](/airkit/flutter/ios-setup): capability, exact domain entries, physical device |
| CocoaPods          | `cd ios && rm -rf Pods Podfile.lock && pod install`                                       |

## Runtime

| Issue                        | What to try                                                          |
| ---------------------------- | -------------------------------------------------------------------- |
| Login UI does not appear     | `navigatorKey` passed to `MaterialApp` and `initialize()`            |
| `Service is not initialized` | Await `initialize()` before other calls                              |
| WebView blank                | Platform network config, ATS (iOS), Associated Domains / asset links |

## Credentials on Flutter

Credential **issuance** and **verification** are available on Flutter. Use the [Issue credentials](/airkit/quickstart/issue-credentials) and [Verify credentials](/airkit/quickstart/verify-credentials) quickstarts, plus [Issuing credentials](/airkit/usage/credential/issuing-credentials) and [Verify](/airkit/usage/credential/verify).

If calls fail or payloads are rejected, see [Credential issues](/airkit/troubleshooting/credential-issues). For Google OAuth client IDs and dashboard-side setup, see [Google Sign-In — Dashboard](/airkit/flutter/google-signin#dashboard).

## More help

* [SDK issues](/airkit/troubleshooting/sdk-issues) — includes Flutter-specific notes
* [Common errors](/airkit/troubleshooting/common-errors)
* Support via your Moca / partner channel