# Copilka on iPhone

The iPhone app, what it needs, how you sign in, and how it differs from the Mac.

Copilka for iPhone is the same library as your Mac's, on the phone. It signs in to the same account, syncs through the same service, and keeps things the same way: rooms, tags, the reader, properties, favourites. It adds what a phone can do that a Mac cannot: a camera, a live code scanner, and a share sheet for saving from any app.

![The Home screen: Everything and Favorites, the kinds, recent saves, rooms and tags](https://docs.copilka.app/img/iphone/home.webp)

## What it needs

- **iOS 18 or later.**
- **An iPhone.** There is no iPad layout; on an iPad the app is not offered. It runs in portrait only.
- **A Copilka account**, the same one you use on the Mac. The app cannot be used without signing in.

The iPhone app is in the works. When it is ready it comes by TestFlight invitation, sent to the address your account uses. It is not on the App Store.

## Signing in

The first screen is the sign-in gate, and it stays until you are signed in.

1. Choose **Continue with Google**, **Continue with GitHub**, or type your email and tap the arrow. A **Last used** badge marks whichever way in this phone used last time.
2. With Google or GitHub, a system sign-in sheet opens. Nothing is remembered from it afterwards, so a later sign-in asks again.
3. With email, the next step is **Check your email** with six boxes for the code. The code fills itself in from Messages or Mail when iOS offers it, and submits itself once all six digits are there. **Send again** sends another; **Go back** returns to the first step.
4. You land on **Welcome aboard!** for a new account, or **Welcome back.**

An account covers two Macs and one iPhone. If another iPhone is already signed in, the gate says **Another iPhone is signed in** and explains which one and that it is the one used longest ago. **Replace** signs that phone out and this one takes its place; **Cancel** leaves things as they were. See [Devices](https://docs.copilka.app/sync/devices/) for the rule and how to remove a device by hand.

If the service ends the session, for example because you removed this phone from the Account page on your Mac, the phone says **This iPhone was signed out** and returns to the gate. The library on the phone stays.

## The Home screen

Home is where the app opens by default. From top to bottom:

- **A gear** at the top left opens Settings. **Your initials** at the top right open Settings straight on the Account page.
- **A sync banner** appears only when sync needs your attention: it is off, you are offline, the plan does not include it, or the last pass failed. When all is well there is no banner. Tap it to open the Sync page.
- **Tiles**: **Everything** and **Favorites** first, then **Unsorted**, **Links**, **Images**, **Videos**, **Files** and **Text**, each with its count. These are the same smart views as the Mac's sidebar.
- **Recent**: your ten newest saves as a row of cards. Tap one to open it; hold one for its menu.
- **Rooms**: each with its mark, name and count. A room with sub-rooms has a chevron that expands it. The **+** makes a new room; holding a room opens its menu. Before you have any: *No rooms yet. Things wait in Unsorted until there is one.*
- **Tags**: pills with the reader's emoji, the name and a count. A tag with sub-tags is a fuller pill that opens into a shelf of them. The branch button is **Arrange tags**; **+** makes one by hand. Before you have any: *No tags yet. The reader gives things theirs; + makes one by hand.*
- **The bottom bar**: a pill with **Write a note**, **Paste** and **Photos**, and a round **+** that opens the full save menu. See [Saving on iPhone](https://docs.copilka.app/iphone/saving/).

Pull down anywhere on Home to run a sync pass.

## Getting around

There are no tabs. Home leads to a board, a board leads to an item, and Settings is a sheet over whatever you are on.

- A **board** is Everything, Favorites, Unsorted, one kind, one room or one tag. Its search field filters that board, and understands the same property queries as the Mac. There is no search across the whole library from Home; open Everything and search there.
- A board's sort button offers **Recently added**, **Recently edited**, **Oldest first**, **Title** and **How I arranged them**, and three tile sizes: **Small**, **Medium** and **Large**. The size is remembered per board, on this phone.
- **Hold a card** and its menu opens. **Hold and move** to rearrange; the first drag switches this phone's sort to *How I arranged them*. The phone's arrangement is its own and never moves the Mac's.
- The **item screen** is described on its own page: [The item screen](https://docs.copilka.app/iphone/item-screen/).

Settings → General → **Opens on** chooses what the app starts on: Home, a smart view, a kind, a room or a tag. A board chosen there opens with Home one tap back.

## How it differs from the Mac

The two apps share their engine, so what a thing *is* and what the reader makes of it is the same on both. What differs is the shape around it.

| On the Mac only | On the iPhone only |
| --- | --- |
| Quick Capture with ⌥⌘K, and capturing the page in front of you | The **Camera**, and **Scan** for codes, passes and tickets |
| **Read as you**, reading pages with your own logins | The **share sheet** from Safari and other apps |
| **Compare** | Importing from **Photos** |
| Your own API keys | The **Home** screen |
| Files referenced where they already are on disk | Its own arrangement and sort, separate from the Mac's |
| Drag and drop from Finder; Reveal in Finder; open in another app | Tile sizes per board |
| Keyboard shortcuts, the sidebar, board fill modes | Alternate home-screen icons |
| Settings pages Quick Capture, Shortcuts, Connections and About | A Sync page of its own, and pull to refresh |
| Sorting by a property | |

Everything else is the same on both: the account, the reader, kind cards, rooms and sub-rooms, tags, properties and their presets, Fill, Alternatives, Read again, covers, delete with Undo, and deleting the account.

---

This page: https://docs.copilka.app/iphone/ · As Markdown: https://docs.copilka.app/iphone.md · Every page: https://docs.copilka.app/llms.txt
