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

# Quick Start Guide

> Add feedback collection to your mobile app in under 10 minutes

## Overview

This guide will help you integrate SuggestKit into your mobile app quickly. Choose your platform and start collecting user feedback with native UI components!

## Step 1: Create Your Account

<AccordionGroup>
  <Accordion icon="user-plus" title="Sign up for SuggestKit">
    1. Visit [SuggestKit Dashboard](https://dashboard.suggestkit.app)
    2. Create your account with email or social login
    3. Verify your email address
  </Accordion>

  <Accordion icon="folder-plus" title="Create your first project">
    1. Click "Create Project" in the dashboard
    2. Give your project a name (e.g., "My App Feedback")
    3. Copy your project's API key - you'll need it for integration
  </Accordion>
</AccordionGroup>

## Step 2: Choose Your Mobile Platform

<CardGroup cols={2}>
  <Card title="📱 iOS (SwiftUI)" href="#swiftui-integration">
    Native iOS integration with SwiftUI components
  </Card>

  <Card title="🎯 Flutter" icon="flutter" href="#flutter-integration-coming-soon">
    Cross-platform support coming soon
  </Card>
</CardGroup>

## Step 3: SwiftUI Integration

### Installation

Add SuggestKit to your Xcode project using Swift Package Manager:

```
https://github.com/suggestkit/suggestkit-swift
```

### Basic Setup

```swift theme={null}
import SuggestKit
import SwiftUI

@main
struct MyApp: App {
    init() {
        // Initialize SuggestKit with your public API key
        SuggestKit.configure(apiKey: "your_public_api_key_here")
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}
```

### Set Current User

```swift theme={null}
// Set the current user (typically after login)
SuggestKit.setUser(
    id: "user_123",
    email: "user@example.com",
    customId: "your_internal_user_id"
)
```

### Show Feedback UI

```swift theme={null}
struct ContentView: View {
    @State private var showFeedback = false
    
    var body: some View {
        VStack {
            Button("Send Feedback") {
                showFeedback = true
            }
        }
        .sheet(isPresented: $showFeedback) {
            SuggestKitView()
        }
    }
}
```

## Step 4: Flutter Integration (Coming Soon)

Flutter support is coming soon! For now, start with our SwiftUI SDK for iOS development.

We're working hard to bring you the same great experience on Android with Flutter. Join our waitlist to be notified when it's ready:

* 📧 [Email Updates](mailto:notify@suggestkit.app?subject=Flutter%20SDK%20Waitlist)
* 💬 [Discord Community](https://discord.gg/suggestkit) for updates

For now, skip to Step 5 to test your iOS integration.

## Step 5: Test Your Integration

<AccordionGroup>
  <Accordion icon="mobile" title="Test in Your App">
    1. **Run your app** and navigate to the feedback UI
    2. **Submit a test suggestion** as a real user would
    3. **Try voting** on suggestions to test the interaction
    4. **Check offline behavior** by disconnecting internet
  </Accordion>

  <Accordion icon="globe" title="Verify in Web Dashboard">
    1. Log into your [SuggestKit Dashboard](https://dashboard.suggestkit.app)
    2. Navigate to your project
    3. Check that **users appear** in the Users section
    4. Verify **suggestions are listed** with correct vote counts
    5. Test **status updates** from the dashboard
  </Accordion>

  <Accordion icon="bug" title="Common Issues">
    **API Key**: Use your **public** API key (starts with `public_`), not the secret key

    **User Setup**: Call `setUser()` before showing feedback UI

    **Network**: SDKs handle offline gracefully - suggestions sync when online

    **iOS Permissions**: No special permissions needed - works out of the box
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="📊 Dashboard Guide" href="/guides/dashboard">
    Learn to manage feedback effectively
  </Card>
</CardGroup>

## Need Help?

<CardGroup cols={2}>
  <Card title="📱 SwiftUI Guide" href="/guides/swiftui">
    Native iOS development with complete customization
  </Card>

  <Card title="🎯 Flutter Guide" href="/guides/flutter">
    Cross-platform development (coming soon)
  </Card>

  <Card title="🔌 API Reference" href="/api-reference/introduction">
    Complete REST API documentation for custom implementations
  </Card>
</CardGroup>

**Have questions?** Reach out to our team:

* 💬 [Discord Community](https://discord.gg/suggestkit) for developer discussions
* 📧 [Support Email](mailto:support@suggestkit.app) for direct help
* 📺 [YouTube Tutorials](https://youtube.com/@suggestkit) for video guides