Skip to content

feat: add interactive first project tutorial#7691

Open
rakshityadav1868 wants to merge 2 commits into
sugarlabs:masterfrom
rakshityadav1868:interactive-tutorial-implementation
Open

feat: add interactive first project tutorial#7691
rakshityadav1868 wants to merge 2 commits into
sugarlabs:masterfrom
rakshityadav1868:interactive-tutorial-implementation

Conversation

@rakshityadav1868

@rakshityadav1868 rakshityadav1868 commented Jun 29, 2026

Copy link
Copy Markdown
Contributor
  • Feature

Summary

This PR introduces an interactive "First Project" tutorial to help new users get started with Music Blocks through a guided, hands-on experience.

What's included

  • Added a new Interactive Tutorial entry under the Help menu.
  • Introduced a new FirstProjectTutorial controller to guide users through building their first project step by step.
  • Added a dedicated tutorial card to the Help widget with a Start Tutorial action.
  • Integrated the tutorial launcher with the toolbar Help menu.
  • Added the required English localization strings.

Why

Music Blocks has many powerful features, but the interface can feel overwhelming for first-time users. This interactive tutorial provides an onboarding experience that helps users learn by doing instead of relying solely on documentation.

Screen.Recording.2026-06-29.at.1.28.41.PM.mp4

Signed-off-by: Rakshit Yadav <yadavrakshit60@gmail.com>
@github-actions github-actions Bot added feature Adds new functionality size/XXL XXL: 1000+ lines changed area/javascript Changes to JS source files area/i18n Changes to localization files area/core Changes to core app entry files labels Jun 29, 2026
@rakshityadav1868

Copy link
Copy Markdown
Contributor Author

hey @Ashutoshx7 , PTAL

@rakshityadav1868

Copy link
Copy Markdown
Contributor Author

hey @stutijain2006 ,PTAL

@stutijain2006

Copy link
Copy Markdown
Contributor

hey @stutijain2006 ,PTAL

Heyy , the feature is cool. Few changes suggested from my side are -

  1. Make sure this matches with color theme of music block in all color modes available.
  2. Right now at every step it ask the user to perform the action without guiding them where that option actually lies in music blocks window. Our task is to tell them the available features in music blocks window, so it should instead animate and show where those options lies. As it might be difficult for the first time user of music blocks to navigate those things. And try to keep action part from user side as minimum as possible. Instead show them where each feature is using animations, how it is used in music blocks, and in some steps ask them to perform basic validations. And in those steps, where user is asked to perform, give some hint type of option which can let them see what they have to do in that step if they are unable to understand the task.

Rest, good work. Take opinion from other peoples as well. And I will keep on adding my opinions in the loop itself.

Signed-off-by: Rakshit Yadav <yadavrakshit60@gmail.com>
@rakshityadav1868

Copy link
Copy Markdown
Contributor Author

Fixed the color contrast in each mode!!

Screenshot 2026-07-03 at 9 35 41 PM Screenshot 2026-07-03 at 9 35 58 PM Screenshot 2026-07-03 at 9 36 13 PM

@rakshityadav1868

Copy link
Copy Markdown
Contributor Author

Hi @walterbender and @Ashutoshx7 regarding Stuti's second suggestion, could you clarify the expected UX? Should the tutorial automatically highlight/animate UI elements and minimize user actions, or do you have a different onboarding flow in mind? I'd like to align with the expected behavior before implementing it.

@walterbender

Copy link
Copy Markdown
Member

Can we discuss this at one of the Sunday meetings? I can see going two different routes: (1) walking through what each section of the UX does or (2) something interactive where the user builds during the tour. We've run into issues with the latter in the past -- things getting stuck in unexpected states. So maybe the less ambitious former to start?

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/i18n Changes to localization files area/javascript Changes to JS source files feature Adds new functionality size/XXL XXL: 1000+ lines changed

Projects

Development

Successfully merging this pull request may close these issues.

3 participants