Ashfolk

A god simulator about the first tribes on a floating island. Free in your browser.

Play · Features · Getting started · Architecture · Roadmap · Contributing · Sponsor

https://github.com/user-attachments/assets/bc99af11-0acd-4cca-85cc-39c3b5a4b256

Ashfolk is a free god simulator in your browser. Shape a floating island, call rain and fire, and watch its first tribes grow from the Stone Age to the Iron Age.

Features

• Island. Generated from a seed, with rivers, lakes, waterfalls, swamps, biomes, seasons and snow.
• Tribes. People gather, hunt, farm and build, and grow from the Stone Age to the Iron Age.
• Feuds. Tribes raid each other over land and later make peace.
• Wildlife. Herds of deer, mammoths and ibex, hares, and wolf packs that hunt them.
• Powers. Fire, lightning, rain, snow, meteors, earthquakes, terraforming and more.
• Healing land. Burnt land grows back, and craters fill into lakes.
• Saves. Worlds save in the browser on their own.

Stack

• App: Bun, Vite, React, TypeScript
• Graphics: three.js with WebGPU and TSL
• Interface: Base UI, Tailwind CSS, Zustand
• Data: Zod, Comlink
• Tooling: Biome, Knip, Vitest, Playwright, Lefthook
• Hosting: Cloudflare Workers

Getting started

You need Bun 1.4 or later and a browser with WebGPU.

git clone https://github.com/imsvidskiy/ashfolk.git
cd ashfolk
bun install
bun run dev                                           # http://localhost:5173

CONTRIBUTING.md has the other scripts, the checks and the code style.

Architecture

src/
  shared/      math, seeded random, noise
  content/     game data: plants, animals, buildings, powers
  world/       world grid shared by simulation and renderer
  generation/  island generation from a seed
  simulation/  nature, animals and tribes
  workers/     simulation worker
  game/        session, camera, input
  audio/       sound engine, ambience, cues and music
  models/      procedural meshes and animation
  rendering/   WebGPU renderer
  design/      design system
  features/    interface features
  app/         app shell, start and loading screens
worker/        Cloudflare Worker: redirects to ashfolk.com, films in ranges
tests/         Playwright smoke tests and screenshot scenes
scripts/       sound encoding

The simulation runs in a Web Worker. The renderer and the HUD read its frames and send commands back. AGENTS.md has the rules that keep these parts apart.

Sponsor

Ashfolk is free and open source. If you enjoy it, you can support it in two ways:

• Supporter membership on Whop, $9 a month. It pays for development, hosting, art and sound. Cancel any time.
• GitHub Sponsors, with your GitHub account.

The Sponsor button in the game opens the Whop membership.

Star history

License

The code is MIT. The sounds and music in src/audio/sounds are not covered by it: they were made for Ashfolk with ElevenLabs, and all rights to them are reserved.