Skip to main content
Public
README.md 1.79 KB

Appsgm Runner

Appsgm Runner is a high-octane, retro-futuristic 3D runner built with React and Three.js. Race through a stunning synthwave cosmos, collect letters to power up, and survive waves of alien attacks.

๐Ÿš€ Features

  • Synthwave Aesthetic: Beautiful 3D environment with glowing neon grids, a retro sun, and post-processing effects.
  • Dynamic Difficulty: The game speeds up as you collect letters. Levels expand with more lanes and tougher obstacles.
  • Shop System: Spend collected gems on permanent upgrades like Double Jump, Max Life, or Immortality.
  • Enemies: Encounter UFOs that fire laser missiles in later levels.
  • Responsive Design: Optimized for both desktop and mobile (swipe/touch) play.
  • ๐Ÿ› ๏ธ Tech Stack

  • Framework: React 19
  • 3D Engine: React Three Fiber / Three.js
  • State Management: Zustand
  • Styling: Tailwind CSS
  • Icons: Lucide React
  • Post-processing: @react-three/postprocessing
  • ๐Ÿ“ฆ Installation

    Follow these steps to set up the project locally:

    1. Clone the repository:

    BASH
    1
    2
       git clone <repository-url>
    

    cd appsgm-runner

    2. Install dependencies: Using npm:

    BASH
    1
       npm install

    Or using yarn:

    BASH
    1
       yarn install

    3. Start the development server:

    BASH
    1
       npm run dev

    Open http://localhost:5173 in your browser.

    4. Build for production:

    BASH
    1
       npm run build

    ๐ŸŽฎ Controls

    Desktop

  • Left / Right Arrows: Move between lanes.
  • Up Arrow / W: Jump (Double Jump available via shop).
  • Space / Enter: Activate Immortality (once purchased).
  • Mobile

  • Swipe Left / Right: Move between lanes.
  • Swipe Up: Jump.
  • Tap: Activate Immortality (once purchased).
  • ๐Ÿ“„ License

    SPDX-License-Identifier: Apache-2.0

    About

    A retro-futuristic 3D runner game with synthwave aesthetics where you race through neon grids, collect letters, and avoid alien attacks in an ever-accelerating cosmic environment.


    19 files
    4 folders
    81.46 KB total size
    0 open issues
    0 open pull requests
    0 watchers
    0 forks
    0 stars
    34 views
    Updated 5 days ago
    Languages
    TypeScript 97.7%
    HTML 2.3%
    CSS 0.0%