iOS App Manual

1. 01Open the app and follow the first launch prompts.
2. 02Choose artist, collector, or both when the account type screen appears.
3. 03Create an account or sign in to keep records backed up and synced with the web dashboard.
4. 04Check Account, Settings after onboarding to confirm preferred units, preferred currency, inventory code format, and visible fields.

• Use the Library tab to move between Artworks and Collections.
• Switch artwork display between grid and list when available.
• Search across visible artwork fields such as title, artist, inventory code, medium, category, location, notes, description, and tags.
• Open the filter drawer to choose status, category, medium, tag, location, collection, and year filters.
• Filters use draft choices. Tap Apply to update the list or Clear to reset.
• Use selection mode for batch edit, status changes, collection actions, tags, renumbering, or deletion.

Manual entry

1. 01Tap Add in the bottom tab bar.
2. 02Choose manual entry or create without image.
3. 03Fill in the artwork details and save.

Camera or single photo

1. 01Tap Add.
2. 02Choose Take Photo or Select Photo.
3. 03Confirm the image, then complete the artwork form.
4. 04Save and let the sync queue upload the record and media.

Batch photo import

1. 01Tap Add, then Batch Photos.
2. 02Select multiple images from the photo library. The app can create one artwork per photo, subject to plan limits.
3. 03Set a base title, starting number, shared status, and any shared fields.
4. 04Review titles, then create the batch.

Common edits

• Update title, status, category, medium, year, dimensions, duration, weight, price, currency, location, notes, description, provenance, tags, and inventory code.
• Use the rich text editor for descriptions that need bold, italic, paragraphs, and line breaks.
• Crop, rotate, replace, or add images from the detail page.
• Use Manage Editions for larger edition sets.
• Generate COAs and labels from the artwork detail page when available for your plan.
• Attach documents on Studio where the documents feature is available.

• Offline work is saved in SwiftData on the device.
• When a connection is available, the sync engine sends pending operations and pulls server changes.
• An offline banner appears when the device is disconnected.
• Settings shows sync status, pending operations, failed operations, retry controls, and Pull Latest Changes.
• PDF generation, billing, video upload, cloud media upload, and web handoffs require internet.

Collections

• Collections live in Library beside Artworks.
• You can create collections, edit collection membership, reorder artworks, and use collections as working groups.

Catalogs

• Open Share, Catalogs to create a PDF or view saved catalogs.
• Choose artworks, layout, visible fields, and artist pages.
• PDF generation uses the web API and requires internet.

Viewing rooms

• Viewing rooms are managed in the web dashboard.
• iOS can show synced rooms, search/filter them, open the web dashboard, open room details, copy room links, and share existing public links.
• If a room is missing on iOS, pull latest changes after creating or editing it on the web.

Portfolio

• Portfolio editing stays on the web dashboard.
• iOS can open the portfolio dashboard and share the live portfolio link when the portfolio is published.

Account tab

• Settings controls profile, artist text, units, currency, inventory codes, visible fields, COA signature, sync, and account deletion.
• Billing shows plan status and opens the native paywall, App Store subscription management, restore purchases, or web billing where relevant.
• Import opens CSV import.
• Export Data can export local CSV/JSON record files and display image ZIPs. Original image and video archive export is handled on the web.
• Open on Web launches the browser dashboard for web-only workflows.
• Help & Support opens this iOS guide directly.

• Video upload requires Studio, an internet connection, and a synced artwork record.
• Viewing room management is web-led. iOS can show and share existing synced rooms.
• Portfolio publishing and portfolio design controls are managed on the web.
• Original-resolution image ZIP export and Bunny video archive export are handled on the web dashboard.
• Instagram import is not generally available in production until Meta approval is complete.
• The native app requires iOS 18 or later.

• Camera unavailable: open iOS Settings, Artwork Codex, and allow camera access.
• Photo selection unavailable: confirm Photos permission in iOS Settings.
• Web changes missing: open Account, Settings, Sync, then Pull Latest Changes.
• Pending record not visible on web: keep the app open on a stable connection until pending operations finish.
• Video upload blocked: confirm Studio access, internet connection, file size, and that the artwork has synced.
• Purchase not reflected: open Billing and use Restore Purchases, then wait briefly for account access to refresh.
• PDF generation disabled: connect to the internet and confirm the account is not frozen or past due.

• Your private archive syncs to the same protected backend used by the web dashboard.
• Public portfolio and viewing room visibility are controlled by explicit publishing choices.
• Camera and photo library access are requested only for actions that need them.
• App Store billing is handled through Apple and entitlement sync is handled through RevenueCat.
• Deleting an account is permanent and removes account data and associated media through the account deletion flow.

Include

• Account email.
• Device model.
• iOS version.
• Artwork Codex app version from the Account tab.
• Whether the issue happened offline, online, or during sync.
• Any visible sync status, pending operation count, or error message.
• Steps to reproduce the issue.