Track 1 Guide

Google AI Studio Foundation 🌐🎨

Early-Bird Package ($99 AUD) — Designed for kids (ages 7–10) and parents to learn how to write a custom game using Google AI Studio for content generation.

Parent Setup (The Toolkit)

Parents or guides must complete these configuration steps before starting the lesson:

  • Generate a Gemini API Key:
    • Visit Google AI Studio.
    • Log in with your Google account.
    • Click "Get API Key" and generate a new API key.
  • Setup Editor & Workspace:
    • Install a lightweight text editor like VS Code or Notepad++.
    • Clone the open-source repository to your computer:
      git clone https://github.com/your-repo/TimesTableGame.git
    • Ensure `pnpm` is installed by running `pnpm --version`. Launch the dev server locally to confirm it runs:
      pnpm install
      pnpm dev

Kids & Designers (Creative Content)

Now, the student takes over as the **Creative Director**!

Mission: Build Your Custom knowledge.json

Instead of times tables, let's create trivia questions about your favorite topics, such as Minecraft, dinosaurs, or mythology.

  1. Open **Google AI Studio** in your browser.
  2. Choose either **Gemini 1.5 Pro** or **Flash** as your active model.
  3. Click the **Microphone icon** next to the chat bar to dictate your prompt.
  4. Speak this exact prompt clearly:
"Act as an expert content database generator. Generate a JSON list of 10 trivia questions about [Your Chosen Topic]. Each item must look like this: a unique contentId starting with 'custom-', a subjectType of 'trivia', a questionPrompt string, a correctAnswer string, and a list of 3 incorrect decoyAnswers strings. Return only valid JSON."

Example Output:

Ensure the generated JSON matches this structural format:

[
  {
    "contentId": "custom-dino-1",
    "subjectType": "trivia",
    "questionPrompt": "Which dinosaur had three horns on its face?",
    "correctAnswer": "Triceratops",
    "decoyAnswers": ["T-Rex", "Stegosaurus", "Velociraptor"]
  }
]

Cooperative Integration (Copy & Paste)

  1. Create a new file named `knowledge.json` inside the `public/data/` folder in your code editor.
    Path: `apps/web/public/data/knowledge.json`
  2. Copy the JSON code block from Google AI Studio and paste it directly into `knowledge.json`. Save the file.
  3. Update your content settings in the editor to point to your new file. (Ask the AI Studio helper: "How do I edit my load settings to point to my new knowledge.json file?").

Cooperative Assignments

Assignment 1: Multi-Subject Mix

Use Google AI Studio to generate a `knowledge.json` file combining two separate themes (e.g., 5 questions about Marvel superheroes and 5 questions about space planets).

Tip: Double-check that your `subjectType` matches your custom category, and that correct answers aren't accidentally repeated in your decoy answers list.

Assignment 2: Playtesting & Calibration

Spin up your custom game, playtest it with your parents, and identify any questions that are "too hard." Speak to AI Studio to request a simpler replacement, paste it in, and re-test!