gitwtfhub

wtf is umbra?

wisamidris77/umbra — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · generalComplexity · 1/5Setup · easy

TL;DR

A free open source browser game where you defeat five bosses using only a single button.

Mindmap

mindmap
  root((repo))
    What it does
      One button combat
      Five boss fights
      Playable on itch.io
    Tech stack
      JavaScript
      Node.js
    Use cases
      Play boss fight game
      Practice timing skills
      Contribute new bosses
    Audience
      Players
      Hobby contributors

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

Why would anyone build with this?

REASON 1

Play a free browser and desktop boss-fight game controlled with a single button.

REASON 2

Practice timing-based boss encounters across five current fights, including the fan-favorite fifth boss.

REASON 3

Contribute new boss ideas, mechanics, or story suggestions to an open source passion project.

What's in the stack?

JavaScriptNode.js

How it stacks up

wisamidris77/umbra00kaku/gallery-slider-block0xkinno/vellum
Stars00
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-19
MaintenanceDormant
Setup difficultyeasyeasyhard
Complexity1/52/54/5
Audiencegeneralgeneraldeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

Clone the repo and run node server.js, or play directly on itch.io with no install.

Wtf does this do

UMBRA is a free, open source browser game where the entire point is defeating a series of bosses using only a single button. Made by a creator called Silent gho3t, the game can be played directly online through itch.io, or downloaded and run from this source code. The control scheme is deliberately minimal. Clicking switches which direction the player is facing, holding the button charges up an attack, and releasing it either fires a projectile or throws the player character at the enemy. Every fight in the game is built around that one simple input, which is meant to keep the action fast and easy to pick up while still requiring timing and judgment to beat each boss. As it stands, the game includes five bosses to fight through, and the readme specifically calls out the fifth boss, nicknamed Chad, as the most fun and best designed fight so far. The creator is upfront that the main way to make the game better going forward is by adding more bosses, and admits that coming up with fresh ideas for new fights is the hardest part of continuing the project. Anyone who plays is invited to share notes on how to improve existing bosses, propose new boss mechanics, or suggest ways to add more story, and contributions of any kind are welcomed. Running it locally is straightforward: clone the repository, start the included server with a single Node.js command if the project uses one, and then open the game in a web browser. There is no mention of any additional setup, accounts, or paid components. This is a small, community driven passion project rather than a commercial release, and it is aimed at players who enjoy short, skill based boss fights, as well as anyone interested in contributing new boss designs or ideas to a simple JavaScript game.

Yoink these prompts

Prompt 1
Help me clone and run the UMBRA game locally with Node.js.
Prompt 2
Suggest new boss mechanics I could contribute to this one-button boss fight game.
Prompt 3
Explain how the single-button control scheme in UMBRA works.

Frequently asked questions

wtf is umbra?

A free open source browser game where you defeat five bosses using only a single button.

What language is umbra written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js.

How hard is umbra to set up?

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

Who is umbra for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.