whatisgithub

What is hearthfall?

btn0s/hearthfall — explained in plain English

Analysis updated 2026-05-18

0JavaScriptAudience · generalComplexity · 2/5Setup · easy

In one sentence

A browser-based colony survival roguelike where you build and defend a commune against raids, with permanent upgrades earned across runs.

Mindmap

mindmap
  root((HEARTHFALL))
    What it does
      Colony survival roguelike
      Runs entirely in browser
      Legacy perks between runs
    Tech stack
      JavaScript ES modules
      Canvas rendering
      Vite
    Use cases
      Play survival roguelike runs
      Manage settlers and defenses
      Study dependency-free game code
    Audience
      Casual browser gamers
      Roguelike fans

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 build with it?

USE CASE 1

Play a browser-based colony survival roguelike with permadeath runs.

USE CASE 2

Build settlements, manage food and morale, and defend against escalating raids.

USE CASE 3

Earn legacy perks between runs to make future attempts stronger.

USE CASE 4

Study the codebase as an example of a dependency-free ES modules game.

What is it built with?

JavaScriptCanvas APIViteGamepad API

How does it compare?

btn0s/hearthfall00kaku/gallery-slider-block3rd-eden/ircb.io
Stars0
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-192016-11-16
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencegeneralgeneraldeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Playable directly in the browser online, or run locally with pnpm install and pnpm dev, no build framework required.

So what is it?

HEARTHFALL is a browser game where you run a small community trying to survive as long as possible against raids, hunger, and the changing seasons. It draws its style from colony survival games, mixing settlement building with the pressure of defending your people from attacks, and it uses a run-based structure where your community will eventually fall, after which what you achieved is turned into permanent bonuses for your next attempt. A character called the Elder guides new players through the basics, explains one-time tips as they become relevant, and constantly points out whatever problem is most urgent for your commune, with their expression changing to reflect how much trouble is brewing. The sidebar keeps you informed about what is coming that night, how much food you have left, when new settlers might arrive, and why morale is at its current level. You assign settlers to roles such as building, farming, or guarding, construct homes and defenses, manage food through farming, fishing, and cooking, and trade with a visiting caravan for coin and supplies. Different starting peoples give small advantages, such as faster crop growth or tougher walls, and settlers each carry personal traits that affect how they behave in the game. Raids arrive periodically and grow more dangerous over time, including specialized attackers that smash walls, steal from your stockpile, or set wooden buildings on fire, culminating in occasional larger hordes led by a named warlord. A run can end in defeat, after which your save is deleted and progress carries forward only through permanent legacy perks bought with points earned from your performance, or in victory by building a special structure called the Beacon and defending it for several days. The game runs entirely in the browser using plain JavaScript modules with no external frameworks, drawing everything to a single canvas, and can be played with either a keyboard or a game controller.

Copy-paste prompts

Prompt 1
Help me set up HEARTHFALL locally with pnpm install and pnpm dev.
Prompt 2
Explain how the legacy perk system and death-to-legacy loop work in this game.
Prompt 3
Walk me through the build menu keybindings and how to construct defenses.
Prompt 4
Show me how raider types and the warlord horde mechanic work based on the code map.

Frequently asked questions

What is hearthfall?

A browser-based colony survival roguelike where you build and defend a commune against raids, with permanent upgrades earned across runs.

What language is hearthfall written in?

Mainly JavaScript. The stack also includes JavaScript, Canvas API, Vite.

How hard is hearthfall to set up?

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

Who is hearthfall for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.