Cognitive Games

A collection of brain training games built with Rust and WebAssembly, focusing on numeracy and perception skills.

Games

Numeracy Game

A mathematical puzzle game that challenges your ability to compare numerical expressions.

Features:

• Select expressions in ascending order
• Dynamic difficulty scaling
• Time-based scoring with a 15-second round timer
• Level progression based on performance
• Supports basic arithmetic operations (+, -, ×, ÷)
• Decimal numbers in higher levels
• Progress auto-saving

Perception Game (Maze)

A procedurally generated maze game testing spatial awareness and planning.

Features:

• Procedurally generated mazes using depth-first search
• Key-and-door mechanics
• Progressive difficulty with increasing maze size
• Move tracking
• 5-minute time limit per level
• Visual feedback for wall collisions
• Automatic progress saving
• Dark mode support

Mental Rotation

A spatial reasoning game where players create paths using rotatable polyomino tiles.

Features:

• Polyomino tiles with directional arrows
• Left-click to rotate tiles 90° clockwise
• Right-click to reverse arrow directions
• Progressive difficulty with increasing grid size
• 3-minute time limit per level
• Auto-save functionality
• Smooth rocket animation on completion

Prerequisites

• Rust (nightly toolchain)
• Node.js
• npm

Installation

# Clone the repository
git clone https://github.com/noneofyourbusiness1415252/cognitive-games.git
cd cognitive-games

# Install dependencies and build the project
npm install

Development

Start the development server:

npm start

The games will be accessible at:

• Numeracy Game: http://localhost:80/numeracy.html
• Maze Game: http://localhost:80/

Building for Production

npm run build

The output will be in the dist directory.

Testing

Run the test suite:

npm test

This will run both Rust unit tests and WebAssembly integration tests.

Project Structure

• src/games/numeracy/ - Numeracy game implementation
• src/games/perception/ - Maze game implementation
• static/ - HTML, CSS, and other static assets
• js/ - JavaScript entry point (Note: the project strictly uses Rust for game logic, not JavaScript)
• Cargo.toml - Rust dependencies and configuration
• package.json - Node.js dependencies and scripts
• webpack.config.js - Webpack configuration

Colour Theme and Accessibility

• Dark Theme: #000 background
• Light Theme: #000 text
• All other colours are chosen to be as dark as possible to ensure a contrast ratio of at least 3:1, using shades from the actual Mindgage cognitive test.
• All text is scaled to meet WCAG AA criteria for a minimum contrast ratio of 3:1.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Umar Sharief