ayushyaandClaude Sonnet 5
73e05f8d22
- Revert the scrollbar-thumb feature entirely (per-view Scrollbar wrappers and the ScrollbarThemeData override) - back to plain scrollables with no visible thumb - Settings: move the logout button into the profile card (next to the name/email), and move the ONLINE/OFFLINE badge + "Connected to..." text out of the top row into a combined line at the bottom of the card, instead of split between the AppBar and the top of the screen - Update architecture.md/styling.md to drop the stale scrollbar-theme documentation Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
111 lines
6.0 KiB
Markdown
111 lines
6.0 KiB
Markdown
# Architecture
|
|
|
|
## Layout
|
|
|
|
```
|
|
lib/
|
|
main.dart # app root, theme wiring, top-level navigation switch,
|
|
# MainShellView (bottom-nav shell), share-intent listener
|
|
models/ # plain data classes (NextcloudItem, NextcloudShare,
|
|
# SavedAccount, AppTab, ...)
|
|
providers/ # ServerProvider — the single app-wide ChangeNotifier
|
|
services/ # network/IO: NextcloudService, LoginFlowService,
|
|
# AccountStore
|
|
theme/ # AppTheme (Material 3 ThemeData)
|
|
views/ # one screen each (FilesView, PhotosView, TrashView,
|
|
# SharesView, RecentView, ActivityView, SearchView,
|
|
# AccountView, LoginView, FileViewerScreen,
|
|
# ShareUploadView)
|
|
widgets/ # reusable pieces shared across views
|
|
details/ # the file-details bottom sheet and its tabs
|
|
```
|
|
|
|
`views/` files are screens routed to directly (a tab, or pushed via
|
|
`Navigator`). `widgets/` files are building blocks used by more than one
|
|
view (or complex enough to warrant their own file) — nothing in `widgets/`
|
|
owns app state itself; it reads it from the `ServerProvider` passed down or
|
|
read via `context.watch`/`context.read`.
|
|
|
|
## State management
|
|
|
|
There is exactly one `ChangeNotifier`: [`ServerProvider`](../../lib/providers/server_provider.dart)
|
|
(~1500 lines). It is created once in `main()` and provided at the root with
|
|
`provider`'s `ChangeNotifierProvider`. It owns:
|
|
|
|
- **Multi-account state**: the list of saved accounts (`accounts`), which one
|
|
is active (`activeAccountId`/`activeAccount`), and a `_sessionGeneration`
|
|
counter incremented on every account switch so an in-flight fetch from the
|
|
account just left can recognize it's stale and discard its result instead
|
|
of writing into the newly-active account's state — every method that
|
|
writes fetched data into a shared field (`refreshData`, `fetchAllMedia`,
|
|
`fetchTrash`, `fetchShares`, `fetchRecent`,
|
|
`_applyCredentialsForAccount`) captures the generation at entry and checks
|
|
it before each write. See `server.md` for the full account-switch/storage
|
|
story.
|
|
- auth/session state for whichever account is active (`isLoggedIn`,
|
|
`isRestoringSession`, login-flow status)
|
|
- the active `NextcloudService` instance (null until logged in)
|
|
- all fetched data, scoped to the active account (`items`, `quota`,
|
|
`activities`, `photoItems`, `trashItems`, `shares`, `recentItems`) — all
|
|
torn down and refetched fresh on every account switch (no simultaneous
|
|
multi-account state; only one account's content is ever live in memory)
|
|
- navigation-within-files state (`currentFolderPath`, `pathStack`), plus an
|
|
in-memory `_directoryCache` keyed by folder path (see `CachePolicy`)
|
|
- UI settings that persist across launches — split into **global** (theme
|
|
mode, seed color, dynamic-color toggle, bottom-bar opacity/blur,
|
|
tap-tab-to-scroll-top, seek bar style, tab order/visibility/default, swipe
|
|
actions) and **per-account** (grid/list view, favorites-only, show-hidden,
|
|
storage scope, Photos sort, Files' per-folder sort map, cache policy) — see
|
|
`server.md` for exactly which is which and why
|
|
|
|
New **global** state belongs on `ServerProvider` as a private field + getter
|
|
+ a method that mutates it, calls `notifyListeners()`, and persists via
|
|
`_prefsFuture`. New **per-account** state follows the same shape but
|
|
persists through `_persistAccountPref` (namespaces the pref key under
|
|
`acct_<activeAccountId>_...` via `AccountStore.accountPrefKey`) and must be
|
|
reset/reloaded in `_applyAccountPrefs` so it's correct after a switch.
|
|
Screen-local state (e.g. a `TextEditingController`, an expanded/collapsed
|
|
flag) stays in that view's own `State` class — see `standards.md` for the
|
|
split.
|
|
|
|
There's no separate repository/data layer: views call `ServerProvider`
|
|
methods directly, which call `NextcloudService`/`LoginFlowService`/
|
|
`AccountStore`.
|
|
|
|
## Navigation / screen flow
|
|
|
|
`main.dart`'s `NextcloudApp` picks the app's `home` screen from provider
|
|
state, no named routes:
|
|
|
|
- `provider.isRestoringSession` → `_SplashView` (monochrome app icon,
|
|
tinted via `ColorFiltered` to the theme's `onSurface` so it works in both
|
|
light/dark, plus a small spinner, while `flutter_secure_storage`/
|
|
`shared_preferences` are read on startup)
|
|
- else `!provider.isLoggedIn` → `LoginView` (server-address entry + Login
|
|
Flow v2) — `isLoggedIn` is only ever false here or after the last saved
|
|
account is removed; switching between multiple saved accounts never
|
|
routes through this screen (see `server.md`)
|
|
- else `MainShellView`
|
|
|
|
`MainShellView` is a bottom-nav `IndexedStack` over up to 6 tabs — Files,
|
|
Photos, Activity, Trash, Shares, Recent — user-configurable (order,
|
|
visibility up to `maxVisibleTabs`, default tab) via `AppTab`/`ServerProvider`
|
|
and rendered through `buildAppTabView` (`widgets/app_tab_view_builder.dart`).
|
|
Each tab keeps its own `ScrollController` (survives tab switches via
|
|
`IndexedStack`'s built-but-hidden trees) and tapping the already-active tab
|
|
scrolls it back to top (`tapTabToScrollTop` setting). `MainShellView` also
|
|
owns the app's share-intent listener (`receive_sharing_intent`): both
|
|
`getInitialMedia()` (cold start via another app's "Share to...") and
|
|
`getMediaStream()` (already running) push `ShareUploadView`.
|
|
|
|
Five of the six tabs (all but Files) plus each tab's own controls share
|
|
[`SyncedHeaderScaffold`](../../lib/widgets/synced_header_scaffold.dart) — a
|
|
`CustomScrollView` with a pull-down "sync status" header (Google
|
|
Photos-style) and a classic Material refresh spinner shown during a
|
|
pull-triggered sync. `SearchView`, `AccountView` (Settings), the
|
|
file-details sheet, the share sheet, and `ShareUploadView` (the
|
|
share-to-upload destination picker) are pushed on top via
|
|
`Navigator`/`showModalBottomSheet`/`showGradualBottomSheet` rather than
|
|
being tabs. `ProfileAvatarButton` (top-right on every tab) opens Settings on
|
|
tap and cycles between saved accounts on a vertical swipe.
|