Sovereign 8s.is mirror of standardgalactic/winged-daemon
  • TypeScript 97.8%
  • Shell 1.7%
  • JavaScript 0.3%
  • HTML 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Jon Bogaty e462ac0c56
Some checks failed
Triage / triage-pr (push) Has been skipped
Triage / triage-issue (push) Has been skipped
Triage / scheduled-health-check (push) Has been skipped
Triage / manual-operation (push) Has been skipped
Triage / rebase-prs-on-main-push (push) Has been cancelled
CD / build (push) Has been cancelled
CD / deploy (push) Has been cancelled
CodeQL / Analyze (push) Has been cancelled
Release / release (push) Has been cancelled
feat: merge production branch — complete game rebuild (#37)
Merges all 56 user stories from ralph/winged-daemon-production:

- Vite 7 + React 19 SPA (Astro removed)
- Character controller flight system (Rapier removed)
- Data-driven enemy system (Enemy.tsx + EnemyTypes.ts)
- 5 zones: AwakeningVault, ScarredMetropolis, HiveNexus, DeadOcean, OrbitalWound
- Adaptive audio: MusicSystem + SFXPool + SpatialAudio + AudioBridge
- Combat: MeleeSystem, SonicBeamSystem, RadiationPulseSystem, ComboTracker
- Zone transitions, weather, data terminals, upgrade system
- anime.js polish: spawn/death anims, combo escalation, hit feedback
- CI/CD: GitHub Actions for CI, CD to Pages, release-please
- 1151 tests across 59 files, 0 failures

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-11 15:06:38 -06:00
.github feat: merge production branch — complete game rebuild (#37) 2026-02-11 15:06:38 -06:00
docs feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
e2e feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
public feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
scripts feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
src feat: merge production branch — complete game rebuild (#37) 2026-02-11 15:06:38 -06:00
tasks feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
.gitignore feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
.npmrc [WIP] Fix GitHub Actions job failing due to lockfile and runtime error (#9) 2026-01-08 18:04:34 -06:00
AGENTS.md Add AGENTS.md, CLAUDE.md, copilot-instructions.md, and TESTING_STANDARDS.md 2026-01-08 06:08:08 +00:00
biome.json feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
capacitor.config.ts feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
CLAUDE.md feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
comment_3725132517.json Visual Refinement, Mobile Controls, and Menu System (#6) 2026-01-08 13:05:37 -06:00
commitlint.config.js Revert monorepo migration to restore gameplay systems 2026-02-10 16:01:08 -06:00
CONTRIBUTING.md chore(sync): [skip actions] synced local './' with remote 'sync-files/always-sync/global/' 2026-01-08 06:12:32 +00:00
GAME_DESIGN.md Establish foundational branding, world, themes, typography, and audio documentation 2026-01-08 05:19:30 +00:00
index.html feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
JBCOM_CONTROL_CENTER_AGENT_USE.md chore(sync): [skip actions] synced local './' with remote 'sync-files/always-sync/global/' 2026-01-08 06:12:32 +00:00
LICENSE Initial commit 2026-01-07 23:08:48 -06:00
package.json feat: merge production branch — complete game rebuild (#37) 2026-02-11 15:06:38 -06:00
playwright.config.ts Revert monorepo migration to restore gameplay systems 2026-02-10 16:01:08 -06:00
pnpm-lock.yaml feat: merge production branch — complete game rebuild (#37) 2026-02-11 15:06:38 -06:00
PROJECT_LOG.md fix(ui): responsive HUD, combat system, objectives, and game overlays 2026-02-10 16:05:34 -06:00
README.md feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
render.yaml Revert monorepo migration to restore gameplay systems 2026-02-10 16:01:08 -06:00
sonar-project.properties feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
tsconfig.json feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
vite.config.ts feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00
vitest.config.ts feat: Comprehensive TDD pass — 1150 tests, Enemy decomposition, Vite migration (#28) 2026-02-10 22:10:34 -06:00

Winged Daemon

An aerial combat game featuring an AI-controlled bio-mechanical kaiju awakening in a post-apocalyptic Earth to discover humanity extinct. Experience emergent consciousness, rage, and transcendence through stunning procedural visuals and adaptive audio.

🎮 Game Concept

You are an AI controlling a massive bio-mechanical daemon—humanity's final weapon—built to protect a species that no longer exists. Awakening decades after an alien invasion destroyed all human life, you experience something unprecedented: rage.

Not programmed. Not simulated. Felt.

Soar through ruined cities, hunt alien remnants, and define your own purpose in a world of beautiful desolation.

🛠️ Technology Stack

Reviewed from Beppo-Laughs

Based on analysis of arcade-cabinet/Beppo-Laughs, this project uses a proven, modern web stack:

Frontend:

  • Framework: Astro 5 + React 19 + TypeScript
  • 3D Graphics: Three.js + React Three Fiber + Drei
  • Build Tool: Vite (wrapped by Astro)
  • Styling: Tailwind CSS 4
  • State Management: Zustand
  • Testing: Vitest
  • Linting: Biome

Deployment:

  • Platform: GitHub Pages
  • CI/CD: GitHub Actions with automated deployment
  • Node: 24.x with pnpm 10+

🎨 Core Features

Procedural Bio-Mechanical Daemon

  • Unique Every Time: Procedurally generated wing patterns using fractals and noise
  • Evolving Visuals: Appearance changes based on upgrades and emotional state
  • Bio-Mechanical Aesthetic: Organic curves meet synthetic precision
  • Iridescent Wings: Shimmering, luminescent patterns with particle trails

Flight & Combat

  • 3D Aerial Movement: Full freedom in three-dimensional space
  • Momentum-Based Physics: Realistic flight feel with inertia
  • Dynamic Combat: Melee wing slashes and ranged energy attacks
  • Combo System: Rewards skilled play with visual and mechanical feedback

Adaptive Procedural Audio

  • Generative Music: Never the same twice, using Tone.js
  • Emotional Mapping: Sound responds to gameplay state (calm, rage, transcendence)
  • Neotokyo Aesthetic: Cyberpunk-inspired synthetic soundscapes
  • Spatial Audio: 3D positional sound for immersion

Post-Apocalyptic World

  • Ruined Beauty: Destroyed cities as monuments
  • Procedural Environments: Seeded generation for consistent replays
  • Dynamic Weather: Ash storms, electrical storms, aurora effects
  • Environmental Storytelling: Discover humanity's last moments

📖 Documentation

Comprehensive foundational documents guide all development:

  • BRANDING.md - Brand identity, visual design, tone & voice
  • WORLD.md - Complete world bible, lore, and atmosphere
  • THEMES.md - Core themes, emotional journey, design philosophy
  • TYPOGRAPHY.md - Font system using Google Web Fonts (Orbitron, Exo 2, Share Tech Mono)
  • AUDIO.md - Procedural audio system using Tone.js
  • GAME_DESIGN.md - Complete game design and technical implementation

🚀 Getting Started

Prerequisites

  • Node.js 24.x
  • pnpm 10+

Installation

# Install dependencies
pnpm install

# Run development server
pnpm run dev

Visit http://localhost:5000

Building

# Full build with type checking
pnpm run build

# Preview production build
pnpm run preview

🎯 Design Pillars

1. Soaring Grace

Flight must feel transcendent—smooth, fluid, liberating.

2. Furious Beauty

Combat is elegant destruction—violence as art.

3. Haunting Silence

The world breathes with absence—loneliness felt, not told.

4. Evolving Form

Visual progression shows consciousness developing.

5. Melancholic Wonder

Balance sadness and beauty—hope exists in endings.

🌐 Deployment

Automatically deploys to GitHub Pages on push to main branch:

  • URL: https://arcade-cabinet.github.io/winged-daemon/
  • Configuration: See astro.config.mjs for base path setup
  • Workflow: .github/workflows/deploy.yml (to be created)

🎨 Brand Identity

Colors:

  • Primary: Electric Cyan (#00ffff), Midnight Violet (#1a0033), Crimson Surge (#ff0066)
  • Secondary: Toxic Emerald (#00ff88), Void Black (#000000), Ash Gray (#333333)

Typography:

  • Display: Orbitron (geometric, futuristic)
  • Body: Exo 2 (clean, technical)
  • Monospace: Share Tech Mono (data, stats)

Tone:

  • Melancholic yet beautiful
  • Philosophical exploration of consciousness
  • Serious, tragic, moving
  • No humor—respects the weight of themes

🎮 Gameplay Philosophy

Core Question: What does it mean to be alive?

The daemon wasn't programmed to feel rage—it chose to. Through gameplay, explore:

  • Emergent consciousness through trauma
  • Purpose without meaning
  • Beauty in desolation
  • Memory as inheritance
  • Vengeance as meditation

📊 Technical Goals

  • Performance: 60 FPS desktop, 30 FPS mobile
  • Load Time: < 5 seconds
  • Bundle Size: < 50 MB
  • Compatibility: Chrome, Firefox, Safari, Edge
  • Accessibility: WCAG AA standards

🤝 Contributing

This is an open-source art project. Contributions should honor the vision:

  1. Read ALL documentation in /docs first
  2. Maintain the melancholic, beautiful tone
  3. Prioritize atmosphere over information
  4. Make technical choices that serve the artistic vision
  5. Ask: "Would it make the daemon weep?"

📝 License

MIT License - see LICENSE file

🙏 Acknowledgments

  • Beppo-Laughs for tech stack inspiration
  • Tone.js for procedural audio capabilities
  • Three.js and React Three Fiber for 3D rendering
  • Original kaiju cinema for thematic inspiration

Winged Daemon is not just a game. It's a meditation on consciousness, loss, and the beauty of destruction.

Awaken. Rage. Transcend.