Skip to content

Repository files navigation

🥕 Carrot Flight

A fun, interactive 3D flight game built with React, Vite, Three.js, and TailwindCSS. Pilot a magical carrot through an endless storm, collecting clouds and navigating weather conditions!

🎮 Gameplay

  • ☁️ Collect Clouds - Gather clouds during clear weather to increase your score
  • Avoid Storms - When lightning strikes, navigate to safety and survival
  • 🎯 Control Your Flight - Use keyboard controls (WASD/Arrows) or tilt your mobile device
  • 👑 Boss Challenge - Survive the boss cloud for ultimate victory

⚙️ Tech Stack

  • React 19 - Interactive UI framework
  • Three.js - 3D graphics engine
  • Vite - Lightning-fast build tool
  • TypeScript - Type-safe development
  • Tailwind CSS - Modern styling
  • Web Audio API - Immersive sound effects

🚀 Getting Started

Prerequisites

  • Node.js v16 or higher
  • npm or yarn

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/carrot-flight.git
    cd carrot-flight
  2. Install dependencies:

    npm install
  3. Start development server:

    npm run dev

Build for Production

npm run build

Preview the production build:

npm run preview

📦 Available Commands

Command Description
npm run dev Start development server
npm run build Build optimized production bundle
npm run preview Preview production build locally
npm run clean Remove build artifacts
npm run lint TypeScript type checking

🎨 Features

  • Immersive 3D Graphics - Rendered with Three.js
  • 🌩️ Dynamic Weather System - Clear skies and storm conditions
  • 🔊 Spatial Audio - Dynamic sound effects and ambient audio
  • 📱 Responsive Design - Desktop and mobile support
  • ⌨️ Multiple Input Methods - Keyboard, mouse, and touch controls
  • 🎯 Engaging Gameplay - Progressive difficulty and scoring system

🌐 Deployment

This project is ready for deployment to any static hosting platform:

  • Vercel - vercel deploy
  • Netlify - Drop dist folder
  • GitHub Pages - Configure GitHub Actions
  • Docker - Container-ready

📄 License

This project is open source and available under the MIT License.

🎯 Contributing

Contributions are welcome! Feel free to submit issues and pull requests.


Made with ❤️ by Carrot Flight Team

About

Carrot Flight - Meditation Flight Game

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages