Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/SaadAhmed1122/Kids_learnig_App/llms.txt

Use this file to discover all available pages before exploring further.

Learning Mode is the heart of the Kids Learning App, offering seven picture-based quiz categories designed to build recognition skills through engaging visual questions. Each category presents ten image questions with three picture answer choices, giving young learners a distraction-free, tap-to-answer experience in full-screen landscape orientation.

How the Quiz Engine Works

Every quiz category in the app is powered by the same underlying Activity structure. Understanding this shared pattern makes it easy to reason about any individual category.
1

Question & Answer Arrays

Each quiz Activity declares three core arrays at the top of the class:
  • questions[] — an int[10] array of drawable resource IDs representing the question images shown one at a time.
  • answers[][] — an int[10][3] array where each row holds the three drawable resource IDs for that question’s answer options (left, middle, right).
  • correct_answer[] — an int[10] array whose values are 0, 1, or 2, indicating which option index is the correct answer for each question.
2

Randomised Question Order

On launch, random_number_generator() fills a queue[] array with the indices 0–9 in a shuffled order. Questions are then served in that randomised sequence so no two sessions feel identical.
3

Displaying a Question

displayquestion() reads the next index from queue[], sets the question ImageView to questions[queue[counter]], and populates the three option ImageViews from the corresponding row in answers[][]. The internal counter is then advanced.
4

Handling a Tap

Every answer card is wired to onClickCard(View). Tapping any option immediately calls condition(), which:
  1. Detects which of the three option LinearLayouts was pressed.
  2. Compares it against correct_answer[queue[counter]].
  3. Increments either correct_ans_count or wrong_ans_count.
  4. Wrong answer — hides that option’s LinearLayout so the child cannot re-select it.
  5. Correct answer — illuminates the next green dot progress marker (grenc1grenc10) and calls displayquestion() to advance.
5

Completing All Ten Questions

After the tenth question is answered correctly the app checks the value Intent extra:
  • Standalone mode (value = 0 or any non-sequence value) — launches ScoringPage, passing Wrong = wrong_ans_count.
  • Sequence mode (value = 1–7) — calls finish() to return to the Sequence orchestrator without showing a separate scoring screen.

Progress Indicators

Each quiz layout contains ten green dot views (grenc1grenc10) that light up as questions are answered correctly, and ten cross ImageViews (crossimg1crossimg10) used in sequence mode to overlay checkmarks on already-completed steps via show_mark(int count).

Intent Extra: value

The value integer extra passed on the launching Intent controls how a quiz Activity behaves when all ten questions are complete.
valueModeBehaviour on Completion
0 (or not 1–7)StandaloneStarts ScoringPage with Wrong = wrong answer count
17SequenceCalls finish() to return control to the Sequence game
All quiz activities run in landscape orientation with immersive fullscreen enabled via hideSystemUI(). Make sure your device or emulator is not locked to portrait before launching a quiz.

Quiz Categories

Animals

Ten animal picture questions using drawable resources b0b9. Tap the correct animal from three picture choices.

Colors & Shapes

Ten color and shape recognition questions using drawables h0h22. Listed as “Shapes” in the Sequence game spinner.

Food

Ten fruit and food picture questions using drawable resources c0c9. Identify the correct food from three options.

Numbers

Ten number recognition questions using drawable resources n0n9. Match the number image to the correct answer.

Emotions

Picture-based emotion recognition quiz (EmoQuestionsActivity). Part of the seven-category sequence.

Travel

Transport and travel scene quiz (TravelAct). Part of the seven-category sequence.

Vehicles

Vehicle identification quiz (Vehicals_Act). Part of the seven-category sequence.

Build docs developers (and LLMs) love