---
title: "Teacher: Getting Started (Onboarding Walkthrough)"
url: https://docs.growamal.com/en/guides/teacher-onboarding/
language: en
---

# Teacher: Getting Started

When you log in to Amal for the first time, a short guided walkthrough introduces the platform's
key ideas before your dashboard appears. It takes about 90 seconds and can be dismissed at any
slide — your progress is saved either way.

## The Day-1 walkthrough (6 slides)

The walkthrough covers the six concepts that matter most in week one:

| Slide | Topic | What you learn |
|---|---|---|
| 1 | **What you see** | The Skill-Group view is your main daily tool — students are grouped by skill. |
| 2 | **What needs attention today** | Red-dot students have a Student Alert or Intensive Review; orange-dot students have a Skill Alert. The platform suggests; you decide. |
| 3 | **How to act on an alert** | You can accept a support bundle, modify it, or dismiss it with a reason code from a closed list. There are no free-text fields — this protects students from being labelled in the system. |
| 4 | **Smart Grouping & Bulk Activation** | Students with the same need and support level can be activated together. Tasks are automatically differentiated per student within the same bundle. |
| 5 | **Safety alerts** | Two signals to know: "need more evidence" (no plan is forced until data is sufficient) and a progress-drop alert (a signal to review — never an automatic failure). |
| 6 | **Where to find help** | Tap any ⓘ icon for instant tooltip help. Download the cheat sheet from your account menu. |

> **Note:** The walkthrough appears **once**. After you complete or dismiss it, it will not reappear unless
> you choose "إعادة التهيئة" (Reset onboarding) from your account menu.

## The ⓘ help icons

After the walkthrough, small ⓘ icons appear next to every new-vocabulary term in the platform.
Tap or hover to see a one-to-two sentence explanation in Arabic.

When you no longer need a tooltip, tap **"لا تظهر مرة أخرى"** (Do not show again) to permanently
dismiss that icon. Dismissed icons do not reappear unless you reset your onboarding.

The 11 help icons cover:

- Tier labels on student cards (Core / Targeted / Intensive)
- Alert chip types (Skill Alert / Student Alert / Intensive Review)
- Support bundle badge on a plan card
- Fidelity bar
- Anchor skill + Supporting threads + Asset bridge on the Recommendations Panel
- Smart Cluster card on the Smart Grouping Panel
- Support level badge on the Scaffold Distribution Preview
- Delivery option dropdown on Activation Review
- "Need more evidence" badge (the platform's halt signal — لا توجد بيانات كافية بعد)
- Progress-drop review badge (a review signal, not a failure)
- Progress interpretation badge on the Monitoring Widget

## Re-running the walkthrough

Open the account menu (your name in the top corner) and choose **"إعادة التهيئة"**. The six-slide
walkthrough will appear the next time you reload the dashboard.

## First-use tutorials (Smart Grouping, Acute Regression, Insufficient Evidence)

Three short four-slide tutorials appear the first time you encounter a specific platform moment.
They appear once; after you complete or dismiss one, it will not reappear — unless you choose
**"إعادة التهيئة"** to re-arm all tutorials.

| Tutorial | When it appears | What it covers |
|---|---|---|
| **Smart Grouping** | First time you open the Smart Grouping Panel | How the platform groups students by shared bundle, scaffold level, and delivery mode — and how to review the distribution before activating together |
| **Acute Regression — مراجعة انخفاض الأداء** | First time an acute-regression progress-drop badge appears in plan decisions | A progress-drop is a **review signal, not a judgment of failure**. The tutorial explains how to read the badge and what a review involves before any plan change |
| **Insufficient Evidence — بيانات غير كافية** | First time the engine returns a `do_not_decide_yet` halt in plan decisions | The platform holds the recommendation until enough comparable data exists. This tutorial explains the wait, why it protects students from premature plans, and that **no override can bypass the data-sufficiency gate** |

> **Note:** The acute-regression and insufficient-evidence tutorials are deliberately framed around teacher
> review, not automatic failure or system error — in line with the platform's growth-language
> commitment. No tutorial slide ever implies a student has "failed" or that a plan must change
> immediately.

## The cheat-sheet PDF

The cheat sheet is a two-page A4 Arabic reference card. It covers the alert vocabulary, the
override-reason codes, the support-level labels, and the 17-step activation workflow on a single
printable sheet.

To download it: open the account menu → **"تحميل دليل التهيئة"**.

> **Note:** The cheat sheet is generated fresh each time you download it, so it always reflects the latest
> version of the platform vocabulary.

## Onboarding funnel dashboard (super-admin)

A super-admin PM view at `/admin/onboarding` aggregates funnel events across all organisations —
showing how many teachers have reached each tutorial step. This page is not accessible to
per-organisation admins or teachers.

## Related guides

- [Teacher Activation Workflow](https://docs.growamal.com/en/guides/teacher-activation/): the guided flow for reviewing recommendations and activating a support plan
- [RTI Alerts Inbox & Tier Review](https://docs.growamal.com/en/guides/rti-alerts-teacher/): what alert types mean and how to act on them
- [Language Safety](https://docs.growamal.com/en/guides/language-safety/): why the platform never stores free-text notes about students