- JavaScript 97%
- CSS 2.3%
- Python 0.4%
- Rust 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| public | ||
| src | ||
| tests | ||
| .dockerignore | ||
| .gitignore | ||
| 6502.md | ||
| bounds.js | ||
| build_engine.cjs | ||
| CLAUDE.md | ||
| colorize.cjs | ||
| colorize.js | ||
| DEPLOYMENT.md | ||
| docker-compose.yml | ||
| Dockerfile | ||
| eslint.config.js | ||
| fix_css.py | ||
| index.html | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| parse_opcodes.py | ||
| README.md | ||
| scratch.js | ||
| scratch2.js | ||
| test_engine.js | ||
| vite.config.js | ||
🕹️ Visual6502 3D
A Modern WebGL Interactive Simulation of the Iconic MOS 6502 Microprocessor
🌐 Live Demo at 3d.6502.is
🌟 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.
- Clone the repository:
git clone https://github.com/8b-is/6502-is.git cd 6502-3D - Install dependencies:
npm install - Start the development server:
npm run dev - 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