# DockDeck implementation status

Updated: 2026-07-22

| MVP criterion                                     | Status        | Evidence                                                                                                                  |
| ------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Read-only Docker/Unraid discovery                 | Live verified | AppOps GET adapter, optional restricted proxy overlay, mocks and adapter tests.                                           |
| New containers hidden                             | Built         | Repository insert invariant and API/database tests.                                                                       |
| App visibility/name/category/order/URL management | Built         | Settings UI, Zod API and persistence tests.                                                                               |
| Persistent app removal                            | Verified      | DockDeck-only delete endpoint, `removed_apps` suppression and rediscovery/export coverage.                                |
| Local WebUI detection                             | Built         | Unraid XML parser, port substitution and unit tests.                                                                      |
| Status and ~30 second polling                     | Built         | Runtime state mapping and visibility-aware client interval.                                                               |
| Categories and both dashboard views               | Built         | CRUD API, settings and responsive overview/tab UI.                                                                        |
| Favorites                                         | Built         | CRUD API, settings, dashboard tiles and search index.                                                                     |
| Search and Google fallback                        | Verified      | Dynamic full-payload index, keyboard selection, explicit Google action and browser flow.                                  |
| Links open in new tabs                            | Built         | All tiles/results use `_blank` with `noopener noreferrer`.                                                                |
| Three themes                                      | Built         | Porcelain, Midnight and Harbor tokens and controls.                                                                       |
| Persistent appearance customization               | Verified      | Theme, mode, accent, density, width, background, hero, status, reduced motion and polling with migration/export coverage. |
| Searchable settings                               | Verified      | Global section search, accessible controls and automatic scroll restoration on section changes.                           |
| Read-only service widgets                         | Verified      | Per-app opt-in, eight-widget limit, domain data, three sizes, four layers and configurable presentation.                  |
| Configurable Tower identity                       | Live verified | Persistent server name/URL in Settings, search and host card; live URL is `192.168.10.150:5000`.                          |
| Automatic favorite favicons                       | Verified      | First-party `/favicon.ico` derivation, explicit override and monogram fallback.                                           |
| SQLite persistence                                | Built         | Named Docker volume and restart persistence test.                                                                         |
| Export/import                                     | Built         | Versioned Zod schema, API and settings flow; secrets excluded.                                                            |
| Read-only NPM integration                         | Built         | Optional server-side adapter, unambiguous matching and fallback.                                                          |
| Degraded states                                   | Built         | Adapter isolation, health states, banner and integration panel.                                                           |
| Docker/Unraid packaging                           | Live verified | Commit `3ffd39b`, one healthy `DockDeck` on `192.168.10.150:1218`; 137 stored/55 visible apps and 90 GET-only containers. |
| Private Gitea repository                          | Verified      | Private `NuklearRabbit/DockDeck`; local `main` tracks `origin/main`.                                                      |
| Professional responsive UI                        | Live verified | 390px through ultrawide plus live 1280×720; adaptive cards, persistent favorites sidebar and no overflow.                 |
| Independent widget composition                    | Verified      | Order, size, content, labels, metric styles/limits, any-signal warnings, cadence, charts and edit mode.                   |
| Native Unraid health                              | Live verified | Array STARTED, parity healthy, three storage groups and temperatures through read-only mounts.                            |
| App-specific provider breadth                     | Live verified | 97/97 stored apps have an explicit domain profile; zero generic profiles remain in the live capability audit.             |
| Per-app metric composition                        | Live verified | Labels can be selected, ordered, styled, limited, charted and monitored and survive presets/export/restart.               |
| Configurable Unraid trends                        | Live verified | Container, image, storage, temperature, parity and UPS series with statistic selection and 60-point memory.               |
| Unraid Docker-list icon                           | Live verified | DockerMan visibly renders the 512×512 PNG after both persistent and active caches are refreshed.                          |
| Layout presets                                    | Verified      | Create, apply, delete and independent import/export with database/API/browser coverage.                                   |
| PWA and diagnostics                               | Live verified | Installable shell excludes `/api`; diagnostics are secret-free and report native/integration health.                      |