Goalmatic Source Sync for VS Code

Open a Goalmatic site in VS Code with one click, edit it with a real offline localhost preview, checkpoint every change in Git, and update the online draft without copying credentials.

One-click workflow

1. In Goalmatic, open a project and choose Source Sync → Open in VS Code.
2. VS Code exchanges the five-minute, single-use link for a site-scoped 90-day session stored in SecretStorage. No Firebase or browser API key is copied to the extension.
3. The extension creates or clones ~/Desktop/Goalmatic/<project> by default, pulls the draft, adds agent guidance, initializes local Git, opens the folder, installs the pinned project runtime, and starts the localhost preview. Choose Goalmatic: Choose Project Location to use Downloads or another parent folder.
4. Trust the chosen parent once. VS Code lets its project subfolders inherit that trust; Restricted Mode remains enabled for folders you have not approved.
5. Edit files. A normal package.json, Vite, Vue, Tailwind CSS v4, npm run dev, editable goalmatic.seo.json, and asset manifest are included. The extension falls back to its bundled, no-iframe offline renderer if npm is unavailable.
6. Open the Goalmatic Activity Bar icon and choose Commit & Push Changes. One action creates a local Git commit and updates the Goalmatic draft, online editor, and hosted preview.
7. Use Pull Site Source for online changes, Push Local Git Branch for a configured remote, and Publish Draft only when production should move.

If the same file changed both locally and online, the pull opens Resolve Goalmatic Conflicts instead of failing. Compare both versions side by side, keep the local file, use the online file, or open VS Code's native diff and edit a combined local result. The session survives restarts, replaced files are backed up, and local results remain clearly queued to push.

Goalmatic sidebar

The native sidebar shows:

• direct local-preview state;
• expandable Goalmatic source changes with read-only baseline comparisons;
• persistent source conflicts with per-file resolution progress;
• current Git branch, working tree, and last commit;
• GitHub repository and sync mode;
• draft baseline and last pull.
• Workspace Trust, exact local path, dependency/runtime readiness, SEO, assets, and the last operation result.

Clicking a row now opens the relevant workflow: preview opens localhost, Git opens Source Control, GitHub opens the repository or setup, and each changed file opens a read-only diff. The toolbar provides push, pull, preview, online editor, hosted preview, Source Sync settings, Git remote push, refresh, and explicit publish actions.

Safe by default

• The opaque, site-scoped session stays in VS Code SecretStorage and live site access is rechecked by the server on every request.
• .goalmatic/, dependencies, build output, binary files, and secret-like files never enter source sync.
• Non-overlapping changes merge automatically; genuine same-file conflicts pause in a persistent resolver and never overwrite a choice silently.
• Replaced and remotely deleted files are recoverable from Git, .goalmatic/trash, and the conflict archive.
• Existing AGENTS.md, README.md, and Copilot instructions are never overwritten.
• Dependency installation only runs in a trusted workspace and uses npm install --ignore-scripts.
• Binary assets are copied locally for offline work, uploaded through a short-lived signed URL, and recorded in assets/goalmatic-assets.json; credentials never enter the project.
• Publishing is separate from saving and syncing.

Development

npm install
npm run compile
npm run package

Open this extension folder in VS Code and press F5 to launch an Extension Development Host.