Shadowgraph
TrendingBuzzAbout
Sign in

AndyTheFactory/nether_earth

My re-implementation of ZX Spectrum's NETHER EARTH game

Python

0

438 commits

updated Oct 7, 2026

See the code

See what people are saying

SourceMessageScoreDate

I used Claude Code as the implementation team for a ZX Spectrum remake. (r/ClaudeAI)

I spent three weeks rebuilding Nether Earth, a 1987 ZX Spectrum strategy game I grew up with. The unusual part: I didn't write any of the implementation code myself. I wrote and edited the specs, made the gameplay decisions, and playtested the milestones. Claude Code did the implementation through…

2

Oct 7, 2026

README

Nether Earth

Original ZX Spectrum Screenshot: Nether Earth ZX Spectrum

Browser-based multiplayer clone of the ZX Spectrum version of Nether Earth:

Screenshot from the Remake

The repository is specification-driven. Read AGENTS.md and _specs/ before implementation work.

Development setup

Python

Requires Python 3.12+.

python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e './engine[dev]' -e './backend[dev]'
make python-check

Run the backend:

uvicorn app.main:app --app-dir backend --reload

Health check: http://localhost:8000/health.

Frontend

Requires Node.js 24+.

cd frontend
npm install
npm run protocol:validate
npm run protocol:generate
npm run typecheck
npm run build
npm run dev

Production deployment

Single-VPS Docker Compose stack (gateway Nginx, static frontend, FastAPI backend, host replay directory). Configure deploy/.env from deploy/.env.example, then:

docker compose -f deploy/docker-compose.yml --env-file deploy/.env up -d --build --wait
  • Operations (TLS, update, rollback, logs, backups): docs/operations/runbook.md
  • Release procedure and gate: docs/release/v1-release-checklist.md
  • Hardening evidence: docs/milestone-10/

Quality commands

make python-check
make frontend-check
make compose-check   # compose config (incl. TLS override) + nginx -t
deploy/smoke.sh      # production images + gateway smoke (Docker, Node 24)
scripts/check-version.sh

CI (.github/workflows/ci.yml) runs all of these on every PR and push to main.

fastapi
games

Similar repos

salakhovilia/nornikel-hack

0

lopatin/snaketron

The code for Snaketron.io, a multiplayer competitive Snake game written with Rust and Typescript.

48

anchapin/portkit

AI-powered tool for converting Minecraft Java Edition mods to Bedrock Edition add-ons

6

PlayStratus/Stratus

An open-source game streaming service.

99

VersacheX/FastAPIAdventureInAI

0

eduardokairalla1/code-royale

A multiplayer coding game: one challenge, one clock, the best coder takes the crown.

1

kreibaum/pacosako

This code drives the pacoplay.com website where you can play Paco Ŝako.

28

NithiishSD/ai_avatar_plateform

0

AndyTheFactory/nether_earth

My re-implementation of ZX Spectrum's NETHER EARTH game

Python

0

438 commits

updated Oct 7, 2026

See the code

See what people are saying

SourceMessageScoreDate

I used Claude Code as the implementation team for a ZX Spectrum remake. (r/ClaudeAI)

I spent three weeks rebuilding Nether Earth, a 1987 ZX Spectrum strategy game I grew up with. The unusual part: I didn't write any of the implementation code myself. I wrote and edited the specs, made the gameplay decisions, and playtested the milestones. Claude Code did the implementation through…

2

Oct 7, 2026

README

Nether Earth

Original ZX Spectrum Screenshot: Nether Earth ZX Spectrum

Browser-based multiplayer clone of the ZX Spectrum version of Nether Earth:

Screenshot from the Remake

The repository is specification-driven. Read AGENTS.md and _specs/ before implementation work.

Development setup

Python

Requires Python 3.12+.

python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e './engine[dev]' -e './backend[dev]'
make python-check

Run the backend:

uvicorn app.main:app --app-dir backend --reload

Health check: http://localhost:8000/health.

Frontend

Requires Node.js 24+.

cd frontend
npm install
npm run protocol:validate
npm run protocol:generate
npm run typecheck
npm run build
npm run dev

Production deployment

Single-VPS Docker Compose stack (gateway Nginx, static frontend, FastAPI backend, host replay directory). Configure deploy/.env from deploy/.env.example, then:

docker compose -f deploy/docker-compose.yml --env-file deploy/.env up -d --build --wait
  • Operations (TLS, update, rollback, logs, backups): docs/operations/runbook.md
  • Release procedure and gate: docs/release/v1-release-checklist.md
  • Hardening evidence: docs/milestone-10/

Quality commands

make python-check
make frontend-check
make compose-check   # compose config (incl. TLS override) + nginx -t
deploy/smoke.sh      # production images + gateway smoke (Docker, Node 24)
scripts/check-version.sh

CI (.github/workflows/ci.yml) runs all of these on every PR and push to main.

fastapi
games

Similar repos

salakhovilia/nornikel-hack

0

lopatin/snaketron

The code for Snaketron.io, a multiplayer competitive Snake game written with Rust and Typescript.

48

anchapin/portkit

AI-powered tool for converting Minecraft Java Edition mods to Bedrock Edition add-ons

6

PlayStratus/Stratus

An open-source game streaming service.

99

VersacheX/FastAPIAdventureInAI

0

eduardokairalla1/code-royale

A multiplayer coding game: one challenge, one clock, the best coder takes the crown.

1

kreibaum/pacosako

This code drives the pacoplay.com website where you can play Paco Ŝako.

28

NithiishSD/ai_avatar_plateform

0