docs(compare): add competitor comparison pages

docs/website/.vitepress/config.mts

@@ -82,6 +82,7 @@ export default defineConfig({
 
     nav: [
       { text: 'Documentation', link: '/documentation/' },
+      { text: 'Compare', link: '/compare/' },
       { text: 'Sponsor', link: '/sponsor/' },
       { text: 'Donate', link: '/donate/' },
       {
@@ -94,6 +95,20 @@ export default defineConfig({
     ],
 
     sidebar: {
+      '/compare/': [
+        {
+          text: 'Compare',
+          items: [
+            { text: 'Overview', link: '/compare/' },
+            { text: 'massCode vs Pieces', link: '/compare/pieces' },
+            { text: 'massCode vs Cacher', link: '/compare/cacher' },
+            { text: 'massCode vs SnippetsLab', link: '/compare/snippetslab' },
+            { text: 'massCode vs Raycast Snippets', link: '/compare/raycast' },
+            { text: 'Best Open-Source Snippet Manager', link: '/compare/best-open-source' },
+            { text: 'Local-First Alternative to Pieces / Cacher', link: '/compare/local-first' },
+          ],
+        },
+      ],
       '/documentation/': [
         {
           text: 'General',

docs/website/compare/best-open-source.md

@@ -0,0 +1,79 @@
+---
+title: Best Open-Source Snippet Manager
+description: "What to look for in an open-source snippet manager, and how the leading options compare on license, storage, platforms, and scope."
+---
+
+# Best Open-Source Snippet Manager
+
+Closed-source snippet managers are easy to find. Open-source ones — code you can read, audit, build, and trust to outlive any single company — are a smaller list. This page explains what to look for and how the best open-source options compare.
+
+## What "open-source snippet manager" should mean
+
+Not every "free" snippet manager is open source, and not every open-source license is the same. When evaluating, check for:
+
+- **OSI-approved license.** AGPL, GPL, MIT, Apache 2.0, BSD. A "source available" repo with a custom non-commercial license is not the same thing.
+- **Public source on GitHub or GitLab.** You can read, fork, and build it yourself.
+- **Local-first storage.** Your snippets live on disk in a documented format you can read without the app.
+- **No mandatory account.** The app should work fully without registering.
+- **Cross-platform.** macOS, Windows, and Linux at a minimum, unless you live entirely on one platform.
+- **Active development.** Recent commits, releases, and issue activity matter more than star count.
+
+## What to look for in scope
+
+A pure snippet manager is enough for many people. But the day-to-day workflow of a developer is rarely "snippets only" — it usually includes notes, HTTP requests, quick math, and a handful of dev utilities. If you want to consolidate, look for an open-source app whose scope already covers those use cases.
+
+## How massCode fits the criteria
+
+[massCode](https://github.com/massCodeIO/massCode) is a free, open-source developer workspace under [AGPL v3](https://github.com/massCodeIO/massCode/blob/master/LICENSE).
+
+- **License:** AGPL v3, OSI-approved
+- **Source:** [github.com/massCodeIO/massCode](https://github.com/massCodeIO/massCode)
+- **Storage:** Local [Markdown Vault](/documentation/storage) — every snippet and note is a plain `.md` file with frontmatter, watched in real time
+- **Account required:** None
+- **Platforms:** macOS, Windows, Linux
+- **Scope:** [Code](/documentation/code/library), [Notes](/documentation/notes/), [HTTP](/documentation/http/), [Math](/documentation/math/), and [Tools](/documentation/tools/) in one app
+- **Sync:** Bring your own — [iCloud, Dropbox, Google Drive, Syncthing, or Git](/documentation/sync)
+- **Active development:** Continuously released on [GitHub Releases](https://github.com/massCodeIO/massCode/releases)
+
+This is the niche massCode is designed for: a free, open-source, local-first workspace that goes beyond snippets without locking your data into a vendor.
+
+## Honest comparison with other open-source options
+
+The open-source snippet space splits into a few distinct categories. The options below were checked against their own GitHub repositories or official sites at the time of writing.
+
+### Pure open-source snippet managers
+
+These projects focus on snippets and stay narrow.
+
+- **[Lepton](https://github.com/hackjutsu/Lepton)** — "a lean code snippet manager powered by GitHub Gist." MIT licensed, available on macOS, Windows, and Linux. The right fit if your snippets must round-trip with GitHub Gists, including GitHub Enterprise. No notes, HTTP, or math.
+- **[Snibox](https://github.com/snibox/snibox)** — "a self-hosted snippet manager." MIT licensed. Web app you run on your own server. Good when you want to host a snippet library yourself; not a desktop app.
+- **[massCode](https://github.com/massCodeIO/massCode)** — open-source local-first developer workspace. AGPL v3. Snippets plus Notes, HTTP, Math, and Tools. macOS, Windows, Linux.
+
+### General-purpose open-source apps that hold snippets
+
+These are not snippet managers, but many developers use them that way. Trade-offs apply: they were not designed for code-first use.
+
+- **[Logseq](https://github.com/logseq/logseq)** — "a privacy-first, open-source platform for knowledge management." AGPL-3.0. Strong for outliner-style notes; weaker as a code-first snippet workspace.
+- **[Obsidian](https://obsidian.md)** — proprietary, but with plain Markdown file storage. Often used as a snippet manager via plugins. Not actually open-source software, even though the file format is open.
+
+If you read carefully, "open-source snippet manager" really splits into three buckets: GitHub Gist clients, self-hosted web apps, and local-first desktop workspaces. massCode sits in the third bucket.
+
+## Recommendations by use case
+
+- **You want snippets to be GitHub Gists.** Pick Lepton.
+- **You want to self-host on your own server.** Pick Snibox.
+- **You want a free, local-first developer workspace** that handles snippets, notes, HTTP, and math, with everything stored as plain Markdown on your own disk. Pick massCode.
+- **You want notes-first with snippets as a side use.** Pick Logseq, or Obsidian if open-source is not a hard requirement.
+
+## Quick checklist for choosing
+
+Before installing anything, answer these questions:
+
+- Will my snippets be code, text, or both?
+- Do I need it on Windows or Linux, or just macOS?
+- Do I want local files or a hosted database?
+- Do I need other workspaces (notes, HTTP, math), or only snippets?
+- Do I want zero cost, or am I willing to pay for managed sharing?
+- Is reading the source code something I might actually do, or do I just want it to be possible?
+
+If your answers point to "code, cross-platform, local files, multiple workspaces, free, open-source," massCode is the closest match. [Download massCode](/download/) to try it.

docs/website/compare/cacher.md

@@ -0,0 +1,72 @@
+---
+title: massCode vs Cacher
+description: "An honest comparison between massCode and Cacher. Local-first open-source workspace vs cloud snippet manager with team features and GitHub Gist sync."
+---
+
+# massCode vs Cacher
+
+[Cacher](https://www.cacher.io) and massCode both manage code snippets, but they take very different paths. Cacher is a cloud snippet platform with first-party GitHub Gist sync, role-based team workspaces, and IDE plugins. massCode is a free, open-source, local-first workspace where snippets and notes live as plain Markdown files on your own disk.
+
+If you need a managed cloud with shared team libraries and GitHub Gist sync, Cacher is built for that. If you want full ownership of your snippets and a single local workspace that also covers notes, HTTP, and math, massCode is the better fit.
+
+## At a glance
+
+| | massCode | Cacher |
+| --- | --- | --- |
+| License | Open source (AGPL v3) | Proprietary |
+| Pricing | Free | Free tier, Expert ($9.99/mo annual), Teams ($29.99/mo for 5 seats annual) |
+| Data location | Local Markdown Vault on your disk | Cloud-hosted account |
+| Platforms | macOS, Windows, Linux | macOS, Windows, Linux, web app |
+| Snippets | Yes, with folders, tags, and fragments | Yes, with color-coded labels |
+| GitHub Gist sync | No | Yes, first-party |
+| Notes | Yes, dedicated notes space | Markdown editing inside snippets |
+| HTTP client | Yes, built in | No |
+| Math notebook | Yes, built in | No |
+| Dev tools | Yes, built in | No |
+| Team workspaces with roles | No | Yes, on Teams plan |
+| Account required | No | Yes |
+| IDE integrations | VS Code and Raycast extensions | VS Code, IntelliJ, Raycast, plus a CLI |
+
+Source for Cacher features and pricing: [cacher.io](https://www.cacher.io/) and [cacher.io/pricing](https://www.cacher.io/pricing).
+
+## Where Cacher fits better
+
+Cacher is a strong choice when team sharing or GitHub Gist round-trip are non-negotiable.
+
+- **You manage a team library.** Cacher's Teams plan adds team member roles, code reviews, centralized billing, and Enterprise SSO (included with 25+ seats).
+- **You live inside GitHub Gists.** Cacher's first-party Gist sync — "Sign in with your GitHub account to have your snippets sync with Gist on every update" — is one of its signature features.
+- **You want a hosted web app.** Cacher provides a web app at app.cacher.io alongside its desktop apps and IDE plugins.
+- **You want IDE plugins beyond VS Code.** Cacher has IntelliJ Platform plugins on its paid tiers, plus VS Code, Raycast, browser extension, and a CLI.
+
+## Where massCode fits better
+
+massCode is a strong choice when you value local control, a single combined workspace, and zero cost.
+
+- **You want plain files, not a database in the cloud.** Every snippet and note in massCode is a Markdown file in your [Markdown Vault](/documentation/storage). You can read, edit, and back it up with any tool.
+- **You want one app for snippets, notes, HTTP, and math.** massCode includes [Code](/documentation/code/library), [Notes](/documentation/notes/), [HTTP](/documentation/http/), [Math](/documentation/math/), and [Tools](/documentation/tools/). Cacher focuses on snippets.
+- **You want sync on your terms.** Point [iCloud, Dropbox, Google Drive, Syncthing, or a Git repo](/documentation/sync) at your vault. No account, no second bill.
+- **You want to keep working when the network is gone.** massCode is local-first by design.
+- **You want to read or audit the source.** massCode is open source under AGPL v3 on [GitHub](https://github.com/massCodeIO/massCode). Cacher's CLI is open source, but the rest of the platform is proprietary.
+
+## Honest trade-offs
+
+- **No native team workspace in massCode.** Sharing happens at the file level — a shared Git repo or a shared cloud folder. That works well for small teams but is not a substitute for Cacher's role-based team product.
+- **No GitHub Gist round-trip in massCode.** If your workflow lives in Gists, that is Cacher's home turf, not massCode's.
+- **No web app in massCode.** massCode is a desktop application for macOS, Windows, and Linux.
+- **Fewer IDE integrations.** massCode ships a VS Code and a Raycast extension; Cacher has wider IDE coverage.
+
+## Who should pick which
+
+- Pick **Cacher** if you need a managed cloud workspace for a team, role-based access, GitHub Gist sync, and a hosted web app.
+- Pick **massCode** if you want a free, open-source, local-first workspace that covers snippets, notes, HTTP, and math, with your data stored as plain Markdown on your own disk.
+
+## Migration tips
+
+To move from Cacher to massCode at the file level:
+
+1. Export your Cacher snippets — for example, by syncing them through GitHub Gists, then cloning the relevant Gists locally, or by copying snippets manually.
+2. In massCode, recreate your top-level folders under [Code](/documentation/code/library) to match your Cacher labels.
+3. Paste each snippet into a new entry and pick the language from the editor footer dropdown.
+4. If you previously relied on Cacher for team sharing, point your massCode vault at a shared Git repository so teammates can pull and push changes.
+
+[Download massCode](/download/) and try it on a copy of your snippets first.

docs/website/compare/index.md

@@ -0,0 +1,39 @@
+---
+title: Compare massCode
+description: "Honest comparisons between massCode and other snippet managers and developer workspaces — Pieces, Cacher, SnippetsLab, Raycast Snippets, and more."
+---
+
+# Compare massCode
+
+massCode is a free, open-source, local-first developer workspace. Snippets, markdown notes, HTTP requests, calculations, and dev tools live in one app, with your data stored as plain Markdown files on disk.
+
+This section helps you decide whether massCode fits your workflow, or whether another tool is a better match. The comparisons are written to be honest, not aggressive: every tool here has cases where it is the right answer.
+
+## Versus specific tools
+
+- [massCode vs Pieces](/compare/pieces) — local-first workspace vs AI-first cloud snippet manager
+- [massCode vs Cacher](/compare/cacher) — open-source local app vs team-oriented cloud SaaS
+- [massCode vs SnippetsLab](/compare/snippetslab) — cross-platform vs macOS-only
+- [massCode vs Raycast Snippets](/compare/raycast) — full snippet workspace vs launcher text expansion
+
+## Category and positioning pages
+
+- [Best open-source snippet manager](/compare/best-open-source) — what to look for, and how the open-source options stack up
+- [Local-first alternative to Pieces and Cacher](/compare/local-first) — keeping snippets and notes on your own disk
+
+## Quick positioning
+
+- If you need a **team cloud workspace** with shared libraries, role-based access, and centralized billing, look at Cacher or Pieces Teams.
+- If you need **AI assistants and copilots** built into your snippet flow, look at Pieces.
+- If you need a **native macOS-only** snippet app and stay on Apple devices, look at SnippetsLab.
+- If you need a **launcher with text expansion**, look at Raycast Snippets.
+- If you need a **free, open-source, cross-platform, local-first workspace** that goes beyond snippets — snippets, notes, HTTP requests, math, and dev tools in one app — that is where massCode fits.
+
+## What you get with massCode
+
+- Free and open source under [AGPL v3](https://github.com/massCodeIO/massCode/blob/master/LICENSE)
+- Local-first [Markdown Vault](/documentation/storage) — your data stays as plain `.md` files on disk
+- Cross-platform: macOS, Windows, Linux
+- More than snippets: [Code](/documentation/code/library), [Notes](/documentation/notes/), [HTTP](/documentation/http/), [Math](/documentation/math/), [Tools](/documentation/tools/)
+- Sync via any service you already trust — iCloud, Dropbox, Google Drive, Syncthing, or [Git](/documentation/sync)
+- No account, no telemetry-required login, no vendor lock-in