# Compatibility families

This matrix comes from the first real Nextcloud instance selected for testing.
It is intentionally organized by reusable capability instead of app-specific
screens.

## Live implementation status

| Experience | Current native support |
| --- | --- |
| Files | Real WebDAV folders, list/grid layouts, previews, file details, bounded downloads and ETag-protected UTF-8 editing |
| Photos and Memories | Real media search, thumbnail grid, RAW/server previews, recognized People covers, per-person galleries, full-screen navigation and pinch/double-tap zoom |
| Talk | Real room list, read-only history loading, typed file previews, call/system events and shared objects; sending is an explicit user action |
| Activity | Real read-only OCS activity timeline with refresh |
| Notes | Fast metadata-only list, Markdown editor/preview, formatting controls, category and favorite state, explicit save confirmation and ETag conflicts |
| Dashboard and User Status | Real widget/item feeds, native app routing, short-lived account-private cache, and confirmed capability-gated status editing |
| Chores and similar task apps | Verified household hierarchy, native task cards, recurrence, assignment, points and completion-history rendering through reusable semantics |
| Other installed apps | Discovered and mapped to a typed native family while their verified adapters are implemented |

All agent-run live tests are read-only. No Talk message, file save, Notes save,
delete, app-management action or administrator action is issued during automated
testing.

## Whole-app parity contract

Compatibility is not complete when an app merely opens. For every installed app, the native
experience must expose every feature that the exact installed version advertises through a
verified contract. The server contract remains authoritative; this table defines the semantic
workspace in which those features belong.

| Installed app | Upstream workspace model | Feature groups that must remain reachable |
| --- | --- | --- |
| Activity | Filtered chronological feed | Filters, actors, object previews, timestamps, pagination and safe deep links |
| Budget | Financial dashboard and ledger | Accounts, categories, transactions, totals, periods, charts and contract-backed editing |
| Calendar | Calendar navigator, time grid and agenda | Calendar visibility, month/week/agenda, search, event create/edit, recurrence, attendees, reminders and attachments |
| Chores | Household task workspace | Lists, assignees, recurrence, points, completion and history |
| Contacts | Address books, people list and contact inspector | Address books, groups, search, contact details, photos and contract-backed editing |
| Cookbook | Category navigator, recipe gallery and recipe reader | Categories, search, recipe images, ingredients, instructions, nutrition, yield and timers |
| Cospend | Project navigator, ledger and bill form | Projects, members, bills, balances, settlement, currencies, categories and reimbursement state |
| Deck | Board navigator and Kanban lanes | Boards, stacks, cards, ordering, labels, assignees, due dates, attachments, archive and activity |
| Files | Folder tree and file browser | List/grid, search, preview, upload, sharing, versions, favorites, offline state and sync |
| Mail | Account/folder/message workspace and composer | Accounts, folders, messages, threads, search, compose, drafts, recipients and attachments |
| Memories | Timeline and media collections | Date groups, albums, people, places, maps, favorites, RAW previews and selection actions |
| Music | Library navigator, queue and player | Artists, albums, tracks, playlists, genres, search, queue and playback controls |
| Office | Document browser and collaborative editor | New/open, format-specific editing, save state, locking, collaboration and version-safe handoff |
| Pantry | Contract-derived collection hierarchy | Every verified collection, relationship, detail, form, action and summary exposed by the installed version |
| Photos | Timeline and album gallery | Timeline, albums, favorites, shared media, tags, locations, selection and sharing |
| Search | Provider filters and result groups | All advertised providers, paging, previews and native deep links |
| Tables | Table/context navigator, typed grid and row form | Tables, contexts, templates, views, columns, rows, sorting, filters, inline editing, forms and sharing |
| Talk | Conversation list, chat thread and call workspace | Rooms, messages, replies, reactions, attachments, participants, calls, screen sharing and call controls |
| Tasks | List navigator and task inspector | Lists, smart filters, task editing, completion, priority, recurrence, due dates and subtasks |

The same semantic feature owns its state and actions on every platform. Layout adapts without
forking the workflow:

- Compact widths use one pane, touch-sized actions, system back, sheets and progressive detail.
- Medium widths use a navigation rail or list-detail layout when both regions remain usable.
- Expanded desktop widths use persistent navigation, multi-pane context, dense grids, keyboard
  shortcuts, pointer selection and inspectors.
- Every feature must cover loading, cached refresh, empty, offline, permission-denied,
  unsupported, stale-contract and partial-failure states.
- Every reachable action needs a meaningful accessibility name, logical focus order, scalable
  text, non-color status cues, keyboard access on desktop and touch access on mobile.
- A feature without verified mutation provenance stays visibly read-only. App-specific adapters
  are required for behavior such as Talk calls and Office collaborative editing that cannot be
  represented safely by reusable schema semantics alone.

| Installed app | Primary native family | Important secondary capabilities |
| --- | --- | --- |
| Dashboard | Dashboard | Widgets, activity and shortcuts |
| Talk | Conversation list + chat thread | Attachments, realtime events and calls |
| Files | File browser | Preview, upload, sharing, versions and offline state |
| Photos | Media grid | Albums, timeline, selection and sharing |
| Activity | Timeline | Filters, actors and deep links |
| Mail | Mailbox | Threads, composer, attachments and folders |
| Contacts | Contact list | Groups, details, editing and device contacts |
| Calendar | Calendar | Agenda, events, recurrence and attendees |
| Cospend | Collection + form | Projects, members, currency and settlement |
| GitHub | Dashboard + timeline | Repositories, issues, pull requests and links |
| Notes | Document editor | Lists, categories and offline editing |
| Music | Media library | Artists, albums, playlists and playback |
| Deck | Board | Stacks, cards, ordering and assignment |
| Budget | Data table | Categories, totals, charts and editing |
| Tasks | Task list | Lists, recurrence, completion and priorities |
| Tables | Data table | Typed columns, sorting, filtering and forms |
| Cookbook | Recipe list | Ingredients, steps, timers and images |
| Office | Document editor | File locking, collaboration and rich editing |
| Memories | Media grid | Date groups, maps, albums and RAW previews |
| Chores | Task list | Assignment, recurrence and completion |

## First implementation order

1. Collection list, detail and form establish the generic data contract.
2. File browser and media grid cover Files, Photos and Memories.
3. Task list, data table and board cover Tasks, Chores, Tables, Budget and Deck.
4. Conversation list, chat thread and mailbox cover communication data.
5. Calendar, media library, recipe and document editing add specialized
   interaction models.
6. Talk calls and Office collaborative editing require verified adapters rather
   than unconstrained inference.