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

# iOS App Setup

> Get started with the Popup Store iOS seller app

## Download the App

<Card title="App Store" icon="app-store-ios" href="https://apps.apple.com/app/popup-store">
  Download Popup Store for iOS (Coming Soon)
</Card>

Or install via TestFlight for beta access.

***

## Initial Setup

### 1. Create Account

<Steps>
  <Step title="Download and open app">
    Launch the Popup Store app on your iPhone
  </Step>

  <Step title="Sign up">
    Choose a signup method:

    * **Email & Password**
    * **Continue with Google**
    * **Continue with Apple**
    * **Continue with GitHub**
  </Step>

  <Step title="Verify email">
    Check your inbox for a verification email and click the link
  </Step>
</Steps>

### 2. Create Your Store

<Steps>
  <Step title="Business details">
    ```
    Business Name: My Awesome Store
    Owner Name: John Doe
    Business Type: Individual / Company
    GST Number: (optional for India)
    ```
  </Step>

  <Step title="Choose subdomain">
    Your store URL: `yourstore.mypopup.shop`

    Requirements:

    * 3-30 characters
    * Lowercase letters, numbers, hyphens only
    * Must be unique
  </Step>

  <Step title="Brand customization">
    * Upload logo (square, 512x512px recommended)
    * Choose brand color (hex code or picker)
    * Set currency (INR, USD, EUR, etc.)
  </Step>

  <Step title="Payment setup">
    Configure UPI for direct payments:

    ```
    UPI ID: yourname@paytm
    ```

    Optional: Add Razorpay API keys later
  </Step>
</Steps>

***

## Dashboard Overview

### Home Screen

The main dashboard shows:

<CardGroup cols={2}>
  <Card title="Store Views" icon="eye">
    Total visitors to your storefront
  </Card>

  <Card title="Product Views" icon="chart-line">
    Individual product page visits
  </Card>

  <Card title="Conversion Rate" icon="percent">
    Percentage of visitors who order
  </Card>

  <Card title="Recent Orders" icon="shopping-cart">
    Latest customer orders
  </Card>
</CardGroup>

### Navigation

<Tabs>
  <Tab title="Products">
    * View all products
    * Add new product
    * Edit existing products
    * Manage categories
    * AI image generation
  </Tab>

  <Tab title="Orders">
    * Pending orders (needs action)
    * Processing orders
    * Shipped orders
    * Order history
    * Payment verification
  </Tab>

  <Tab title="Store">
    * Store settings
    * Brand customization
    * Payment methods
    * Policies (shipping, returns, etc.)
    * Social media links
  </Tab>

  <Tab title="Profile">
    * Account settings
    * Store readiness checklist
    * Logout
  </Tab>
</Tabs>

***

## Adding Your First Product

### Quick Add

<Steps>
  <Step title="Tap '+' button">
    On the Products tab, tap the add button in top right
  </Step>

  <Step title="Product details">
    ```
    Title: Premium Cotton T-Shirt
    Description: Comfortable 100% cotton tee
    Price: ₹499
    Category: Clothing
    SKU: SHIRT-001 (optional)
    ```
  </Step>

  <Step title="Add images">
    Three options:

    1. **Take Photo** - Use camera
    2. **Choose from Library** - Select existing
    3. **Generate with AI** - DALL-E 2 powered
  </Step>

  <Step title="Variants (optional)">
    Add size/color variants:

    ```
    Size: S, M, L, XL
    Color: Red, Blue, Black
    ```

    Each combination creates a separate SKU
  </Step>

  <Step title="Save & publish">
    Product goes live on your storefront immediately ✅
  </Step>
</Steps>

### AI-Powered Features

**AI Image Generation:**

Describe your product, and DALL-E 2 generates a professional image:

```
Prompt: "Premium cotton t-shirt on white background, product photography"
```

**AI Description Generator:**

Get SEO-optimized product descriptions:

```
Input: "Cotton t-shirt, comfortable, 100% cotton"
Output: "Experience unparalleled comfort with our premium cotton t-shirt..."
```

***

## Managing Orders

### Order Workflow

```mermaid theme={null}
graph LR
    A[New Order] --> B{Payment?}
    B -->|UPI Direct| C[Verify Proof]
    B -->|Razorpay| D[Auto-Verified]
    C --> E[Mark as Paid]
    D --> E
    E --> F[Process Order]
    F --> G[Mark as Shipped]
    G --> H[Add Tracking]
    H --> I[Delivered]
```

### Verifying UPI Payments

<Steps>
  <Step title="Open pending order">
    Orders tab → Pending section
  </Step>

  <Step title="View payment proof">
    Tap order → View uploaded screenshot

    Verify:

    * [ ] Amount matches
    * [ ] UPI transaction ID visible
    * [ ] Recent timestamp
    * [ ] Your UPI ID as recipient
  </Step>

  <Step title="Approve or reject">
    * **Approve** → Order moves to "Paid"
    * **Reject** → Customer notified to resubmit
  </Step>
</Steps>

### Shipping Orders

<Steps>
  <Step title="Mark as processing">
    Tap "Start Processing" when you begin packing
  </Step>

  <Step title="Add shipping details">
    ```
    Courier: Delhivery / Blue Dart / DTDC
    Tracking Number: ABC123456789
    Expected Delivery: 3-5 days
    ```
  </Step>

  <Step title="Mark as shipped">
    Customer receives email with tracking link ✅
  </Step>
</Steps>

***

## Store Customization

### Branding

**Logo Upload:**

* Square format (1:1 ratio)
* Minimum 512x512px
* PNG or JPG
* Max 2MB

**Brand Color:**

* Choose any hex color
* Applied to buttons, links, accents
* Preview before saving

### Policies

Set up store policies for customer trust:

<AccordionGroup>
  <Accordion title="Shipping Policy">
    Example:

    ```
    - Free shipping on orders above ₹500
    - Standard delivery: 3-5 business days
    - Express delivery: 1-2 business days (₹50 extra)
    - Ships within 24 hours
    ```
  </Accordion>

  <Accordion title="Return Policy">
    Example:

    ```
    - 7-day return policy
    - Product must be unused with tags
    - Refund processed within 5-7 days
    - Return shipping paid by customer
    ```
  </Accordion>

  <Accordion title="Refund Policy">
    Example:

    ```
    - Refunds via original payment method
    - Processing time: 5-7 business days
    - Cancellations before shipping: Full refund
    - Cancellations after shipping: Minus courier charges
    ```
  </Accordion>
</AccordionGroup>

### Social Media Links

Add links to drive traffic:

```
Instagram: @yourstore
Facebook: fb.com/yourstore
Twitter: @yourstore
WhatsApp: +91 98765 43210
```

***

## Push Notifications

### Enable Notifications

<Steps>
  <Step title="Allow permissions">
    When prompted, tap "Allow" for push notifications
  </Step>

  <Step title="Notification types">
    You'll receive alerts for:

    * ✅ New orders
    * ✅ Payment proofs uploaded
    * ✅ Low stock alerts (coming soon)
    * ✅ Messages from customers (coming soon)
  </Step>

  <Step title="Customize settings">
    Settings → Notifications → Toggle specific alerts
  </Step>
</Steps>

***

## Store Readiness Checklist

Before sharing your store URL:

* [ ] At least **3 products** added
* [ ] Store **logo** uploaded
* [ ] **Brand color** set
* [ ] **Payment method** configured (UPI or Razorpay)
* [ ] **Shipping policy** filled
* [ ] **Return policy** filled
* [ ] At least one **social media link** added

<Info>
  The app shows your readiness score on the Profile tab. Aim for 100% before launch!
</Info>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Can't upload images">
    Common fixes:

    * Check image size (max 5MB)
    * Try compressing the image
    * Ensure stable internet connection
    * Grant photo library permissions in iOS Settings
  </Accordion>

  <Accordion title="Orders not appearing">
    Check:

    * You're logged into the correct account
    * Store is set to active (not draft)
    * Pull down to refresh the orders list
    * Check your email for order notifications
  </Accordion>

  <Accordion title="AI features not working">
    AI features require:

    * Active internet connection
    * Valid OpenAI API key (contact support)
    * Clear, descriptive prompts
  </Accordion>

  <Accordion title="Push notifications not working">
    Verify:

    * Notifications enabled in iOS Settings → Popup Store
    * App is updated to latest version
    * You're logged in
    * Test by creating a dummy order on web
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Product Management" icon="box" href="/seller/product-management">
    Learn advanced product features
  </Card>

  <Card title="Order Fulfillment" icon="truck" href="/seller/order-fulfillment">
    Master the order workflow
  </Card>

  <Card title="Store Customization" icon="palette" href="/seller/store-customization">
    Make your store stand out
  </Card>

  <Card title="Analytics" icon="chart-line" href="/seller/analytics">
    Track your store's performance
  </Card>
</CardGroup>