2026-10-17 10:49:38 +00:00
|
|
|
|
<script setup lang="ts">
|
|
|
|
|
|
const ed = useEditor()
|
|
|
|
|
|
|
|
|
|
|
|
const SHORTCUTS: [string, string][] = [
|
A settings for every part, overlap-free wiring with crossing styles, accounts with sync
- Clicking anything opens its settings: swap parts in place (wires stay on
matching pins), clock frequency per clock, keyboard keys for switches and
buttons, lamp/display colours, note sizes, component names on the canvas,
position, unlink all wires, unpack a component, make an independent copy.
- Wires of different signals never share a line: auto routes pick free
columns or detours, remaining clashes go on separate lanes. Crossings drawn
as bow, triangle, bridge, gap or plain.
- Accounts (email + scrypt password, httpOnly session) with two-way project
sync and conflict copies; per-account limits; cross-site writes refused.
- Compatibility suite: a project and both browser-storage layouts from
release a241adc must load and compute identically.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-20 11:09:37 +00:00
|
|
|
|
['Click switch', 'Flip an input between 0 and 1 (give it a keyboard key in its settings)'],
|
|
|
|
|
|
['Click anything', 'Its settings appear on the right: swap the part, clock speed, colours, keys, position'],
|
A right panel in tabs, Pins list, bulk editing, transistor breakdown, Settings dialog
- Right panel tabs: Selection, Circuit, Pins, Test. Display and sound
preferences move to a Settings dialog (gear in the top bar).
- Pins tab: every input and output in pin order with live values; rename in
place (Enter goes to the next), number a whole side from a pattern, flag
duplicate names, centre the canvas on a part.
- Several selected parts: narrow by type, swap all, rename all from a
pattern, set switches to 0/1 or flip, shared colour/frequency/size, align
and spread.
- Transistors on every part (NAND 4, switches and lamps 0), NAND 4T in the
palette, and a per-part breakdown of the circuit. Test: the count equals
4 x the gates the simulator builds, for every example and wide gate.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-21 07:29:55 +00:00
|
|
|
|
['Select several', 'Change them all at once: swap, rename D0, D1, …, switch all to 0 or 1, line up'],
|
|
|
|
|
|
['Pins tab (right)', 'Every input and output in one list: rename them one after another with Enter'],
|
A input panels, automatic names, one-by-one wiring, tidy routing, truth table export
- Input panel part: rows of switches, buttons and clocks. "Attach input
panel" docks one to a component with a row per free input; it moves
with the component and follows its pins.
- Copies and new pins continue name series (D0 -> D1, A -> B); unnamed
switches, lamps and pins take the name of the component pin they are
wired to.
- Connecting: target pins are ringed, dropping on a part uses its next
free pin, click-then-click works, and "Connect one by one" (W) wires a
selection's pins in turn.
- Tidy wiring option and "Tidy all wires": sorted, evenly spaced columns
per gap, one trunk per signal, fewer crossings.
- Truth table full screen, CSV download, copy as Markdown, current row
highlighted.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-20 17:17:25 +00:00
|
|
|
|
['Drag from a pin', 'Draw a wire to another pin; dropping it on a part uses that part’s next free pin'],
|
|
|
|
|
|
['Click a pin, then another', 'The same without holding the mouse button'],
|
|
|
|
|
|
['Select parts, then W', 'Connect one by one: click where each of their pins goes, in order (Shift+W: their inputs)'],
|
A component faces, project library with share links, fine-grained wire editing
- Lamps and hex displays inside a component show on its box with their
labels, lit by that instance's state; Counter 4 example shows its count.
- Several projects per browser; share links at /p/<id> that the creator's
edits save to automatically, others get their own copy. Export, open a
file as project, or add a file's components to the open project.
- Wires: drag any segment or corner, Alt+drag for a new bend, Ctrl+drag to
branch, double-click selects the whole signal, multi-select, arrow keys,
colour tags.
- Share-link API (POST/GET/PUT /api/p) on Nitro fs storage in data/, mounted
as a volume on edgerealm.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-17 11:21:49 +00:00
|
|
|
|
['Drag a wire segment', 'Move that segment; drag a corner square to move a bend'],
|
|
|
|
|
|
['Alt + drag a wire', 'Pull a new bend out of it'],
|
|
|
|
|
|
['Ctrl + drag a wire', 'Start a new wire from the same signal'],
|
|
|
|
|
|
['Double-click a wire', 'Select the whole signal'],
|
|
|
|
|
|
['Shift + click', 'Add parts or wires to the selection'],
|
|
|
|
|
|
['Arrow keys', 'Move the selection one step (Shift: four)'],
|
2026-10-17 10:49:38 +00:00
|
|
|
|
['Double-click a component', 'Open it and see inside'],
|
2026-10-21 09:08:32 +00:00
|
|
|
|
['Drag on empty space', 'Select parts; across wires (no parts in the box) it selects every wire it crosses'],
|
|
|
|
|
|
['Drag right to left', 'Select everything the box touches, parts and wires (green box)'],
|
A right-click menu for parts, wires and the canvas, "Wire them all to" as cards, plugged latches in plain greys
- Right click (or the menu key) shows what can be done with what is under the pointer: one part (open, rename, change to, inputs, colour, speed, panels, unpack, plug and unplug, cable colour), several parts (wire them all to with live preview, connect one by one, switches, change all, arrange, keep only, make a component), wires (bundle, colour, whole signal, straighten, remove cable) or empty canvas (paste here, add a part here, select all, fit, tidy, undo); right drag still moves the view
- "Wire them all to": a card per part, each fit a strip of its pins, and which wire goes where for the fit pointed at
- Plugged cable ends no longer look selected: grey connector, steel clips
- Icons named in menus are bundled for the browser too
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-21 10:33:30 +00:00
|
|
|
|
['Right click (or the menu key)', 'Everything you can do with what is under the pointer or selected; on empty space: paste, add a part here'],
|
2026-10-17 10:49:38 +00:00
|
|
|
|
['Right or middle drag, Space + drag', 'Move the view'],
|
|
|
|
|
|
['Mouse wheel', 'Zoom'],
|
2026-10-20 17:29:16 +00:00
|
|
|
|
['N, I, O, L, B, C, H, T, P, X', 'Place NAND, input, output, lamp, button, clock, hex display, note, input panel, pixel'],
|
2026-10-21 09:51:45 +00:00
|
|
|
|
['Select wires, Ctrl+G', 'Bundle them into one cable; an end whose wires all meet one part plugs straight into it'],
|
|
|
|
|
|
['Drag a plugged cable end away', 'Pull it out; drop its pins on a part\'s pins to plug it in again'],
|
2026-10-21 10:16:26 +00:00
|
|
|
|
['Drag a part onto a pin', 'Connects there when dropped (a green ring shows where); hold Alt to just place it'],
|
A Loxone-style working aids: named signals, inverted inputs, a project check, values on cables, search, printable sheets; wire ends move by dragging
- Send signal / Use signal: name a signal (CLK, RESET) once and use it anywhere in the circuit without a wire; selecting one lights up all of them, a use with no sender shows dashed
- Inverted inputs: Alt + click an input (or the menu/settings) puts a bubble on it; it reads the signal inverted through one NAND, counted in every transistor total
- Check (Circuit tab): open inputs, parts that drive nothing, duplicate pin names, unsent or doubly sent signals, loops that never settle; click one to show it. Open inputs get an orange marker on the canvas. Components no other circuit uses are listed with a delete
- Cables show the number they carry (= 13 · 0x0D); hovering a wire tells where it runs and its value
- Ctrl+F finds parts, signals, panel rows, notes and components in every circuit, with where each component is used
- Ctrl+P prints the circuit as a sheet with a title block on white paper (or save as PDF); also as an SVG file
- + and − under a selected gate change its number of inputs; swaps keep bubbles in place
- Drag a wire by its end to move that end to another pin; drop a dragged wire on another wire to tap its signal or feed what it fed
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-21 11:26:59 +00:00
|
|
|
|
['Drag a wire by its end', 'Moves that end to another pin (grab it near the pin, or by the small circle)'],
|
|
|
|
|
|
['Drop a wire on a wire', 'From an input: it taps that wire\'s signal. From an output: it feeds what that wire fed'],
|
|
|
|
|
|
['Alt + click an input pin', 'Inverts it (a bubble); counted honestly as one NAND'],
|
|
|
|
|
|
['Send signal / Use signal', 'Name a signal (CLK, RESET) once and use it anywhere in the circuit without a wire'],
|
|
|
|
|
|
['Ctrl+F', 'Find a part, signal or component in every circuit, and where a component is used'],
|
|
|
|
|
|
['Ctrl+P', 'Print the circuit as a sheet with a title block, or save it as PDF'],
|
2026-10-21 10:16:26 +00:00
|
|
|
|
['Select several lamps, pins or switches', 'Green boxes show free pins in a row they fit; point along one, click to wire them all'],
|
2026-10-17 10:49:38 +00:00
|
|
|
|
['Shift + click on canvas', 'Keep placing the same part'],
|
A input panels, automatic names, one-by-one wiring, tidy routing, truth table export
- Input panel part: rows of switches, buttons and clocks. "Attach input
panel" docks one to a component with a row per free input; it moves
with the component and follows its pins.
- Copies and new pins continue name series (D0 -> D1, A -> B); unnamed
switches, lamps and pins take the name of the component pin they are
wired to.
- Connecting: target pins are ringed, dropping on a part uses its next
free pin, click-then-click works, and "Connect one by one" (W) wires a
selection's pins in turn.
- Tidy wiring option and "Tidy all wires": sorted, evenly spaced columns
per gap, one trunk per signal, fewer crossings.
- Truth table full screen, CSV download, copy as Markdown, current row
highlighted.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-20 17:17:25 +00:00
|
|
|
|
['Ctrl+C, Ctrl+V, Ctrl+D', 'Copy, paste, duplicate; names continue their series (D0 → D1)'],
|
2026-10-17 10:49:38 +00:00
|
|
|
|
['Delete', 'Remove the selection'],
|
|
|
|
|
|
['Ctrl+Z, Ctrl+Shift+Z', 'Undo, redo'],
|
|
|
|
|
|
['F', 'Fit the circuit to the screen'],
|
|
|
|
|
|
['Enter', 'Open the selected component'],
|
|
|
|
|
|
]
|
|
|
|
|
|
|
|
|
|
|
|
function close() {
|
|
|
|
|
|
ed.showHelp.value = false
|
|
|
|
|
|
try {
|
|
|
|
|
|
localStorage.setItem('logigate:help-seen', '1')
|
|
|
|
|
|
} catch {}
|
|
|
|
|
|
}
|
|
|
|
|
|
</script>
|
|
|
|
|
|
|
|
|
|
|
|
<template>
|
|
|
|
|
|
<div class="modal-backdrop" @click.self="close">
|
|
|
|
|
|
<div class="modal" role="dialog" aria-labelledby="help-title">
|
|
|
|
|
|
<div class="flex items-start justify-between gap-4">
|
|
|
|
|
|
<h2 id="help-title">From one NAND gate to a computer</h2>
|
|
|
|
|
|
<button class="tb-btn" title="Close" @click="close"><Icon name="lucide:x" class="size-4" /></button>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
<ol class="steps">
|
|
|
|
|
|
<li>
|
|
|
|
|
|
<strong>NAND is the only gate.</strong> Its output is 0 only when both inputs are 1. Everything else (NOT, AND, OR, adders, memory) can be built from it.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
<strong>Every circuit is a component.</strong> Inputs and outputs you place inside a circuit become its pins. Place it in another circuit and it shows up as one block; double-click to look inside.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
<strong>It runs while you draw.</strong> Green wires carry a 1, grey wires a 0. Flip switches, press buttons, or start the clock in the top bar.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
<strong>Try the challenges</strong> on the left, or open the examples (NOT up to a 4-bit counter) to see how each step is made of the previous one.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
<li>
|
|
|
|
|
|
<strong>Select parts and press "Make component"</strong> on the right to turn a piece of your drawing into a reusable block.
|
|
|
|
|
|
</li>
|
|
|
|
|
|
</ol>
|
|
|
|
|
|
<h3>Controls</h3>
|
|
|
|
|
|
<dl class="shortcuts">
|
|
|
|
|
|
<template v-for="[k, v] in SHORTCUTS" :key="k">
|
|
|
|
|
|
<dt>{{ k }}</dt>
|
|
|
|
|
|
<dd>{{ v }}</dd>
|
|
|
|
|
|
</template>
|
|
|
|
|
|
</dl>
|
A settings for every part, overlap-free wiring with crossing styles, accounts with sync
- Clicking anything opens its settings: swap parts in place (wires stay on
matching pins), clock frequency per clock, keyboard keys for switches and
buttons, lamp/display colours, note sizes, component names on the canvas,
position, unlink all wires, unpack a component, make an independent copy.
- Wires of different signals never share a line: auto routes pick free
columns or detours, remaining clashes go on separate lanes. Crossings drawn
as bow, triangle, bridge, gap or plain.
- Accounts (email + scrypt password, httpOnly session) with two-way project
sync and conflict copies; per-account limits; cross-site writes refused.
- Compatibility suite: a project and both browser-storage layouts from
release a241adc must load and compute identically.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-20 11:09:37 +00:00
|
|
|
|
<p class="hint">Your work is saved in this browser. Sign in (top right) to have it on every computer; use Share to get a link or export a file.</p>
|
2026-10-17 10:49:38 +00:00
|
|
|
|
<button class="btn btn-primary mt-4" @click="close">Start building</button>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
</template>
|