documentation-structure.md

ExtraDock Documentation Map

This repository is a user-facing feature guide for ExtraDock. It explains what users can do, where to find each feature, which permissions are required, and how settings behave.

It is not a technical code reference.

Getting Started

Page	Covers
Introduction	What ExtraDock is, who it is for, and core concepts
Installation	Requirements, setup, first launch, license, permissions
Quick Start	Create a dock, add items, add widgets, try core actions
Permissions	Accessibility, Screen Recording, file access, Native Trash
Dock Replacement	How to replace the native macOS Dock with ExtraDock

Managing Docks

Page	Covers
Creating & Managing Docks	Add, rename, duplicate, share, remove, hide docks
Management Window	Dock list, Properties tab, Items tab, Share Dock
Menu Bar	Status item, per-dock quick controls, license/update actions
Import / Export	Full backup, import wizard, automatic backups, DockShare packages
DockShare	Share-safe dock publishing and shared dock import flow

Position & Layout

Page	Covers
Floating Mode	Free placement, drag handle, position lock
Fixed Mode	Pinned edges, full width, alignment, edge padding, space from edges
Orientation	Horizontal and vertical docks
Snap to Edges	Magnetic snapping and disabling it
Multi-Monitor	Allowed screens, reconnect behavior, forgetting screens
Reserve Dock Space	Keep expanded app windows outside fixed dock areas

Visibility & Behavior

Page	Covers
Auto-Hide	Hide and reveal delays
Collapse Mode	Collapse directions, hover to expand, button customization
Fullscreen Detection	Hide docks when fullscreen apps are active
Desktop Widget Mode	Keep a dock behind app windows

Apps & Items

Page	Covers
Adding Apps, Folders & Files	Drag/drop and Add Item flows
Rearranging & Removing	Reorder, remove, bulk management
App Actions	Open, hide, quit, reveal, configure, remove
Drag & Drop onto Items	Drop files onto apps or folders
Running App Indicators	Running-state dots
Notification Settings	Badge opt-in, full number display, per-app overrides
Folder & File Display	Folder labels, hover labels, tint, file extensions, open-with

Widgets

Page	Covers
Widgets	Overview and entry points
Spacer Widget	Layout spacing presets and custom size
Divider Widget	Separator line and side spacing
URL Widget	URLs, favicons, SF Symbols, custom icon URL/file
Finder Widget	Finder locations and behavior
Folder Stack	Multiple source folders, list/grid, icon/name customization
Trash Widget	ExtraDock Trash and Native Trash
Shelf	Personal Shelf, copy/move, persistence, max items
Clock Widget	Time/date/timezone, themes, fonts, click action
IP Address Widget	Public IP display, refresh, copy
Live Dock	Running Apps and Full Dock modes
Space Awareness	Current Space apps, Accessibility, hidden items
TamaDocky	Pet name, size, Simple/Tamagotchi mode
Stripe Balance Widget	Stripe setup, gross/net, date ranges, refresh/cache

Appearance

Page	Covers
Icon Size & Color	Icon size, app spacing, accent color
Background	Blur/solid background, intensity, opacity
Border	Border toggle, width, color
Custom Icons	Change icons, import from URL/file, supported formats
Icon Library	Manage imported icons

Automation

Page	Covers
Hotkeys	Per-dock global keyboard shortcuts
macOS Shortcuts & Focus	Show/hide/toggle/list docks, Focus Filters

Settings & Account

Page	Covers
General Settings	Startup, app mode, native Dock suppression, error reports
Behavior Settings	Left click behavior, folder opener, snapping, Reserve Dock Space
App Previews	Beta hover previews, permissions, filters, display, timing
Integrations	Stripe setup and key management
License	License key, team activation, statuses, removal
Updates	Sparkle updates, current version/build
Privacy & Diagnostics	Error reports, backups, DockShare, Stripe

Effects

Page	Covers
Effects	Snow, Rays, Fireworks

Notes

• Keep feature-flagged items clearly marked as conditional.
• Avoid implementation details unless they explain permissions, privacy, data flow, or user-visible limitations.
• Prefer short task-led sections over long conceptual explanations.