Skip to content

An educational browser based game being built as a personal project

Notifications You must be signed in to change notification settings

shangabl/turing-game

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Turing Game

Turing Game is an educational browser-based game designed to teach the fundamentals of computer science, starting from the transistor level and progressing through layers of abstraction to build a basic computer. The game is built using Rust and WebAssembly.

Table of Contents

Features

  • Interactive tutorials on transistors, logic gates, adders, multiplexers, and more.
  • Visually demonstrates how basic components work together to build complex circuits.
  • Supports various logic operations and arithmetic functions.
  • Educational content for beginners and enthusiasts.

Installation

To run Turing Game locally, follow these steps:

Prerequisites

Steps

  1. Clone the repository:

    git clone https://github.com/your-username/turing-game.git
    cd turing-game
  2. Build the WebAssembly package:

    wasm-pack build --target web --out-dir ./static/pkg
  3. Install the HTTP server if you don't have it installed:

    npm install -g http-server
  4. Start the server:

    http-server static
  5. Open your browser and navigate to http://localhost:8080.

Usage

Select a level from the menu to begin learning about transistors and logic gates. Each level provides an interactive circuit diagram that allows you to toggle inputs and observe the outputs.

Development

To contribute to the development of Turing Game, follow these steps:

Prerequisites

  • Rust
  • wasm-pack
  • npm

Steps

  1. Fork the repository.

  2. Create a new branch:

    git checkout -b feature/your-feature-name
  3. Make your changes and commit them:

    git commit -m "Description of your changes"
  4. Push to the branch:

    git push origin feature/your-feature-name
  5. Open a pull request.

About

An educational browser based game being built as a personal project

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published