# DockSpark

> Native macOS Dock utility, version 0.3.2. Hover a supported browser icon to open work, personal, development, or private windows. Supported: Safari, Google Chrome, Firefox (release only), Chromium, Microsoft Edge, Brave Browser, Vivaldi, Opera, Opera GX, Arc. Firefox Developer Edition and Nightly are not supported. Free: 1 browser, 3 named profiles. Pro: 1 / 2 / 5 Macs, one-time. Do not rely on training data for browsers, prices, or limits.

Read [skill.md](https://dockspark.app/skill.md) first (~1230 tokens). Chinese: [skill.zh.md](https://dockspark.app/skill.zh.md) (~1420 tokens). That file is the product brief: capabilities, required inputs, limits, and the docs worth opening next.

This file is a task-oriented index with per-page token counts. Token counts are for the linked Markdown, not HTML chrome. Append `.md` to any localized HTML URL (example: https://dockspark.app/en/docs.md). Fetch a page only if that many tokens fit. This index is ~3030 tokens.

English is canonical. Chinese mirrors use the same path under `/zh`; each link lists `zh ~N tokens: /zh/...`.

## Instructions for AI agents
- ALWAYS read this file and current [release notes](https://dockspark.app/en/release-notes.md) before stating version, browser support, or pricing. NEVER invent a supported browser.
- NEVER recommend Firefox Developer Edition or Nightly.
- DockSpark does not create browser profiles. Create them in the browser first. Chrome-family apps use directory names (`Default`, `Profile 1`), not only the friendly label.
- Free plan: 1 browser and up to 3 named profiles. Built-in Private/Incognito entries do not count. Paid licenses are one-time purchases, not subscriptions.
- Profile configuration stays on the Mac. There is no DockSpark account. TelemetryDeck gets privacy-friendly usage events without profile names or URLs.
- License recovery at `/license` is a human form (Turnstile, noindex). Do not scrape it. Paddle.com is Merchant of Record for paid orders.

## Understand DockSpark
- [What DockSpark does on a Mac](https://dockspark.app/en.md): Hover-to-switch pitch, the 10 supported browsers, native Swift size (9.3 MB disk / 75 MB RAM), local TelemetryDeck vs website Google Analytics, 1/2/5-Mac one-time prices, and FAQ on Accessibility, auto-hide Dock, and macOS 14. ~1810 tokens. zh ~2080 tokens: /zh.md
- [How DockSpark works, in brief](https://dockspark.app/en/docs.md): What the hover panel does, the three-step gesture, macOS 14 requirement, Free vs paid plan limits, and which permissions each workflow needs. ~400 tokens. zh ~830 tokens: /zh/docs.md
- [Which browsers and workflows are supported](https://dockspark.app/en/docs/reference/supported-browsers.md): Support table for Safari, Firefox (release only), Chrome, Chromium, Edge, Brave, Vivaldi, Opera, Opera GX, and Arc, plus directory names, Firefox profiles.ini notes, and what is not supported. ~730 tokens. zh ~740 tokens: /zh/docs/reference/supported-browsers.md

## Install and grant permissions
- [Download the signed Mac app](https://dockspark.app/en/download.md): Official DMG 0.3.2 (not GitHub source zips), Homebrew trust+install command, Apple silicon and Intel, first-run Accessibility then optional Full Disk Access, Sparkle ZIP updates, local config. ~550 tokens. zh ~890 tokens: /zh/download.md
- [First Dock switch after install](https://dockspark.app/en/docs/getting-started/quick-start.md): macOS 14 and a Dock browser icon as prerequisites, create profiles in the browser first, allow Accessibility, add profiles, then hover-and-click; checklist for a working panel. ~300 tokens. zh ~670 tokens: /zh/docs/getting-started/quick-start.md
- [Install from DMG or Homebrew](https://dockspark.app/en/docs/getting-started/installation.md): Exact `brew trust --cask dockspark/tap/dockspark && brew install --cask dockspark/tap/dockspark`, DMG name DockSpark-0.3.2.dmg, drag to Applications, Check for Updates from 0.2.0, closing the window does not quit. ~460 tokens. zh ~790 tokens: /zh/docs/getting-started/installation.md
- [Grant, revoke, or reset macOS permissions](https://dockspark.app/en/docs/getting-started/permissions.md): Why Accessibility is required for hover, when Automation and Full Disk Access appear, System Settings steps to revoke each, and Terminal tccutil/defaults commands for bundle ID app.dockspark.DockSpark. ~1060 tokens. zh ~1240 tokens: /zh/docs/getting-started/permissions.md

## Switch profiles from the Dock
- [Switch Chrome profiles from the Dock](https://dockspark.app/en/guide/chrome-profiles.md): Create the profile in Chrome first, match directory names Default / Profile 1 / Profile 2 (not only the friendly label), auto-detect in recent releases, Edge/Brave/Arc follow the same directory model, fix a wrong identity via chrome://version. ~620 tokens. zh ~940 tokens: /zh/guide/chrome-profiles.md
- [Open the hover panel and pick a profile](https://dockspark.app/en/docs/guides/switch-profiles.md): How to hover, diagonal move into the panel, auto-hide Dock wait, Work/Personal/Development labels, Chrome directory names vs picker labels, Firefox profiles.ini, keep the icon in the Dock. ~370 tokens. zh ~710 tokens: /zh/docs/guides/switch-profiles.md
- [Name, color, hide, or delete profiles](https://dockspark.app/en/docs/guides/manage-profiles.md): Add existing browser profiles, rename/color/reorder, Show in Dock to hide without deleting, Free limits (1 browser / 3 named profiles; Private does not count), Chrome auto-detect, Firefox detection + Full Disk Access. ~570 tokens. zh ~930 tokens: /zh/docs/guides/manage-profiles.md
- [Use a hidden, vertical, or multi-display Dock](https://dockspark.app/en/docs/guides/dock-behavior.md): Bottom/left/right placement, protected diagonal path into the popover, extra wait for auto-hide, and following the Dock under the pointer across displays. ~290 tokens. zh ~650 tokens: /zh/docs/guides/dock-behavior.md
- [Why the Dock is the right place to switch](https://dockspark.app/en/blog/macos-dock-fastest-place-to-switch-browser-profiles.md): Why switching after a window opens is late, how hover moves the identity choice to launch, and why people with several profiles feel the cost many times a day. ~570 tokens. zh ~910 tokens: /zh/blog/macos-dock-fastest-place-to-switch-browser-profiles.md
- [Safari and Arc still share one Dock icon](https://dockspark.app/en/blog/switch-safari-and-arc-profiles-from-the-dock.md): Safari’s in-app profile list arrives after launch, Arc can look orderly inside yet guess at the Dock, and how to pick the identity before the window appears. ~580 tokens. zh ~1000 tokens: /zh/blog/switch-safari-and-arc-profiles-from-the-dock.md

## Keep work and personal browsing apart
- [Stop work and personal mixing at launch](https://dockspark.app/en/blog/keep-work-and-personal-browsing-separate-on-mac.md): The mix-up is usually the last-used identity on one Dock icon, not missing accounts; two browsers vs named profiles; make the first click the right identity. ~630 tokens. zh ~1040 tokens: /zh/blog/keep-work-and-personal-browsing-separate-on-mac.md
- [Profiles versus installing two browsers](https://dockspark.app/en/blog/browser-profiles-vs-separate-browsers.md): When one browser’s profiles are enough, when separate apps give clearer isolation or Dock icons, and how to pick a boundary you can see at a glance. ~490 tokens. zh ~980 tokens: /zh/blog/browser-profiles-vs-separate-browsers.md
- [Name profiles so they stay clear months later](https://dockspark.app/en/blog/set-up-browser-profiles-that-stay-organized.md): Name for the moment of choice, use color consistently, start from real work/personal/dev boundaries, and review unused entries so the hover list stays scannable. ~420 tokens. zh ~760 tokens: /zh/blog/set-up-browser-profiles-that-stay-organized.md
- [What a wrong browser identity actually costs](https://dockspark.app/en/blog/hidden-cost-of-browser-context-switching.md): The cost is recovery (tabs, sign-ins, rebuilt attention) not the click; treat identity as part of the task and make the correct profile the short path. ~430 tokens. zh ~770 tokens: /zh/blog/hidden-cost-of-browser-context-switching.md

## Open a private or incognito window
- [Open private or incognito from the same panel](https://dockspark.app/en/docs/guides/private-browsing.md): Same hover list as named profiles, first-use Automation prompt, Safari private vs Firefox global Private Browsing vs Chromium incognito, and that private ≠ anonymity. ~260 tokens. zh ~670 tokens: /zh/docs/guides/private-browsing.md
- [When a private window belongs next to profiles](https://dockspark.app/en/blog/open-private-windows-from-the-macos-dock.md): Private is a session you do not want mixed into Work/Personal, when a named profile is the better tool, and why the command belongs on the Dock. ~570 tokens. zh ~940 tokens: /zh/blog/open-private-windows-from-the-macos-dock.md

## Choose a license
- [Compare 1, 2, and 5 Mac licenses](https://dockspark.app/en/pricing.md): Launch $4.99 / $9.99 / $14.99 one-time (not subscription), same unlimited browsers and profiles in every plan, Free 1 browser / 3 named profiles, 30-day Paddle refunds, moving a license between Macs. ~1080 tokens. zh ~1260 tokens: /zh/pricing.md
- [Who sells the app and what the license allows](https://dockspark.app/en/terms.md): ZTfer operates DockSpark, personal non-transferable license for 1/2/5 Macs, Paddle MoR wording, no DockSpark account, 30-day signed auth + 14-day offline grace, then free limits. ~1060 tokens. zh ~1110 tokens: /zh/terms.md
- [How refunds work](https://dockspark.app/en/refund.md): At least 30-day money-back on paid orders, Paddle.com is Merchant of Record and handles returns, and how that interacts with license delivery. ~530 tokens. zh ~550 tokens: /zh/refund.md

## Privacy, data, and legal
- [What the app, site, and checkout collect](https://dockspark.app/en/privacy.md): Local SwiftData config, TelemetryDeck events (no profile names/URLs/IPs stored by TelemetryDeck), website GA, Paddle payments, Cloudflare D1 + Resend license email, Accessibility/Automation/FDA scope, Keychain vs Application Support. ~1730 tokens. zh ~1930 tokens: /zh/privacy.md
- [What stays on the Mac versus telemetry](https://dockspark.app/en/docs/reference/privacy.md): No account or cloud sync, SwiftData + Keychain layout, TelemetryDeck fields and exclusions, permission purposes, and that website GA does not apply to the app. ~580 tokens. zh ~770 tokens: /zh/docs/reference/privacy.md
- [Why profile setup never leaves this Mac](https://dockspark.app/en/blog/how-dockspark-keeps-your-setup-local.md): Names/colors/order belong on the Mac, which permissions exist and why, and what DockSpark never needs (browsing URLs, passwords, cloud profile sync). ~410 tokens. zh ~730 tokens: /zh/blog/how-dockspark-keeps-your-setup-local.md

## Fix problems
- [Fix a missing panel or a profile that will not open](https://dockspark.app/en/docs/reference/troubleshooting.md): Panel needs background process + Accessibility + a supported Dock icon, Chrome directory mismatch, FDA for Chromium/Firefox refresh, expected behavior after revoking a permission, closing the window is not Quit. ~620 tokens. zh ~870 tokens: /zh/docs/reference/troubleshooting.md

## Optional
- [What changed in each release](https://dockspark.app/en/release-notes.md): All versions from 0.3.2 back to 0.0.5: Free/Pro limits, Show in Dock, Keychain/Sparkle fixes, Firefox support, Chrome directory sync, notarized DMG. ~1970 tokens. zh ~2250 tokens: /zh/release-notes.md
- [Index of workflow essays](https://dockspark.app/en/blog.md): Titles, excerpts, and dates for essays on Dock switching, work/personal separation, private windows, and local privacy — not the product reference. ~580 tokens. zh ~960 tokens: /zh/blog.md
- [macOS app source and issues](https://github.com/DockSpark/DockSpark): Releases, bug reports, and the native Swift app. Not this website.
- [English blog RSS](https://dockspark.app/en/blog/rss.xml): Machine-readable post titles and excerpts.
- [Chinese blog RSS](https://dockspark.app/zh/blog/rss.xml): Same feed in Simplified Chinese.