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

# App Store Assets

> AI-generate the app icon, splash screen, listing copy, and screenshots for your iOS + Android submissions

App Store and Google Play submissions ask for two categories of assets: **graphics** (icon, splash screen, screenshots, hero images) and **copy** (app name, subtitle, description, keywords, promotional text). Hiveku generates all of them from a short brief — name, tagline, accent color — and saves the results into your project.

## What gets generated

| Asset                 | Format                                                | Where it goes                                   |
| --------------------- | ----------------------------------------------------- | ----------------------------------------------- |
| **App icon**          | 1024×1024 PNG (Apple), adaptive icon (Android)        | `assets/icon.png` + `assets/adaptive-icon.png`  |
| **Splash screen**     | 1284×2778 PNG (Apple), splash with bg color (Android) | `assets/splash.png` + `app.json` `splash` block |
| **App name**          | ≤30 chars (Apple), ≤30 chars (Google)                 | Copied to clipboard for ASC + Play Console      |
| **Subtitle**          | ≤30 chars (Apple only)                                | Copied to clipboard                             |
| **Promotional text**  | ≤170 chars (Apple, editable post-launch)              | Copied to clipboard                             |
| **Description**       | ≤4000 chars                                           | Copied to clipboard                             |
| **Keywords**          | ≤100 chars comma-separated (Apple)                    | Copied to clipboard                             |
| **Short description** | ≤80 chars (Google only)                               | Copied to clipboard                             |
| **Full description**  | ≤4000 chars (Google only)                             | Copied to clipboard                             |

The graphics save directly into your project's `assets/` folder and the next OTA Update or Build & Ship picks them up. The copy is meant to be pasted into ASC / Play Console manually (Hiveku doesn't have direct write access to your store listings).

## How to use it

<Steps>
  <Step title="Open the App Store Assets tab">
    From your project nav. Only visible on Native Mobile projects.
  </Step>

  <Step title="Fill the brief">
    Three fields:

    * **App name** (\~3–5 words). This is what shows under the icon on the home screen and in the App Store search results.
    * **Tagline** (\~1 sentence). Used as inspiration for subtitle and promotional text. Examples: "The fastest way to track expenses." / "Mood journaling that learns about you."
    * **Accent color** (hex picker). Drives the icon palette and splash background. Default is your project's brand color if set elsewhere; otherwise Hiveku amber `#F9A825`.
  </Step>

  <Step title="Click Generate Assets">
    Hiveku runs the request as a single API call. You get back:

    * The icon (rendered live)
    * The splash screen (rendered live)
    * All copy fields, each in a copy-to-clipboard box

    Generation takes \~30 seconds.
  </Step>

  <Step title="Approve or regenerate">
    Each asset has a **Regenerate** button that re-runs with the same brief but fresh AI sampling. Useful when the icon style isn't quite right — usually 2–3 regenerations land on something good.
  </Step>

  <Step title="Save to project">
    Click **Save assets**. Hiveku writes the icon + splash files into `builder_code_versions` (replacing the placeholder `assets/icon.png` from the starter). Triggers file-sync, so the preview reflects the new icon within seconds.
  </Step>

  <Step title="Paste copy into store listings">
    Open App Store Connect → your app → App Information. Paste each field. Same on Play Console → Main store listing. Hiveku doesn't auto-fill these because Apple and Google require human submission to maintain content responsibility.
  </Step>
</Steps>

## What the icon style looks like

The generator targets a **modern flat / soft-shadow aesthetic** — the dominant style in the App Store top charts (Notion, Linear, Cash App, Headspace, Robinhood). Concretely:

* Single-letter monogram or simple geometric mark
* Soft gradient using the accent color + a complementary tint
* Slight inner shadow for depth, no heavy 3D effects
* iOS-friendly rounded square mask (Apple applies the mask, but the icon is generated unmasked)

If you want something more illustrated or brand-specific, the **Regenerate with style hint** dropdown offers presets: `Minimal`, `Illustrated`, `Photorealistic`, `Retro`, `Brand monogram`. Each adjusts the underlying generation prompt.

## What the copy looks like

The AI is tuned for the App Store voice — concise, benefit-led, action-verb opening:

```
App Name: TaskWise
Subtitle: Privacy-first task notes
Promo: Capture tasks faster than you can think. Locally encrypted. No cloud, no tracking.
Description (truncated):
  TaskWise turns the messiest day into 60 seconds of focused planning.
  Just type a thought; we organize. Tap a task; we remind you.
  
  • Lightning-fast capture — opens to a blank cursor in <1 second
  • Smart auto-tagging — recognizes projects, dates, people without setup
  • End-to-end encryption — your tasks stay on-device by default
  ...
```

Compare against an LLM left to its own devices, which produces:

```
TaskWise: A revolutionary task management application that leverages
cutting-edge AI technology to deliver an unparalleled productivity
experience for the modern professional.
```

The Hiveku generator avoids "revolutionary," "leverages," "cutting-edge," and similar Apple-rejected language — these correlate with App Store Connect rejections under guideline 2.3.7 ("App descriptions should not include marketing-style language").

## Screenshots

Screenshots are *not* AI-generated — they're real captures of your app. Use the **Take screenshots** button in the [phone-frame preview](/mobile/preview):

<Steps>
  <Step title="Pick the device">
    For iOS App Store, you need 6.7" (iPhone 15 Pro Max) screenshots minimum. For iPad apps, also 12.9" (iPad Pro). For Android, any Pixel-class device.
  </Step>

  <Step title="Navigate to the screen you want">
    Sign in, get to the screen, dismiss any modal you don't want captured.
  </Step>

  <Step title="Click capture">
    The capture button on the preview toolbar saves a PNG to your downloads. The chrome (notch, status bar) is removed so it's a clean app screenshot.
  </Step>

  <Step title="Repeat for 3-10 screens">
    Apple allows up to 10 screenshots per device size. Use 3–5 well-chosen screens that tell a story: hero feature → social proof → results screen.
  </Step>
</Steps>

App Store Connect and Play Console expect you to upload these manually — neither Apple nor Google offers a programmatic upload that Hiveku could call without owning your developer account session, which we deliberately don't.

## Iterating on the brief

The generator stores your last brief in `builder_project_settings`, so you can reopen the App Store Assets tab months later, tweak the tagline, regenerate, and save without retyping everything. Each save creates a new version in the `builder_code_versions` history — old icons aren't lost, you can roll back via the file history pane in the editor if a new icon is worse than the previous one.

## Why we generate, not just suggest

A common alternative is "AI shows you 4 example icons, you pick one." We tried that — it's worse than direct generation. Reasons:

* **Picking from 4 trains decision fatigue** — by screenshot 6 your brain is mush
* **Variation pressure** — when the AI must show 4 distinct options, two are usually weird in ways nobody asked for
* **The "saved" path is faster** — a single generation + 1-2 regenerations beats picking + tweaking from 4

If you'd rather curate, the **Regenerate** button rolls a fresh option each time and you can keep regenerating until satisfied. Functionally equivalent, but you stay in flow.

## Limitations

* **No video preview generation** — App Store accepts a 30-second app preview video. We don't generate this; record one with QuickTime + iPhone or use Apple's mirroring tool.
* **No localization** — currently English-only. The copy generator doesn't yet output translated strings for non-US App Stores. On the roadmap once we have a target locale list from customers.
* **Icon generation is single-shot** — we don't do "here's a sketch, refine this exact mark." If you have a logo from a designer, save it as `assets/icon.png` directly via the editor and skip the generator.

## What's next

<CardGroup cols={2}>
  <Card title="Builds & Submissions" icon="rocket" href="/mobile/builds">
    Get the binary that uses these assets to TestFlight + Play Console.
  </Card>

  <Card title="Phone-Frame Preview" icon="mobile" href="/mobile/preview">
    Capture screenshots for App Store / Play Console submission.
  </Card>
</CardGroup>