git404hub

what is gridx fr?

jarvis-llm-codec/gridx — explained in plain English

Analysis updated 2026-05-18

2HTMLAudience · generalComplexity · 2/5LicenseSetup · easy

tl;dr

A free, AI-built browser arcade shooter inspired by Geometry Wars, where you fight geometric enemies on a neon sphere and compete on a public leaderboard.

vibe map

mindmap
  root((GRIDX))
    What it does
      3D twin-stick shooter
      Neon sphere arena
      Global leaderboard
    Build story
      Built by AI agents
      Single HTML to TypeScript
      Parity test verified
    Tech stack
      TypeScript
      three.js
      Supabase leaderboard
    Controls
      Keyboard and mouse
      Touch support
    Audience
      Arcade game players
      AI-built games curious

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Play a free browser-based twin-stick shooter arcade game instantly, no install needed

VIBE 2

Compete on the global leaderboard by registering your score

VIBE 3

Run the project locally to build a single self-contained HTML arcade-cartridge version

VIBE 4

Study the parity test approach for verifying two AI-generated codebases behave identically

what's the stack?

TypeScriptthree.jsSupabaseHTML

how it stacks up fr

jarvis-llm-codec/gridx100/talk_stockalexcybernetic/playground-ai
Stars222
LanguageHTMLHTMLHTML
Last pushed2022-03-24
MaintenanceDormant
Setup difficultyeasymoderateeasy
Complexity2/53/51/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Play instantly at the hosted link, or run npm install and npm run dev to try it locally.

Licensed under Apache-2.0, so anyone can freely use, modify, and share the code, including commercially, as long as they keep the license and copyright notices.

in plain english

GRIDX is a free browser arcade game inspired by Geometry Wars, where you fly around a neon sphere fighting waves of geometric enemies. You pick up weapons, use a special attack called NOVA, survive a mini-boss, and eventually face a fast-paced final boss. There is a global leaderboard where players can register their scores with a short comment. The game can be played instantly at its GitHub Pages link, with no install, no ads, and no monetization. What makes this project unusual is how it was made. According to the README, it was built almost entirely by a chain of AI systems working together, guided by one person whose son helped playtest it. One AI system, described as JARVIS Code, coordinated the process. Another AI, GLM 5.2, first built the game as a single large self-contained HTML file. A separate AI, GPT 5.6, then rebuilt that single file back into the organized TypeScript codebase you see in this repository, and Claude reviewed and helped ship the final result. To confirm the two versions actually behave the same way, the project includes a parity test that runs the game's simulation for three different starting seeds across 3,000 steps each and checks that the results match the original within a tiny margin of error. This works because the simulation logic is fully separated from the browser display and uses a seeded random number generator, so it always produces the same outcome given the same seed. To run the project yourself, you install its dependencies with npm, then you can start a development server, build a production version, or build it back into a single self-contained HTML file, plus run its 143 unit tests and the parity check. Controls use the keyboard and mouse, or touch on mobile, with the usual move, aim, fire, boost, and pause actions. The leaderboard is backed by Supabase, a hosted database service, with security rules and an automatic filter to catch inappropriate comments. Contributions are welcome, especially new enemy types, weapons, or gamepad support, as long as changes stay fun, free, and free of ads or tracking. The project explains that Geometry Wars is a trademark of Activision and that GRIDX is an independent, fan-inspired project not affiliated with or endorsed by them. It is released under the Apache-2.0 license.

prompts (copy fr)

prompt 1
Explain how GRIDX's golden-trajectory parity test verifies the reconstructed TypeScript matches the original HTML file
prompt 2
Walk me through the npm commands to run, build, and test GRIDX locally
prompt 3
Summarize GRIDX's controls for both keyboard and touch play
prompt 4
Explain what Apache-2.0 licensing means for someone who wants to fork and modify GRIDX

Frequently asked questions

what is gridx fr?

A free, AI-built browser arcade shooter inspired by Geometry Wars, where you fight geometric enemies on a neon sphere and compete on a public leaderboard.

What language is gridx written in?

Mainly HTML. The stack also includes TypeScript, three.js, Supabase.

What license does gridx use?

Licensed under Apache-2.0, so anyone can freely use, modify, and share the code, including commercially, as long as they keep the license and copyright notices.

How hard is gridx to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is gridx for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.