olistic

olistic/warriorjs

TypeScript MIT Education

🏰 An exciting game of programming and Artificial Intelligence

9.5k stars
500 forks
slow
GitHub +1 / week

9.5k

Stars

500

Forks

19

Open issues

13

Contributors

AI Analysis

WarriorJS is an educational game where players learn JavaScript and TypeScript by writing code that guides a warrior through puzzle-filled towers with enemies, obstacles, and NPCs. It serves learners from beginners writing their first conditionals to intermediate developers seeking practice; it is not suitable for production systems or performance-critical applications.

Education Game Engine Discovery value: 5/10
Documentation 9/10
Activity 6/10
Community 8/10
Code quality 8/10

Inferred from signals mentioned in the README (tests, CI, type safety) — not a review of the actual code.

Overall score 8/10

AI's overall editorial judgment — not an average of the bars above, can weigh other factors too.

educational-game programming-practice javascript-learning interactive-puzzle code-challenge
Actively maintained Well documented MIT licensed Educational Popular Beginner friendly
Deep Analysis · Based on README and public signals
2w ago

WarriorJS teaches JavaScript and TypeScript through a terminal-based dungeon-crawler game

WarriorJS is a code-learning game where players write JavaScript or TypeScript logic to navigate a warrior through multi-floor towers filled with enemies and puzzles. It targets beginners and intermediate developers learning programming fundamentals through immediate, playful feedback. Built as a CLI tool with an optional browser interface, it also allows community members to author custom towers. The project has a long track record since 2015, nearly 9,500 GitHub stars, and appears to still receive maintenance commits as recently as March 2026.

Origin

Originated in 2015 as a TypeScript/JavaScript port of Ryan Bates' ruby-warrior. Has evolved from a single-package CLI into a monorepo architecture with extensible tower support and a companion web experience at warriorjs.com.

Growth

The project accumulated most of its stars during the 2015–2019 era when gamified coding education was trending. Star velocity has since slowed significantly — gaining only 1 star in the last 7 days — suggesting the project has plateaued in mainstream visibility. However, it retains a stable base and occasional new commits, indicating it has transitioned from growth mode to maintenance mode.

In production

Adoption not verified in production/professional settings. The project is a learning game, so 'production use' is not a meaningful metric — it is intended for individual educational use. Browser version at warriorjs.com suggests some hosted traffic, but scale is unknown.

Code analysis
Architecture

Likely a monorepo structure (based on the scoped npm packages like @warriorjs/cli referenced in README) with separate packages for CLI, core engine, and towers. Appears to support both local CLI play and a browser-hosted version, suggesting a decoupled game engine layer. Extension via community-built towers implies a plugin-style API.

Tests

Codecov badge is present in README, indicating test coverage is measured and tracked, though the exact percentage is not stated in the README excerpt.

Maintenance

Last push was March 27, 2026 — roughly 3 months before the evaluation date — indicating the project is actively maintained at a low-frequency cadence. CI badge references GitHub Actions. This is slow but not stagnant; it appears to receive periodic upkeep without rapid feature expansion.

Honest verdict

ADOPT IF: you want a self-contained, offline-capable, terminal-native way to teach yourself or others JavaScript/TypeScript fundamentals through game logic without requiring a paid platform. AVOID IF: you need a structured curriculum with progress tracking, instructor tooling, or collaborative classroom features — WarriorJS lacks these. MONITOR IF: you are an educator or developer-relations professional exploring gamified learning tools; the extensible tower system could become more useful if the community around custom towers grows.

Independent dimensions

Mainstream potential

3/10

Technical importance

5/10

Adoption evidence

3/10

Risks
  • Very low recent star velocity (1 per week) suggests declining organic discovery and community momentum.
  • Single primary maintainer risk: the project appears to be sustained by one person (olistic), with no evidence of a broader maintainer group.
  • The educational gaming space is crowded with well-funded alternatives (CodeCombat, Codewars, etc.) that may attract learners who might otherwise discover WarriorJS.
  • No documented community tower ecosystem size — the extensibility feature may be underused in practice, limiting replayability.
  • Node.js 22 requirement (per README) may be a friction point for users on older environments, though this also reflects a healthy commitment to modern tooling.
Prediction

WarriorJS will likely remain a stable niche tool for JS/TS learners who prefer terminal-based, game-driven education. It is unlikely to recapture significant growth momentum but may persist as a well-regarded entry in its category for years.

0 found this helpful

Newsletter

Get analyses like this every Monday

Free weekly digest of the most interesting open-source discoveries.

Languages

TypeScript
95.8%
JavaScript
2.7%
CSS
1.5%
HTML
0%

Information

Language
TypeScript
License
MIT
Last updated
4mo ago
Created
136mo ago
Analyzed with
anthropic/claude-haiku-4-5

Stars over time

Loading…

Contributors over time

Top 100 contributors only — repos with more will plateau at 100.

Loading…

Recent releases

No releases published yet.

Similar repos

codecombat

codecombat/codecombat

CodeCombat is a multiplayer programming game designed to teach coding through...

8.5k JavaScript Education
skills

skills/secure-code-game

Secure Code Game is an interactive, browser-based learning platform that...

2.8k JavaScript Education
excaliburjs

excaliburjs/Excalibur

Excalibur is a free, open-source 2D game engine written in TypeScript for HTML5...

2.3k TypeScript Gaming
microsoft

microsoft/generative-ai-with-javascript

A Microsoft educational course teaching Generative AI fundamentals through...

1.2k JavaScript Education
kenkoooo

kenkoooo/AtCoderProblems

AtCoder Problems is a web application that enhances the AtCoder competitive...

1.6k TypeScript Education
vs. alternatives
CodeCombat

CodeCombat (8,512 stars) is a browser-based coding game with a structured curriculum and commercial backing, targeting a similar audience. WarriorJS is CLI-first, offline-capable, and open for custom towers, making it preferable for developers comfortable in a terminal environment.

Excalibur.js

Excalibur is a TypeScript game engine for building games, not a learning game itself. The audiences barely overlap; comparison is not meaningful.

AtCoder Problems

AtCoder Problems is a competitive programming tracker, not a learning game. Different audience (competitive programmers vs. beginners learning JS).

secure-code-game

Microsoft's secure-code-game targets security education specifically. WarriorJS targets general JS/TS programming logic. Different educational focus with minimal overlap.

ruby-warrior (original)

WarriorJS is a direct descendant of ruby-warrior. For Ruby learners, ruby-warrior is the equivalent; WarriorJS fills the same niche for the JavaScript ecosystem.