Skip to content

TerraNanners

TerraNanners is a multiplayer world-building game powered by your imagination.

Code Video Cerebral Valley

Core trick

Gemini image editing turns a room photo into a pixel-art playable room, with saved rooms linking into shared worlds.

Tags

creative/musicvision

Description

TerraNanners is a multiplayer world-building game powered by your imagination. Using nano banana, you can take pictures of any place : your room, a park, a cafe, and instantly generate a playable, Pokémon-style pixel art level. Connect your rooms to design vast worlds, then share them with friends for a truly social and creative exploration adventure. Designed for nostalgia and virality!
Gautham-G/TerraNanners★ 41 forksTypeScriptCreated Sep 6, 2025 · last push Sep 6, 2025

README excerpt

# 🍌 TerraNanners!

Google NanoBanana Hackathon submission

Check this out : https://www.youtube.com/watch?v=IHgCfvnW6NA

Transform your photos into playable game worlds with AI! Create immersive room-based adventures where you control a banana character exploring AI-generated environments.

## ✨ Features

- **🖼️ AI-Powered Room Generation**: Upload photos and watch AI transform them into game environments
- **🗺️ World Building**: Connect rooms to create expansive, interconnected game worlds  
- **🎮 Interactive Gameplay**: Control a banana character through your created worlds
- **💾 Persistent Storage**: Save and load your creations locally
- **🎨 Beautiful UI**: Smooth animations and modern design

## 🚀 Quick Start

1. **Install Dependencies**
   ```bash
   npm install
   ```

2. **Set up Gemini API**
   - Create a `.env.local` file in the root directory
   - Add your Gemini API key:
   ```
   VITE_GEMINI_API_KEY=your_actual_api_key_here
   ```

3. **Start the Application**
   ```bash
   npm run dev:full
   ```
   This starts both the frontend (port 5173) and backend (port 3001) servers.

4. **Open Browser**
   - Navigate to http://localhost:5173
   - Start creating your first world!

## 🎯 How to Use

1. **Generate Rooms**: 
   - Go to the Generator page
   - Upload an image
   - Let AI create a game room with description and visual style

2. **Build Worlds**: 
   - Use the World Editor to connect your rooms
   - Create pathways between different environments
   - Design your

Team