v3: src/components sorted into feature folders, the four largest files split, and the component tests mirror the new layout — 48 components sat in one flat folder, ChatModal ran to 1301 lines, DumpCreateModal to 983, and the tests were grouped by theme, so there was no telling which component had none. Components now live in category/, chat/, comment/, dump/ (with dump/create/ for the new-dump wizard), editor/, form/, layout/ (header, page shell, floating buttons), player/, playlist/, profile/, social/ (vote, like, follow, the who-voted popover) and ui/; FeedTabBar and PresenceRow, used by the index page alone, move to pages/index/. ChatModal gives up ChatMessageItem, PendingItem, ChatEditBox and ReplyRef, the message limits and text helpers (chat/message.ts), the day and clock labels (chat/time.ts) and the draft storage (utils/chatDraft.ts, next to dumpDraft.ts). DumpCreateModal gives up StepIndicator, LocalFilePreview, TitleField and DuplicateNotice; CommentThread gives up CommentForm and CommentNode; TextEditor gives up the emoji picker popup and its skin-tone storage; MediaPlayer gives up its icons (which FilePreview imported from it), Waveform, SeekBar and the remembered volume. NewPlaylistForm, a button that opens a modal holding the form, is NewPlaylistButton now, and Thumbnail, ThumbnailPlaceholder, FilePreview and RichContentCard use named exports like everything else. The tests are split one file per component under src/test/components/<folder>/ (and src/test/pages/index/), the same 625 of them. No behaviour changes; the catalogues only move their source references.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

README.md

@@ -125,9 +125,22 @@ api/
 src/               # React frontend (Vite)
   config/          # API base URL, validation constants, feed tabs, upload limits
   pages/           # Route-level components
-    index/         # Feed views (hot, new, followed, journal)
-  components/      # Shared UI components
+    index/         # Feed views (hot, new, followed, journal), feed tab bar, presence row
+  components/      # Shared UI components, by feature
+    category/      # Category picker, switcher and manager
+    chat/          # The chat modal and its message rows
+    comment/       # Comment threads, nodes and forms
+    dump/          # Dump cards, rich-content and file previews
+      create/      # The three-step new-dump modal
+    editor/        # Text editor, emoji picker, mentions, Markdown
     form/          # Reusable form controls
+    layout/        # Header, page shell, floating buttons
+    player/        # Media player, global player, seek bar, waveform
+    playlist/      # Playlist cards, creation and membership
+    profile/       # Profile subpage header, password change
+    social/        # Vote, like and follow buttons, who-voted popover
+    ui/            # Generic pieces: modal, tooltip, tabs, avatar, thumbnails
+  test/            # Frontend tests (Vitest), mirroring src/
   contexts/        # Auth, WebSocket, player, follows, theme
   hooks/           # Data fetching and UI hooks
   utils/           # Formatting, URL, hot-score, waveform, … helpers