Skip to content

Story-Driven Lesson Plan Framework for Music Blocks#7587

Draft
stutijain2006 wants to merge 7 commits into
sugarlabs:masterfrom
stutijain2006:LessonPlans
Draft

Story-Driven Lesson Plan Framework for Music Blocks#7587
stutijain2006 wants to merge 7 commits into
sugarlabs:masterfrom
stutijain2006:LessonPlans

Conversation

@stutijain2006

@stutijain2006 stutijain2006 commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Overview
This PR introduces an initial prototype for integrating lesson plans directly into Music Blocks through a story-driven learning experience.
The goal is to move beyond text-heavy instructional activities and explore a more engaging format for the primary Music Blocks audience (ages 7–11). Rather than presenting lessons as isolated exercises, this approach connects them through an ongoing narrative where learners progress through a world by solving music-based challenges.
This prototype is intended to gather feedback on both the technical implementation and the educational direction before additional lesson plans are developed.

What's Included
Lesson 1 and Lesson 2 Integration
Implemented the first two lesson levels within the existing lesson framework:
Level 1: Hot Cross Buns – Discover the Form
Level 2: Sakura Sakura – Discover the Melody
These lessons remain based on the original musical learning objectives while introducing narrative context and progression.

Exploration Badge System
This PR also experiments with rewarding curiosity rather than only rewarding lesson completion.
Examples include:

  • Modifying melodies
  • Exploring different octaves
  • Trying alternative musical ideas
  • Creating variations of provided patterns
    Instead of explicitly instructing learners to perform these actions, rewards appear when exploration naturally occurs.
    The intention is to encourage experimentation and discovery while maintaining focus on the lesson objectives.

Motivation
During discussions about lesson plans, a recurring concern was that younger learners may find long instructional text difficult to engage with.
This prototype explores an alternative approach where:

  • Lessons are presented as chapters in an ongoing story.

  • Progression is tied to narrative outcomes.

  • Exploration is encouraged through optional rewards.

  • Learning objectives remain embedded within musical activities.
    The goal is to make Music Blocks feel less like a sequence of tasks and more like an interactive adventure.

  • Feature

@github-actions

Copy link
Copy Markdown
Contributor

🧪 Jest Test Results

❌ Some Jest tests failed. Please check the logs and fix the issues before merging.

Coverage: Statements: 48.03% | Branches: 39.6% | Functions: 52.28% | Lines: 48.44%
Master Coverage: Statements: 49.63% | Branches: 41.2% | Functions: 53.75% | Lines: 50.06%

Note: These failures may be introduced by this PR or may already exist in the master branch.
Tip: Update your branch with the latest master and rerun tests.
If the same failures are present on master, they are likely not introduced by this PR.

Failed Tests:

toolbar.test.js

@github-actions

Copy link
Copy Markdown
Contributor

This PR has merge conflicts with master.

Please rebase your branch:

# Add upstream remote (one-time setup)
git remote add upstream https://github.com/sugarlabs/musicblocks.git

# Fetch latest master and rebase
git fetch upstream
git rebase upstream/master

# Resolve any conflicts, then:
git push --force-with-lease origin YOUR_BRANCH

Tip: Enable "Allow edits from maintainers" on this PR so we can auto-rebase for you next time. This only grants access to your PR branch. Your fork's other branches are not affected.

@github-actions github-actions Bot added feature Adds new functionality size/XXL XXL: 1000+ lines changed area/javascript Changes to JS source files area/tests Changes to test files area/core Changes to core app entry files labels Jul 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/core Changes to core app entry files area/javascript Changes to JS source files area/tests Changes to test files feature Adds new functionality needs-rebase size/XXL XXL: 1000+ lines changed

Projects

Development

Successfully merging this pull request may close these issues.

1 participant