MARZANNA HUNT

A fast-paced survival game built for the browser.

Describtion

The game takes place aboard a collapsing spaceship, where the main character awakens alone and follows a distress beacon emitted from their partner’s mask. As they move through the failing ship, the player encounters alien and monstrous entities that force difficult moral choices—each decision affecting whether the protagonist survives.

Directions (LocalHost setup)

Requirements:

- Node.js 
- npm

Steps:

1. Clone the repository
2. run 'cd SparkHacks2026'
3. run 'npm install'
4. run 'npm run dev'
5. open local host link in your browser

Gameplay

Players progress by reading the on-screen text and making choices when prompted (by clicking on them). Each decision influences the outcome of encounters and the direction of the story.

Build with

• TypeScript + React + Vite
• CSS, HTML, JavaScript
• Node.js
• JSON (for dialogue and story data)

Code Structure

/public - audio assets

/src

• components - UI and game components
• data - story line
• engine - state handling

index.html - base HTML file

package-lock.json - internal dependency info

package.json - project metadata, dependencies, and scripts

tsconfig.app.json - TypeScript configuration

tsconfig.json - App-specific TypeScript config

tsconfig.node.json - Node-specific TypeScript config

vite.config.ts - Vite build configuration

TEAM

Srinjana Chatterjee(@spaceiscool29) - UI/UX design, Backend & server setup

Ragasri Yegatella(@RagaY05) - Game logic/script, audio

Mika Kharoshka(@mkkhar & @kkhargit) - Game logic/script

Additional info for developers:

React + TypeScript + Vite

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.

Currently, two official plugins are available:

• @vitejs/plugin-react uses Babel (or oxc when used in rolldown-vite) for Fast Refresh
• @vitejs/plugin-react-swc uses SWC for Fast Refresh

React Compiler

The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see this documentation.

Expanding the ESLint configuration

If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:

export default defineConfig([
  globalIgnores(['dist']),
  {
    files: ['**/*.{ts,tsx}'],
    extends: [
      // Other configs...

      // Remove tseslint.configs.recommended and replace with this
      tseslint.configs.recommendedTypeChecked,
      // Alternatively, use this for stricter rules
      tseslint.configs.strictTypeChecked,
      // Optionally, add this for stylistic rules
      tseslint.configs.stylisticTypeChecked,

      // Other configs...
    ],
    languageOptions: {
      parserOptions: {
        project: ['./tsconfig.node.json', './tsconfig.app.json'],
        tsconfigRootDir: import.meta.dirname,
      },
      // other options...
    },
  },
])

You can also install eslint-plugin-react-x and eslint-plugin-react-dom for React-specific lint rules:

// eslint.config.js
import reactX from 'eslint-plugin-react-x'
import reactDom from 'eslint-plugin-react-dom'

export default defineConfig([
  globalIgnores(['dist']),
  {
    files: ['**/*.{ts,tsx}'],
    extends: [
      // Other configs...
      // Enable lint rules for React
      reactX.configs['recommended-typescript'],
      // Enable lint rules for React DOM
      reactDom.configs.recommended,
    ],
    languageOptions: {
      parserOptions: {
        project: ['./tsconfig.node.json', './tsconfig.app.json'],
        tsconfigRootDir: import.meta.dirname,
      },
      // other options...
    },
  },
])