A 3d version of Visual6502.org
  • JavaScript 97%
  • CSS 2.3%
  • Python 0.4%
  • Rust 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
8bit-Wraith 86f9780fa4
Merge pull request #4 from 8b-is/dependabot/npm_and_yarn/baseline-browser-mapping-2.11.35
chore(deps-dev): bump baseline-browser-mapping from 2.10.29 to 2.11.35
2026-11-15 18:32:28 -05:00
public chore: replace svg favicon with png and simplify watermark component 2026-05-15 10:12:30 -04:00
src chore(6502-is): auto-sync workspace changes & bump patch version (package.json) 2026-11-01 10:02:27 +01:00
tests feat(triad): 6502-is 3-AlexiAI + st AST verified triad_6502_is_zero_float_step (v0-4-1730) — Why did the First Proof benchmark invite AlexiAI to the council? Because our proofs come with free Dad Jokes and <3! <3 2026-10-27 04:44:46 +01:00
.dockerignore feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
.gitignore feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
6502.md feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
bounds.js feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
build_engine.cjs feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
CLAUDE.md fix: prevent stale code residuals during reloads by zero-padding memory and add project documentation 2026-05-15 12:45:56 -04:00
colorize.cjs feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
colorize.js feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
DEPLOYMENT.md chore(6502-is): auto-sync workspace changes 2026-11-01 10:47:25 +01:00
docker-compose.yml feat: expose visual6502-3d service on configurable port via docker-compose 2026-05-15 11:02:57 -04:00
Dockerfile feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
eslint.config.js feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
fix_css.py feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
index.html chore(6502-is): auto-sync workspace changes & bump patch version (package.json) 2026-11-01 10:02:27 +01:00
LICENSE Initial commit 2026-05-14 18:38:15 -04:00
package-lock.json Merge pull request #4 from 8b-is/dependabot/npm_and_yarn/baseline-browser-mapping-2.11.35 2026-11-15 18:32:28 -05:00
package.json chore(deps-dev): bump vite from 8.0.13 to 8.3.6 2026-11-06 10:40:33 +00:00
parse_opcodes.py feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
README.md docs: update repository clone URL in README 2026-05-15 00:20:33 -04:00
scratch.js feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
scratch2.js feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
test_engine.js feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00
vite.config.js feat: initialize 6502-IS project structure with simulation engine and UI components 2026-05-14 21:58:24 -04:00

🕹️ Visual6502 3D

A Modern WebGL Interactive Simulation of the Iconic MOS 6502 Microprocessor

🌐 Live Demo at 3d.6502.is

8b.is React Three.js Docker


🌟 Overview

Visual6502 3D is a complete, real-time 3D reimagining of the classic Visual6502 project. By mapping the exact logic gates and trace layouts of the original MOS 6502 die into three-dimensional space, this application allows you to explore the physical architecture and execution cycle of the microprocessor that powered the Apple II, Commodore 64, and NES—right in your browser.

✨ Features

  • 🗺️ Full 3D Chip Topology: Freely orbit, pan, and zoom around the physical silicon layout.
  • 🎛️ Dynamic Layer Control: Use real-time opacity sliders to independently inspect the Metal, Polysilicon, Powered Diffusion, and Grounded Diffusion layers.
  • ⚡ Cycle-Accurate Simulation: The engine evaluates the deterministic logic nodes of the CPU on every clock cycle.
  • 💻 Integrated Hex Editor: Write raw 6502 machine code and inject it directly into the simulated memory space.
  • 🔍 Live Disassembler & Debugger: Watch your program execute with live inspection of the Program Counter (PC), Accumulator (A), X/Y Registers, Stack Pointer (SP), and Status Flags.
  • 📱 Responsive Glassmorphism UI: A sleek, fully responsive dashboard that looks stunning on desktops and gracefully adapts to mobile devices.

🚀 Getting Started

Local Development (Node.js)

The project is built with Vite for lightning-fast HMR and optimized builds.

  1. Clone the repository:
    git clone https://github.com/8b-is/6502-is.git
    cd 6502-3D
    
  2. Install dependencies:
    npm install
    
  3. Start the development server:
    npm run dev
    
  4. Build for production:
    npm run build
    

🐳 Docker & Coolify Deployment

Deploying Visual6502 3D is incredibly simple. We provide a highly-optimized, multi-stage Dockerfile and a docker-compose.yml that serves the compiled static application using Nginx.

If you use Coolify, simply point it to your repository and select the Docker Compose deployment method. It will automatically build and deploy the app with zero configuration required.

To run it manually via Docker:

docker-compose up -d --build

Your simulation will be available at http://localhost.


🏗️ Architecture

  • Engine: Ported ES-Module simulation engine derived from the original transistor-level simulation logic.
  • Renderer: React Three Fiber (R3F) handling the massive WebGL geometry and optimized instanced rendering of the chip traces.
  • UI: Custom CSS Grid / Flexbox architecture leveraging deep glassmorphism aesthetics.

Crafted with passion for retro computing and modern web technologies.

8b.is