Welcome to Rea’s Deep Sea Journey! This is a beautiful, highly responsive, arcade-style undersea adventure game built with React, TypeScript, Vite, and Tailwind CSS. Help Rea, an adventurous tiny fish, navigate through treacherous ocean currents, beautiful but branching coral reefs, heavy falling rocks, moving jellyfish columns, and deep sea mines.
In this update, Permadeath Undercurrent Mode is active: if Rea fails or crashes, her unlocked paths are reset, requiring a fresh start from Depth 01. Additionally, Golden Bubble Shields are triggered automatically upon colliding with glowing green marine pellets!
- Swim Upward: Tap your screen, click anywhere on the canvas, or press the Spacebar / Up Arrow key to flap Rea’s fins and swim upward. Gravity and sea drag will pull her down continuously.
- Auto Golden Shield: Keep an eye out for glowing green food pellets! Colliding with a pellet triggers an instantaneous 4.0-second Golden Shield, allowing Rea to smash right through any subsea structures or jellyfish without taking damage.
- Undercurrent Danger: Swim all the way to 100% progress to complete a depth. Watch out in Depths 5 and 7—vicious shifting horizontal currents sway Rea dynamically!
- Permadeath: Each level gives you 3 Lives. Failing any depth will reset your unlocked progress back to Depth 01!
Before running the game locally, ensure you have the following installed on your machine:
- Node.js: Version
18.xor higher (Recommended:20.xLTS) - npm: (Comes bundled with Node.js) or yarn / pnpm
- Git: To clone the repository
Choose your operating system below to set up and run the game.
- Download and install Git for Windows from git-scm.com. Follow the default wizard setup.
- Download and install Node.js (LTS recommend version) from nodejs.org. Make sure the checkbox
"Automatically install the necessary tools..."or adding Node to PATH is enabled.
Press Win + R, type cmd or powershell, and run it. Verify installations:
node -v
npm -v
git --version# Clone this repository
git clone <repository-url-here>
cd <repository-folder-name>
# Install packages & dependencies
npm install
# Start the local development server
npm run devOnce started, open your browser and navigate to http://localhost:3000.
Open your Terminal and run:
sudo apt update
sudo apt install -y git curlUsing the recommended Node.js LTS (v20):
# Download and import the NodeSource GPG key and register repository
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
# Install Node.js
sudo apt install -y nodejsVerify the installation:
node -v
npm -v# Clone the repository
git clone <repository-url-here>
cd <repository-folder-name>
# Install project dependencies
npm install
# Run the developer hot-server
npm run devOpen up your browser and visit http://localhost:3000 to start swimming!
- Open your terminal and install Homebrew if you haven't (visit brew.sh):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - Install Node.js and Git:
brew install node git
- Setup and Run:
git clone <repository-url-here> cd <repository-folder-name> npm install npm run dev
In the project directory, you can run:
Runs the app in development mode. Opens local developer server on http://localhost:3000.
Compiles and builds the production-ready static assets to the dist/ directory. Optimized and minified for swift deployment.
Locally previews your production-built distribution assets before publishing.
Checks TypeScript type-safety across compile routes without writing output files.
- React 19 - Component-based framework structure.
- Vite - Lightning-fast build tool and bundler.
- Tailwind CSS v4 - Beautiful utility styling.
- Bricolage Grotesque & Outfit Fonts - Playful yet modern typographic headings.
- Lucide React - High-contrast vector icons.
- HTML5 Canvas - Smooth, GPU-accelerated gameplay canvas with sound synthesis.
Have fun exploring the depths of the ocean! 🌊🦑 🤖 Created and designed with care.