WWTBS? Content Store

Question Packs

Tap any card to preview the pack details

How It Works

1

Open the DLC Store in the app

Tap the 🛍 Store button on the home screen. The app fetches this manifest.json and shows all available packs instantly.

2

Tap a pack to download it

A progress bar tracks the download. Packs are extracted in the background so the UI stays smooth. Once done, a ✅ badge appears — the pack is ready to play!

3

Play!

New questions are automatically mixed into the game rotation. The built-in text-to-speech reads every question aloud — perfect for early readers 🎉

Developer Setup

Point the Flutter app at this server in three steps

🍴

1. Fork & Deploy

Fork this repo, enable GitHub Pages (or deploy to Netlify) from the dlc_website/ folder. Your manifest lives at
https://<you>.github.io/<repo>/manifest.json

⚙️

2. Update app_constants.dart

Set dlcManifestUrl to your deployed URL:

// lib/core/constants/
// app_constants.dart

static const dlcManifestUrl =
  'https://YOU.github.io'
  '/wwtbs-dlc/manifest.json';

📦

3. Build the ZIPs

Run the bundled Python script to zip every pack source directory:

cd dlc_website
python3 scripts/build_packs.py

# outputs:
# packs/animals_v1.zip
# packs/colors_shapes_v1.zip

➕ Adding a New Pack

Create dlc_website/packs/<pack_id>/questions.json following the schema below.
Run python3 scripts/build_packs.py — it zips the folder automatically.
Add an entry to manifest.json (increment total_packs and bump manifest_version).
Commit & push — GitHub Pages redeploys in ~60 seconds.
The app will see the new pack on next store refresh 🚀

questions.json schema

{
  "pack_id":   "my_pack",
  "pack_name": "My Amazing Pack",
  "version":   1,
  "questions": [
    {
      "id":         "mp_q01",
      "text":       "What color is the sky?",
      "difficulty": 1,
      "category":   "Colors",
      "choices": [
        { "id": "c1", "text": "Blue",   "is_correct": true  },
        { "id": "c2", "text": "Green",  "is_correct": false },
        { "id": "c3", "text": "Red",    "is_correct": false },
        { "id": "c4", "text": "Purple", "is_correct": false }
      ]
    }
  ]
}