Skip to content

Build the computer journey through assembler and add the full Nand2Tetris tool suite - #47

Draft
durasj wants to merge 19 commits into
mainfrom
codex/signal-isles-redesign
Draft

durasj wants to merge 19 commits into
mainfrom
codex/signal-isles-redesign

Conversation

@durasj

@durasj durasj commented Nov 2, 2026 •

Copy link
Copy Markdown
Owner

Chips and Code now provides one Learn / Tools / About interface, from a first signal through a working computer and a learner-written assembler. The original branding and minimal layout remain. Legacy URLs redirect into this interface, including saved experiments.

The homepage follows a scroll-driven journey from a complete laptop into its components, processor, and binary signals. Mobile and reduced-motion views retain the sequence as stills. Learning starts with signals, NOT, and AND before NAND and optional theory.

The guided path adds 31 tasks across Nand2Tetris Projects 1–6: buses and routing, arithmetic and the ALU, clocked memory, machine language (Mult and Fill), Memory/CPU/Computer, and two-pass assembly. Hardware construction supports Visual, Code, and Split views with real validation, local drafts, and progress. The assembler project runs learner JavaScript in an isolated worker with a timeout. Full reading covers the same material and links back to each layer.

All six official Web IDE tool types are available:

  • Hardware simulator: structural HDL, buses/slices, custom chips, tick/tock, ROM/devices, and bounded TST execution with CMP comparisons.
  • CPU emulator and assembler in one workspace: assembly/binary loading, symbols/source maps, stepping and bounded execution, registers/RAM, screen/keyboard, and .hack export.
  • VM emulator: multiple files, stack/segments/calls, native OS services, screen/keyboard, execution, and reset.
  • Jack compiler: multi-class compilation, source diagnostics, and persistent transfer into the VM.
  • Bitmap editor: pointer/keyboard drawing, resizing, JSON drafts, and positioned Jack/assembly/screen-word output.

Saved HDL experiments, Boolean functions, and bus/routing exploration remain under Tools. Guided lessons stop at Project 6; VM and compiler tools are available for further exploration.

VM/Jack/runtime code is pinned to nand2tetris/web-ide commit 2070cd8, with retained MIT attribution and documented integration patches. Official project fixtures retain their notices and license. Educational adaptations retain Nisan/Schocken attribution and CC BY-NC-SA terms. Source and content audits document coverage.

The optional 48-second film has captions and a transcript. Its master remains silent: the connected Runway Free workspace still exposes no speech models. No account plan or credit settings were changed.

Validation on 17da6de: 494 unit tests pass (one existing todo), with 98.19% first-party line coverage; all 56 browser tests pass across nine specs; Svelte reports zero errors and warnings; Cypress TypeScript and production build pass. Browser coverage includes the original navigation and beginner journey, guided construction/progress, clocked hardware and comparison scripts, CPU execution, assembler-worker timeout/recovery, multi-file Jack → VM → reload → execution, and bitmap keyboard editing → assembly → screen memory. Mobile accessibility checks remain enabled without global exclusions. Desktop and 320-pixel screenshots were reviewed. The pinned vendor runtime is excluded from first-party coverage; its public adapter is integration-tested. Repository-wide lint still contains pre-existing violations; scoped checks for the new implementation passed.

Preview · Passing CI

@vercel

vercel Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
chipsandcode Ready Ready Preview Nov 7, 2026 3:28pm UTC

Request Review

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

Deploying chipsandcode with  Cloudflare Pages  Cloudflare Pages

Latest commit: 17da6de
Status:🚫  Build failed.

View logs

@durasj durasj changed the title Turn Boolean Logic into the playable Signal Isles Reimagine Chips and Code through computer layers with visual and HDL authoring Nov 2, 2026
@durasj durasj changed the title Reimagine Chips and Code through computer layers with visual and HDL authoring Reimagine Chips and Code as a journey through computer layers Nov 2, 2026
@durasj durasj changed the title Reimagine Chips and Code as a journey through computer layers Build a minimal computer-layer journey with progressive circuit learning Nov 2, 2026
@durasj durasj changed the title Build a minimal computer-layer journey with progressive circuit learning Unify Chips and Code with a computer journey, guided foundations, and complete logic tools Nov 2, 2026
@durasj durasj changed the title Unify Chips and Code with a computer journey, guided foundations, and complete logic tools Build the computer journey through assembler and add the full Nand2Tetris tool suite Nov 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant