import { Tabs, TabItem } from "@astrojs/starlight/components";

The Teak mobile app lets you save inspiration on the go, capture voice notes, upload files, and browse your full library — all synced in real time with your other devices.

## Requirements

- iPhone running iOS 16.4 or newer
- A Teak account

## Install

Download the app from the [App Store](https://apps.apple.com/us/app/teak-save-inspirations/id6756574989) and sign in with your Teak account.

## Sign In

On first launch, Teak shows the welcome screen. Choose how you want to continue:

<Tabs>
  <TabItem label="Apple" icon="apple">

    One-tap authentication using your Apple ID. Tap **Continue with Apple** and approve with Face ID or Touch ID. Fastest option on iOS.

  </TabItem>
  <TabItem label="Google">

    OAuth sign-in via a browser redirect. Tap **Continue with Google**, pick an account in the browser sheet, and you'll return to Teak when it completes.

  </TabItem>
  <TabItem label="Email" icon="email">

    Tap **Login with Email** or **Register with Email** to open a native iOS form sheet. Both options take an email and password — tap the checkmark to confirm.

    For new accounts, use a password of at least 8 characters. Teak will send a verification email you must open before signing in.

  </TabItem>
</Tabs>

## Browsing Your Library

The **Home** tab shows your cards in a scrollable grid. Tap any card to open a full preview sheet with metadata, tags, notes, and action buttons.

## Saving Content

Open the **Add** tab to save new content manually:

| Action           | What it does                                            |
| ---------------- | ------------------------------------------------------- |
| **Text or URL**  | Type or paste any text or link                          |
| **Record Audio** | Record a voice note; Teak auto-transcribes it           |
| **Upload Files** | Pick images, documents, or other files from your device |

## Share Sheet (Import from Other Apps)

Use the iOS Share Sheet to save content to Teak without leaving another app:

1. In any app (Safari, Photos, Files, etc.), tap the **Share** button.
2. Select **Teak** from the share destinations.
3. The Teak share extension opens and saves the item automatically.

The share extension shows live status while saving:

- **Saving to your Teak vault…** — in progress
- **Your shared content was saved.** — success
- **Some items could not be saved.** — partial failure (individual items listed)
- **Shared content could not be saved.** — complete save failure
- **Sign in to save shared content.** — open Teak, sign in, then retry
- **Teak did not receive anything to share.** — share sheet was opened with no content

Supported share sources include links, text, images, and files. Files shared from Files or another app use the same source, Markdown, archive, Office, design, image, motion, and audio format support as Teak on the web, up to 100 MB.

## Settings

The **Settings** tab lets you:

- Switch appearance between **Auto** (follows iOS system setting), **Light**, and **Dark** via **Settings → Appearance**
- View your account email and card count
- Sign out
- Delete your account

## Troubleshooting

### App opens but cannot sign in

- Check your internet connection.
- Confirm your system clock is correct.
- Retry after a minute in case of a temporary auth service issue.

### Share sheet does not appear in iOS Share menu

- Open the iOS Share Sheet from any app.
- Scroll the share destinations row and tap **More**.
- Enable **Teak** in the list.

### Content saved via share sheet is missing

- Open the Teak app and pull down to refresh.
- Check that you were signed in at the time of the share.
- If the share status showed a partial failure, only some items may have saved.

### Still stuck?

Reach out via [Support](/docs/support).