Skip to main content
Final-Year Project · Ben-Gurion University · 2026

EscapeCircuit

An interactive logic-circuit puzzle platform. Wire gates, crack riddles, and learn digital logic by building it.

About the project

What is EscapeCircuit?

Digital-logic fundamentals are usually taught on paper, with truth tables, Karnaugh maps, and static diagrams. EscapeCircuit turns them into a game. Students wire simulated logic gates to solve riddles like binary adders, palindrome detectors, and synchronous counters, and get instant feedback from a live circuit simulation. Players earn XP, climb the leaderboard, discuss strategies, and publish puzzles of their own.

550+

Commits

150+

Pull requests merged

12

Built-in riddles

3

Test frameworks

Built with

Next.js 14TypeScriptTailwind CSSZustandReact QueryRadix UIFastAPIPythonSQLiteJWT + Google OAuthVitestPlaywrightPytest

Promo video

See it in action

A short promotional video introducing EscapeCircuit.

escapecircuit/promo.mp4

User manual

How to use EscapeCircuit

Four steps from signing up to publishing your own riddles. The full illustrated manual is in the user guide below.

Puzzle arena

Register & pick a puzzle

Create an account or sign in with Google, then browse the puzzle arena. Filter by difficulty, pick a riddle, and read what your circuit needs to do.

Workstation

Wire your circuit

Drag logic gates from the toolbox onto the workstation canvas and connect output pins to input pins. AND, OR, NOT, XOR and flip-flops are all available, so any truth table can be built.

Debugger

Debug & submit

Step through your circuit tick by tick with the built-in debugger. Signal states are colour-coded live, so you can trace exactly where the logic breaks. When every output matches, submit to earn XP.

Arsenal & creator

Level up & build your own

Earn XP, climb the leaderboard, and unlock advanced gates in your arsenal. You can also create your own riddles and publish them for the community to solve.

Documentation

Deliverables & reports

The documents we submitted during the year, from the architecture design to the final release.

Design

Architecture Design Document

System architecture, component diagrams, and the technology decisions behind the platform.

Open PDF5.4 MB
Manual

Comprehensive User Guide

The full manual, with interface screenshots and instructions for the workstation, puzzles, and every core feature.

Open PDF1.3 MB
Maintenance

Maintainer & Extension Guide

System maintenance, database setup, deployment, and how to extend the platform with new puzzles.

Open PDF0.5 MB
Release

Release Notes

What shipped in the final iteration: new puzzles, the clue system, admin tools, and more.

Open PDF0.1 MB

The team

Built by four students

EscapeCircuit is the final-year capstone project of four Software Engineering students at Ben-Gurion University of the Negev, class of 2026.

DS

Dor Steinlauf

Software Engineering Student

NS

Noam Shlomo Yosef

Software Engineering Student

MD

Mendy Dishon

Software Engineering Student

YZ

Yuval Zarmi

Software Engineering Student

Academic supervision

Academic advisor

Niv Gilboa

Client

Gera Weiss

Client

Oded Margalit

Ready to crack the circuit?

Try the live platform, browse the source code, or read the documentation.