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.
- Open **Google AI Studio** in your browser.
- Choose either **Gemini 1.5 Pro** or **Flash** as your active model.
- Click the **Microphone icon** next to the chat bar to dictate your prompt.
- Speak this exact prompt clearly:
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)
- Create a new file named `knowledge.json` inside the `public/data/` folder in your code editor.
Path: `apps/web/public/data/knowledge.json` - Copy the JSON code block from Google AI Studio and paste it directly into `knowledge.json`. Save the file.
- 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!