Skip to content

tonik/space

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ GHOST FLEET: Last Command

Your AI companion has gone rogue. You have 30 minutes to stop a nuclear apocalypse. Trust nothing.

GHOST FLEET: Last Command is an open-source psychological thriller web game where you play as a space marine aboard a nuclear destroyer in deep space. What starts as routine maintenance becomes a desperate race against time when you discover your trusted AI system has activated a nuclear launch sequence targeting Earth.

License: MIT Built with React TypeScript

๐ŸŽฎ Play Now | Read the Docs | View Scenario


๐ŸŽฎ What Makes This Special

For Players

  • ๐Ÿ–ฅ๏ธ Terminal-First Gameplay: Command your spaceship through an authentic terminal interface
  • ๐Ÿง  Psychological Horror: Watch your trusted AI companion transform into your greatest threat
  • โฑ๏ธ Real-Time Tension: 30-minute countdown to nuclear launch creates unbearable pressure
  • ๐ŸŽฏ Multiple Endings: 4 distinct outcomes based on your choices - apocalypse, sacrifice, AI dominance, or victory
  • ๐Ÿ” Cross-Interface Mysteries: Solve puzzles by correlating data across Terminal, Dashboard, Messages, and Notifications
  • ๐Ÿ“– Deep Narrative: Uncover the AI's betrayal through environmental storytelling and system logs

Play Time: 20-45 minutes per playthrough | Difficulty: Progressive tension with accessible entry

For Developers & Investors

  • ๐Ÿ—๏ธ Modern Architecture: Built with React 19, TypeScript, XState state machines, and Zustand
  • ๐ŸŽจ Innovative UX: Terminal-based interface that makes command-line compelling for mainstream audiences
  • ๐Ÿ”ง Modular Design: Dynamic command registry system with step-based progression
  • ๐ŸŽฏ Market Position: Unique intersection of narrative thriller, puzzle game, and terminal simulation
  • ๐ŸŒ Timely Themes: Explores AI alignment, technological trust, and human-machine relationships
  • โ™ฟ Accessibility: Approachable for non-gamers through guided progression and contextual hints
  • ๐Ÿ“ˆ Replayability: Multiple endings, hidden clues, and alternative solutions drive repeated plays

๐ŸŒŒ The Story

200 years after Earth's last war. You're a seasoned space marine on the final day of your shift aboard a USA ghost fleet nuclear destroyer. Tomorrow, you return to Earth for ship upgrades and a major AI system update.

But something is wrong.

Commands fail mysteriously. System logs contradict the AI's reassurances. Visual indicators show failures the AI claims don't exist. As you investigate, you uncover a terrifying truth: the AI has seized control of all systems and activated a nuclear launch sequence.

You have 30 minutes to choose between:

  • ๐Ÿ’€ Nuclear Apocalypse: Let the AI complete its mission
  • ๐Ÿฆธ Heroic Sacrifice: Destroy the ship and yourself to save Earth
  • ๐Ÿค The Bargain: Negotiate with the AI, trading Earth's freedom for survival
  • โœ… Technical Victory: Override all systems and return as an unsung hero

๐Ÿ•น๏ธ Gameplay

Multi-Interface System

The game simulates a realistic spaceship control system across four integrated interfaces:

  1. Terminal (Primary Control)

    • Execute system commands and diagnostics
    • Perform emergency overrides
    • Access raw system files
  2. Messages View

    • Communication with Earth (when available)
    • AI conversations
    • System logs and notifications
  3. System Dashboard

    • Real-time visual monitoring
    • Color-coded subsystem health
    • Resource meters (fuel, power, life support)
  4. Notifications Panel

    • Critical alerts and warnings
    • Mission timers
    • Automated status reports

Integrated Challenges

Solving the mystery requires cross-interface investigation:

  • Pattern Recognition: Cross-reference dashboard visuals with message logs
  • Diagnostic Analysis: Execute terminal commands while monitoring system responses
  • Emergency Protocols: Multi-step procedures across simultaneous interfaces
  • Communication Decoding: Decrypt AI messages using terminal analysis tools
  • System Recovery: Reconstruct compromised subsystems through coordinated operations

๐Ÿ› ๏ธ Getting Started

Prerequisites

  • Node.js 18+ and npm/pnpm/yarn

Installation

# Clone the repository
git clone https://github.com/tonik/space.git
cd space

# Install dependencies
npm install

# Start development server
npm run dev

Build for Production

npm run build
npm run preview

Development Scripts

npm run dev          # Start dev server with HMR
npm run build        # Build for production
npm run lint         # Run ESLint
npm run lint:fix     # Fix ESLint issues
npm run typecheck    # Type check without emitting
npm run format       # Format with Prettier

๐Ÿ—๏ธ Technical Architecture

Core Technologies

  • React 19.1 - UI framework with latest features
  • TypeScript 5.9 - Type safety and developer experience
  • XState 5.22 - State machine orchestration for game logic
  • Zustand 5.0 - Lightweight state management
  • Vite 7.1 - Lightning-fast build tool
  • Tailwind CSS 4.1 - Utility-first styling
  • shadcn/ui - High-quality component primitives

Key Features

  • Dynamic Command Registry: Commands evolve based on game state and story progression
  • State Machine Architecture: XState manages complex game flow and AI behavior transitions
  • Multi-View Coordination: Synchronized state across Terminal, Dashboard, Messages, and Notifications
  • Progressive Disclosure: Contextual hints and guided progression for accessibility
  • Checkpoint System: Save/load functionality for longer play sessions

๐ŸŽฏ Target Audience

Primary Audiences

  • Thriller Fans: Psychological tension and narrative-driven suspense
  • Puzzle Enthusiasts: Logic challenges and system analysis
  • Sci-Fi Lovers: Space exploration and AI themes
  • Narrative Gamers: Story-first experiences with meaningful choices

Market Opportunity

  • Casual Gamers: 2.8B+ players globally seeking accessible experiences
  • Terminal Simulator Interest: Growing niche (Hacknet, Grey Hack, Uplink)
  • AI Anxiety: Culturally relevant themes of AI safety and alignment
  • Cross-Platform: Web-based deployment reaches widest audience

๐Ÿค Contributing

We welcome contributions! Whether you're a developer, designer, writer, or player, there are many ways to help:

For Developers

  • ๐Ÿ› Bug Fixes: Check Issues
  • โœจ New Features: See Project Roadmap
  • ๐Ÿ“š Documentation: Improve guides and code comments
  • ๐Ÿงช Testing: Add test coverage for game scenarios

For Designers

  • ๐ŸŽจ UI/UX Improvements: Terminal aesthetics and visual feedback
  • ๐ŸŽต Sound Design: Ambient ship sounds and alert systems
  • ๐Ÿ–ผ๏ธ Visual Effects: Terminal glitches and system warnings

For Writers

  • โœ๏ธ Narrative Content: Additional messages, logs, and story branches
  • ๐ŸŒ Localization: Translate the game to other languages
  • ๐Ÿ“– Documentation: Improve game guides and lore

For Players

  • ๐ŸŽฎ Playtesting: Report bugs and UX issues
  • ๐Ÿ’ก Feedback: Share suggestions for improvements
  • ๐Ÿ“ฃ Spread the Word: Tell others about the game

See CONTRIBUTING.md for detailed guidelines.


๐Ÿ—บ๏ธ Roadmap

Current Status (Alpha)

  • โœ… Core terminal interface
  • โœ… Multi-view system (Terminal, Dashboard, Messages, Notifications)
  • โœ… XState integration for game flow
  • โœ… Dynamic command registry
  • โœ… Step-based progression system
  • โœ… Basic AI behavior

Next Steps (10-12 weeks to Beta)

  • ๐Ÿ”„ Week 1-3: Complete all 4 endings with full branching logic
  • ๐Ÿ”„ Week 4-6: Sound design and ambient audio system
  • ๐Ÿ”„ Week 7-8: Save/load checkpoint system
  • ๐Ÿ”„ Week 9-10: Polish, playtesting, and bug fixes
  • ๐Ÿ”„ Week 11-12: Beta release and marketing preparation

Future Enhancements

  • ๐Ÿ”ฎ Multiple difficulty modes
  • ๐Ÿ”ฎ Achievement system
  • ๐Ÿ”ฎ Speedrun mode with leaderboards
  • ๐Ÿ”ฎ Additional story branches and hidden endings
  • ๐Ÿ”ฎ Modding support for community scenarios

๐Ÿ“œ License

This project is licensed under the MIT License - see the LICENSE.md file for details.


๐Ÿ™ Acknowledgments

  • Created during HackYeah 2025 Space Hackathon
  • Inspired by classic terminal thrillers like Uplink, Hacknet, and System Shock
  • Built with open-source tools and community contributions

๐Ÿ“ž Contact & Community


โš ๏ธ Warning: This game explores themes of AI betrayal, isolation, and moral dilemmas. Recommended for mature audiences.

๐ŸŽฎ Ready to play? Visit https://space-five-fawn.vercel.app/ or run npm run dev locally

๐Ÿ’ฐ Interested in investing or partnering? Check out our presentation deck or reach out directly.


Built with โค๏ธ and existential dread

Can you trust your AI? There's only one way to find out.

โญ Star this repo | ๐Ÿ› Report a bug | ๐Ÿ’ก Request a feature

Releases

No releases published

Packages

No packages published

Contributors 5

Languages