ZAMNY Client

Vite + TypeScript + Canvas 2D + ECS game client for Zombies Ate My Neighbors browser edition.

Quick Start

npm install
npm run dev          # http://localhost:5173
npm test             # vitest (ECS tests)
npm run build

Structure

src/
  engine/
    ecs.ts           # World, Entity, Component, System base
    ecs.test.ts      # 6 unit tests (green)
  systems/
    InputSystem.ts   # keyboard/touch stub
    RenderSystem.ts  # Canvas 2D stub
    PhysicsSystem.ts # movement/collision stub
  main.ts            # 60 FPS game loop + system orchestration

Key Points

• ECS core: createEntity, addComponent, query, destroyEntity
• Systems extend System and implement update(world, dt)
• Target: 60 FPS, offline single-player works without server
• Nickname UI, NetworkClient, sprite rendering: TODO

Testing

• Vitest + jsdom
• npm test runs ecs.test.ts
• Coverage target: 70% (documented in ARCHITECTURE.md §10)

See root README.md and ARCHITECTURE.md for full design.