Skip to content

colaola20/learn_how_to_code_game

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐢 Turtle Trail

A fun mobile app that teaches kids the basics of programming through puzzles, drag-and-drop actions, and interactive challenges.

📚 Overview

Turtle Trail is an educational Android app designed to introduce children to fundamental programming concepts in a playful and visual way. Kids learn by dragging commands, planning sequences, and guiding a turtle through colorful levels.

The app includes user authentication, dynamic level generation, and a fully scalable UI that works on any Android device.


✨ Features

🎮 Gameplay

  • 🧩 Multiple handcrafted puzzle levels
  • 🤖 AI-generated new levels using ChatGPT API
  • ✋ Drag-and-drop actions (move left, right, up, down)
  • 🔊 Real-time success & error feedback
  • 🎨 Kid-friendly design and animations
  • 🎯 Level progression system

🔐 Authentication & Data

  • 🔥 Firebase Authentication (Email/Password)
  • 💾 Local persistence with DataStore
Screenshot 2025-12-11 at 7 11 37 PM Screenshot 2025-12-11 at 7 11 44 PM

🤖 AI Integration (ChatGPT API)

Turtle Trail uses the ChatGPT API to generate:

  • Integrated ChatGPT API
  • Automatically generates new level layouts
  • System can scale to unlimited levels
  • Ensures variety and replayability
Screenshot 2025-12-11 at 7 19 37 PM Screenshot 2025-12-11 at 7 19 43 PM Screenshot 2025-12-11 at 7 19 47 PM

This allows infinite replayability and personalized difficulty.

📱 Fully Scalable UI

  • 100% responsive Jetpack Compose UI
  • Works on all phones, tablets, Chromebooks
  • Drag zones, grid cells, and movement paths automatically scale
  • No stretched images or broken layouts
  • Uses dp-based grid + density-aware drawing
  • Consistent UI across all DPI/resolutions
Screenshot 2025-12-11 at 7 24 20 PM
Screen.Recording.2025-12-11.at.7.24.59.PM.mov

🛠️ Tech Stack

  • Kotlin
  • Jetpack Compose UI
  • Firebase Authentication
  • ChatGPT API (OpenAI)
  • MVVM Architecture
  • DataStore
  • Custom drag-and-drop engine
  • Canvas drawing for paths

🚀 Getting Started

Clone the repository

https://github.com/colaola20/learn_how_to_code_game.git

Open in Android Studio

  • Launch Android Studio
  • Select Open Project
  • Choose the cloned folder
  • Run on a device or emulator

🙌 Contributing

  • Contributions and ideas are welcome!
  • Feel free to open an issue or submit a pull request.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages