🧩 Code Quest - Hidden Picture Adventure ✨🖼️

An educational Android game that makes learning to code fun for kids! 🚀
Solve beginner-friendly coding puzzles, reveal hidden picture pieces, and celebrate progress. 🎉
A safe, ad-free environment that sparks curiosity and builds programming confidence. 👩‍💻👨‍💻

---

🚀 Overview

Code Quest is an exciting educational game where kids solve simple programming challenges such as completing code lines, dragging blocks into place, and fixing small errors.
Each correct answer unlocks a piece of a hidden picture puzzle! With colorful visuals, cheerful sounds, and bite-sized coding lessons, learning programming basics has never been this fun.

---

🎮 Game Structure

Screen	Description
Main Menu	Start a new adventure, check progress, adjust settings
Challenge View	Solve coding puzzles with a drag & drop interface
Picture Reveal	Watch hidden image pieces appear after each success
Completion Screen	Celebrate victory and view the full hidden picture

---

✨ Core Features

• 🧩 10 Progressive Challenges – From basic syntax to simple logic
• 🖼️ Hidden Picture Reveals – Unlock pieces with each success
• 🎨 Kid-Friendly Interface – Bright colors & smooth animations
• 👆 Drag & Drop Coding – Intuitive touch controls for young learners
• 🎵 Encouraging Sound Effects – Positive feedback every step
• 📚 Educational Content – Real coding concepts simplified for kids
• 🚫 Ad-Free & Safe – A distraction-free learning environment

---

🎮 How to Play

1. Read the Challenge – Each level presents a coding task
2. Drag & Drop – Move blocks to complete the solution
3. Submit Answer – Tap the check button to verify your code
4. Reveal Picture – A hidden piece appears when you succeed
5. Progress Forward – Solve all 10 challenges to complete the picture

---

📚 Programming Concepts Covered

• Variables & Data Types – Understanding coding building blocks
• Sequential Logic – Step-by-step thinking
• Conditional Statements – Basic if/then logic
• Loops & Repetition – Simple iteration concepts
• Debugging Skills – Finding & fixing small errors

---

🛠️ Technologies Used

• Android Studio (Java)
• Custom Views for coding interface
• Animation APIs for smooth reveals
• Canvas Drawing for puzzle pieces
• SharedPreferences for progress tracking

---

🛠️ Getting Started

Prerequisites

• Android Studio (Flamingo or newer)
• Minimum SDK: 21 (Android 5.0 Lollipop)
• Target SDK: 34

Installation

1- git clone https://github.com/yourusername/code-quest-adventure.git

2-Open the project in Android Studio

3-Sync Gradle files

4-Click Run to build & install on a device/emulator

5-Start coding and reveal your first picture! 🚀

📝 Development Roadmap & Commit History

Step	Commit Name	Description
1	feat: initial project setup	Created Android project structure
2	feat: main menu implementation	Added welcome screen and navigation
3	feat: challenge data model	Created Challenge class & sample data
4	feat: drag and drop interface	Implemented interactive coding blocks
5	feat: hidden picture system	Added picture reveal mechanics
6	feat: progress tracking	Implemented challenge completion logic
7	feat: sound effects integration	Added encouraging audio feedback
8	feat: animation enhancements	Smooth transitions and reveals
9	feat: completion celebration	Victory screen with full picture
10	docs: comprehensive README	Added documentation & setup guide

🧩 Code Implementation

Project Structure
app/
├── src/main/java/com/codequest/adventure/
│   ├── MainActivity.java
│   ├── GameActivity.java
│   ├── models/
│   │   ├── Challenge.java
│   │   └── CodeBlock.java
│   ├── views/
│   │   ├── CodeChallengeView.java
│   │   ├── HiddenPictureView.java
│   │   └── DraggableCodeBlock.java
│   └── utils/
│       ├── GameLogic.java
│       └── SoundManager.java
├── src/main/res/
│   ├── layout/
│   ├── drawable/
│   ├── raw/ (audio files)
│   └── values/
└── src/main/assets/ (hidden pictures)

🎥 Demo

🎵 Music & Audio Credits

All background music and sound effects have been properly audited for copyright and licensing compliance:

• Success Sound Effect by FoxBoyTails from Pixabay

• Error Sound Effect by freesound_community from Pixabay

• Victory Sound Effect by freesound_community from Pixabay

• Additional Sound Effect by Gaston A-P from Pixabay

Audio assets are released under a license that allows free use in personal and commercial projects without attribution (attribution added voluntarily).

📩 Contact & Support

Questions or ideas? Feel free to reach out via GitHub issues or pull requests!