Repository navigation
Releases
Junction 2.1.4
Desktop
- The library download says what it is fetching, how much of the whole it
has and how long it still takes ("Downloading symbols: 21 of 61 MB, about
40 s left"), short enough to read in the editors' status bar too. - No more "Error loading library ... not found" warnings for standard
libraries that are not on the computer yet: while they can be downloaded
or are downloading nothing is reported, and warnings shown before are
cleared when the download starts and when it ends. The symbols and
footprints are downloaded first, the project templates last. - A 3D model fetched for the viewer is kept for good: it is saved into the
library folder on this computer (3dmodels/.3dshapes, beside the
downloaded symbols and footprints), so it is downloaded once and is there
for every project afterwards. Models fetched by earlier versions are moved
over the first time they are used. - The editors' status bar gives a background job's text room for a full
line, so the download progress is readable there too. - Downloaded standard libraries are also registered when the library table
already lists libraries of your own (they are added beside them). - A "download again" that is cut short continues at the next start, like a
first download.
Downloads
| Platform | File | Notes |
|---|---|---|
| macOS (Apple Silicon, macOS 15+) | Junction-2.1.4-macos.dmg |
Ad-hoc signed: first launch is right-click, Open. Replace the old app in Applications. |
| Windows x64 | Junction-2.1.4-windows-x64.exe |
Installer; upgrades earlier versions in place. |
| Linux x64 (Ubuntu 24.04 LTS) | Junction-2.1.4-linux-x64.tar.gz |
Extract anywhere, install the packages listed in usr/share/junction/ubuntu-packages.txt (sudo apt install $(cat usr/share/junction/ubuntu-packages.txt)), run usr/bin/junction. |
Junction 2.1.3
Desktop
- Works on a computer with no KiCad installed: when no symbol or footprint
libraries are found, Junction offers to download the standard KiCad
libraries and project templates (about 60 MB) and uses them at once, without a restart.
Preferences, Download Standard Libraries does the same later.
The archives come from the Junction server (checked against their
SHA-256, and continued in the middle of a file after an interruption) and
from the KiCad library repositories when it cannot deliver.
A download cut short by closing Junction, sleep or a lost connection
continues at the next start from what it already has; a failed connection
is retried by itself until it works (waiting up to a minute between
tries).
The download runs in the background, so you keep working while it runs:
the status bar of the project manager and of the editors shows how far it
is, the notifications say when it starts and when the libraries are ready,
and Preferences, Download Standard Libraries shows the progress with Try
Now and Stop Download. Until the download has finished its symbols and
footprints are not in the choosers (the editor says so), and they appear
there by themselves afterwards. - The project manager program itself is named Junction on every system
(Junction inside the Mac app, junction.exe on Windows, Junction on Linux
with a Junction desktop entry and icon), so Activity Monitor, Task Manager
and system messages say Junction instead of kicad. Settings stay where
they were. - Changes an assistant proposes through the MCP server now show in the board
and schematic editors: a bar names the proposal with Show (draws it over the
design), Details, Accept and Reject, and File, Proposed Changes brings it
back. An accepted proposal lands as one edit that undo takes back. - An assistant's highlight shows its note under its name tag.
- A project that came online without its footprint library folders gets them
written back from its boards when it is opened, the way Export Footprints to
Library does, so the rules check no longer warns "footprint not found in
library" for every part. The next sync stores them with the project. - 3D viewer: standard library models that are not on this computer are
fetched several at a time before the board's parts are loaded, instead of
one by one. A cached file that is not a model is fetched again. - Publishing a project that is larger than an online project can hold says so
before anything is sent. - The message that a local copy went to Junction's own data folder has a
button that shows the folder.
Web
- 3D viewer: the parts named in the status line (closest model used, plain
shape) are links that select the part on the board. - Footprint editor, Footprint Properties, 3D Models: Use Closest Library Model
finds the model in KiCad's 3D library that comes closest to the footprint. - Vendor parts: stock and price say which vendor they are from.
- Opening a schematic no longer raises a page error that stopped the other
sheets' nets from being read. - Upload: when a project names libraries or 3D models of its own that were
not among the uploaded files, the upload dialog lists them and takes the
missing files or the project folder to add them. - One file of an online project can now be 200 MB (was 30 MB) and a project
500 MB (was 100 MB). Uploads are written to disk as they arrive instead of
being held in memory. A file or project over the limit is refused before
the upload starts, with its size and the limit; saving a document that
large no longer fails at 50 MB.
Checks
- A "Loads in desktop" run on every server change makes a blank project,
every template, and demo projects downloaded with rebuilt libraries and
after edits, and opens each file with the desktop's own reader.
Downloads
| Platform | File | Notes |
|---|---|---|
| macOS (Apple Silicon, macOS 15+) | Junction-2.1.3-macos.dmg |
Ad-hoc signed: first launch is right-click, Open. Replace the old app in Applications. |
| Windows x64 | Junction-2.1.3-windows-x64.exe |
Installer; upgrades earlier versions in place. |
| Linux x64 (Ubuntu 24.04 LTS) | Junction-2.1.3-linux-x64.tar.gz |
Extract anywhere, install the packages listed in usr/share/junction/ubuntu-packages.txt (sudo apt install $(cat usr/share/junction/ubuntu-packages.txt)), run usr/bin/junction. |
Junction 2.1.0
A desktop update with new features since 2.0.0. It reads and writes the same
files as 2.0.0, so people in a project can update one at a time.
Desktop
- Online Projects is a docked pane in the project manager instead of a modal
dialog: shown by default, toggled from the left toolbar, View > Panels and
File > Online Projects. A This Project card says whether the open project is
local only or synced, with its live session state. - WakaTime: the editors send heartbeats like WakaTime's own plugins, set up in
Preferences > Common > WakaTime. Works with WakaTime, Hackatime, Wakapi or any
WakaTime-API server, reads and keeps~/.wakatime.cfg, and uses wakatime-cli
when it is installed. - Fonts: every Google Font is in the font list and downloads when picked; a
font missing on this computer is fetched while the app runs and the text is
redrawn without a restart. Fonts only you have are shared with the project so
collaborators draw the same letters, and stored glyph outlines are kept on
load and on copy. - Collaborator cursors are bigger, with a filled name tag.
Files
- Saving keeps KiCad 9 and 10 boards and schematics readable by KiCad 9 and 10.
Fixed: boards with a layer stackup were raised to a newer format, KiCad 9
boards were written with nets by name, zones lost their fill thickness flag,
teardrops lost their ids and old plot layer selections were renumbered. - A file stamped by a newer KiCad opens when everything in it is known; an
unknown construct still stops the load, so nothing is dropped silently. - No more notice when an older KiCad file opens, since it is saved back at its
own version.
Web editor and server (already live)
- Many more KiCad dialogs and tools in the browser: Board Setup with an editable
stackup, Zone Manager, Teardrops, Cleanup Graphics, Remove Unused Pads,
Geographical Reannotate, Repair Board, Net Inspector, hierarchy-wide ERC,
inter-sheet references, KiCad's menu bars, mouse and touchpad preferences. - WakaTime heartbeats from the browser editor, GitHub sync through the
"KiCAD Junction" GitHub App, and router and placement improvements for
AI-designed boards.
Packaging
- The macOS DMG is now built in CI with Windows and Linux, and every release
run installs and launches all three builds on clean machines before it
publishes. - The Linux tarball runs from wherever it is extracted (2.0.0 looked for its
libraries and data under /usr), and lists the Ubuntu packages it needs in
usr/share/junction/ubuntu-packages.txt.
Downloads
| Platform | File | Notes |
|---|---|---|
| macOS (Apple Silicon, macOS 15+) | Junction-2.1.0-macos.dmg |
Ad-hoc signed: first launch is right-click, Open. Replace the old app in Applications. |
| Windows x64 | Junction-2.1.0-windows-x64.exe |
Installer; upgrades 2.0.0 or KiCad Collaborative in place. |
| Linux x64 (Ubuntu 24.04 LTS) | Junction-2.1.0-linux-x64.tar.gz |
Extract anywhere, install the packages listed in usr/share/junction/ubuntu-packages.txt (sudo apt install $(cat usr/share/junction/ubuntu-packages.txt)), run usr/bin/junction. |
Symbol and footprint libraries are not bundled; point the library tables at an existing KiCad 10 install.
Junction 2.0.0
First release since 1.0.9. It is a major version because the desktop app is
now built on a much newer KiCad (2782 upstream commits, through 2026-11-10),
so a 2.0 client can write things into a shared project that a 1.0.9 client
cannot read. Everyone in a project should update together. Files you open
still keep the format version they came with unless an edit needs a newer one.
New name
- KiCad Collaborative is now Junction. The app, the installers, the web editor
and the repository (github.com/notaroomba/junction) carry the new name. Your
settings, online projects and the kicad-collab:// links are unchanged. On
macOS the app has a new bundle id, so you sign in once more.
Web editor
- The browser editor went from a viewer to a full editor that follows KiCad's
own tools and dialogs: schematic and board editing, the interactive router
(drag, differential pairs, length tuning), zones and zone fill,
DRC and ERC, custom rules, Properties panel, context menus and hotkeys. - Symbol Editor and Footprint Editor, with library management, the Footprint
Wizard and KiCad library access (Choose Symbol / Choose Footprint). - Fabrication outputs from the browser: Gerbers, drill files, placement, BOM
and plots, checked against kicad-cli on the demo boards. - 3D viewer, SPICE simulation with ngspice, and the Simulation Model Editor.
- Board autorouter (Route > Autoroute) with differential pairs, impedance from
the stackup, length matching, signal domains and ground via fences. - Vendor parts: search LCSC, Mouser and DigiKey and place the symbol and
footprint, with saved part libraries. - Plugins: a Plugin Manager with one catalog for built-in, KiCad and community
plugins, sandboxed and permissioned, including KiCad IPC and Python plugins.
Projects, sharing and history
- Stored online projects with a web home: blank projects, starter templates,
stars, Trash and public projects. - Roles and sharing: a comment-only role, view and comment links that open
without an account, and per-project permissions. - Version history and branches on the server, and a visual compare of versions.
- Design review: comment threads pinned to parts and nets.
- GitHub repository sync for online projects: connect, import, push, pull and
an item-level merge that shows what changed inside each file.
Desktop
- Merged upstream KiCad master. About says "based on KiCad 10".
- Keep working offline and merge when the connection comes back.
- The History panel lists versions and follows them live, and File has
Compare Versions. - Comment threads carry their part or net and their pins follow it.
- Presence carries each selected item's anchor, so a peer's drag is ghosted at
the exact offset. - One folder syncs with one online project.
- Fixed two crashes when a tuning pattern is regenerated.
AI and scripting
- MCP server: any AI model or service that speaks MCP can open, read and edit
your online projects, with consent and the project's roles enforced. - Python harness: design by script (
run_pythonover MCP) with live drawing,
schematic blocks drawn like a datasheet application circuit, board routing,
zones, keepouts and layout checks. - The in-editor chat is gone. An assistant works on a project through MCP.
Packaging
- Windows and Linux builds need glslang, spirv-tools, the Vulkan headers and
SQLite now (upstream's new renderer and database library backend). macOS
also needs spirv-cross.
Downloads
| Platform | File | Notes |
|---|---|---|
| macOS (Apple Silicon) | Junction-2.0.0-macos.dmg |
Ad-hoc signed: first launch is right-click, Open. Needs one new sign-in after updating. |
| Windows x64 | Junction-2.0.0-windows-x64.exe |
Installer; upgrades an existing KiCad Collaborative install in place. |
| Linux x64 (Ubuntu 24.04+) | Junction-2.0.0-linux-x64.tar.gz |
Extract, run usr/bin/junction. |
Symbol and footprint libraries are not bundled; point the library tables at an existing KiCad 10 install.
Junction 1.0.9
Collaboration fixes found by recording two desktop clients editing one schematic.
Sync
- Wires attached to a dragged symbol no longer end up off grid (and disconnected) on the other client.
- Symbols pushed to another client keep their reference and instance; annotation is no longer lost on save.
- Rejoining no longer re-sends every symbol, and a client closed without saving no longer overwrites newer work with its stale file.
- Pins stop showing stale "unconnected" circles after another client's move.
Live preview
- Stretched wires and new bends show their real shape while a peer drags; reshaped wires draw as normal wires.
- Dragged field text moves with its box; multi-selections get one bounding box; a lone selected wire gets a solid band.
- The highlight is a thin outline in the peer's cursor colour, framing only what the peer picked, with no fill.
- The web viewer follows the same highlight rules.
Stability
- Fixed a crash when a captured pointer left the canvas on macOS (stack overflow in the pointer warp).
- Fixed a crash in the peer overlay when a remote edit replaced an item mid-drag.
Junction 1.0.8
Fixes
Crash when closing the symbol chooser with the footprint list dropped down (macOS). Pressing Escape while the footprint drop-down was open closed the whole dialog instead of the list: the key reached the dialog first, the dialog ended with the list still floating over it, and the teardown then hid the list from inside its combo's base-class destructor — at which point the kill-focus that hiding provokes measured rows through a combo that no longer was one, and the editor went down.
Escape now closes an open drop-down first, in every dialog, and a dialog dismisses any open drop-down before it hides, closes or is destroyed, so the teardown never meets an open list again. The footprint combo also takes its own list down while it is still whole, as a last line of defence.
Notes
This is a wxWidgets/macOS interaction in stock KiCad's symbol chooser, not part of the collaboration code; it affected all recent builds.
Junction 1.0.7
Fixes
Crash on reopening a shared project. When the editor joined a live project while it still had edits of its own waiting to be sent, and the server-side merge deleted one of the items those edits touched, the remote deletion was re-asserted over by the local edit (correctly — the local edit is newer), but the item was freed anyway. The very next sheet render walked the freed item and the whole app went down; reopening once more worked, because by then the pending edits had been sent. The applier now frees only what the commit actually removed, exactly once, and the same rule now covers the board editor.
While there, two last-writer-wins rules that the same code got wrong: a property-level edit of an item somebody else deleted no longer keeps the item on this side only (the deletion wins, as it does everywhere else), and a local deletion is no longer undone by an older remote re-add that happened to be staged in the same batch.
Snapshot catch-up applied server ops to the open sheet. The ops folded into a join-time snapshot were resolved through the live document instead of the scratch copy, so they could delete live items behind the canvas's back and then resurrect what the server had removed. They now stay in the scratch copy.
"The checkpoint could not be created." Checkpoints, restores, new comments, resolving comments and registering a new sheet's document all posted JSON without saying so, and the server refused every one of them with 415. The client now labels its JSON bodies, and the server (already deployed) accepts a JSON body whatever its label, so 1.0.6 installs work again too.
Verification
Five new schematic and four new board regression tests drive the real commit path headlessly; each was checked to fail against the corresponding bug (mutation-tested) and the suites pass under a scribbling allocator. Server: four extractor tests.
Junction 1.0.6
Fixes a false alarm introduced in 1.0.5: after the server restarted, the desktop editor could report "Your access to this shared project has been withdrawn" to a user whose access had not changed. Update if you are on 1.0.5.
On reconnect the editor replayed edits it had made while offline a moment before it re-joined the document, and the server's reply to that ordering was indistinguishable from a real revocation. The editor now re-joins first and replays only once the join is confirmed; the server names the transient case distinctly; and an unscoped refusal only counts as a revocation while a join is actually pending. No edits were lost by the old behaviour — they stayed in the local journal and are sent once the join lands.
Also since 1.0.5 (web editor): KiCad's real drawing sheet — frame, tick marks, row/column labels and title block — drawn from KiCad's own sheet definition and verified against KiCad's plotter across sixteen paper sizes; and the toolbars no longer hide buttons that fit.
Junction 1.0.5
Fixes real edits being silently dropped between the browser editor and desktop KiCad. If you use the web editor alongside the desktop app, update.
Edits that were being lost
Position changes travel as property deltas and always worked, which is why sync looked healthy. Anything carrying an s-expression fragment did not:
- Web schematic edits were rejected outright — the fragment was wrapped in a form the desktop's parser has no case for. Board edits were rejected for the mirror-image reason.
- A web footprint edit wiped every pad's net, and web-created groups landed empty.
- The desktop advanced its applied-sequence for ops it had dropped, losing them permanently across a reconnect.
- The web discarded in-flight and offline edits on reconnect; it now journals and replays them.
- Ellipses, net chains, barcodes, points and grid items were dropped by the web reader.
- A single permission error downgraded the web editor to view-only for the rest of the session.
Seeing each other
- Web cursors never appeared on the desktop at all: the desktop only draws a peer that names the sheet it is on, and the web never sent it.
- An idle web user vanished from every participant list after 30 seconds — the web sent no keepalive.
- A web user's selection and drags were invisible on the desktop.
- Selecting more than about a hundred items on the desktop pushed its presence past the server's size cap; the error was swallowed and that user's cursor froze, then disappeared.
Also in this release
Everything from 1.0.4, which this supersedes: a shared session now survives one editor leaving, Copy Share Link works in an auto-rejoined session, and editing a project made by stable KiCad keeps it openable in stable KiCad.
Junction 1.0.4
Built on the KiCad 10.99 development branch, merged with upstream master through 2026-09-04.
Collaboration
- A shared session now survives one editor leaving. Previously either editor's Leave Session dropped the socket underneath the other, which had no way to notice or recover; the connection is released only once no document is still joined.
- Copy Share Link works in an auto-rejoined session. It used to report "No collaboration session" while the same menu showed Leave Session enabled, because the menu and the action read different state. Three separate paths could put those out of step; all are closed, and the menu entries that need a session are now gated on one.
- A failed join can no longer tear down a live session, the Stop/Leave wording follows real ownership again, and a permanent disconnect is noticed instead of leaving Leave Session as the only exit.
- Fixed a use-after-free: the share-link and comment completions could dereference a freed editor frame.
File format versions
- Editing a project made by stable KiCad keeps it openable in stable KiCad. The version stamp a file was opened with is preserved on save, and raised only when the saved bytes genuinely need a newer format — in which case the reason is reported rather than writing a file that claims to be older than it is.
- Covers schematics, boards, symbol libraries and footprints, and the collaboration sync, snapshot and merge paths.
- Set
KICAD_COLLAB_STAMP_VERSIONSto restore stock restamping.
Web editor
- The chrome is now React and TypeScript with Tailwind, laid out like the desktop: KiCad's toolbars, menus, docked panels and status bar.
- Schematic: clipboard interchange with the desktop, annotate, an ERC pass with markers, label conversions, autoplace fields, the Symbol Fields Table, sheets, tables, beziers, images and net highlight.
- Board: connectivity and ratsnest, a DRC pass against the project's own design rules, net inspector, zones, dimensions, pad editing, groups, align and distribute.
- Selection and editing match the desktop: box and lasso select, connected drag with stub wires and bends, property dialogs on double-click, and KiCad's own hit-test ranking.
- Plot to SVG or PNG, and print.
Also
- Merged 238 upstream KiCad commits.
- Fixed a schematic-drag case where moving a symbol left a gap instead of a wire.