Teacher activity builder

Create once, teach through many templates.

Start with structured classroom content: questions, match pairs, categories, vocabulary, learning goal, and teacher notes. The same saved activity can later become a quiz, match game, group sort, worksheet, or assignment.

Template directoryMatch

Match up example loaded

Match up example content is already loaded into the editor and preview, so you can review fields instead of starting from a blank form.

Opened from the template directory, with the selected game mode and scaffold ready for review.

Playable items
8 items
Reusable modes
8 ready

Review the Match fields, then save this activity to your library.

Activity editor workflow handoff

30-slice activity editor workflow handoff for page layout, workflow navigation, form sections, AI draft boundaries, source-material safety, readiness review, save gating, and privacy guard.

Workflow source
editor.tsWorkflow steps, anchors, and privacy boundaries are owned by the activity editor domain.
Step count
5 stepsThe workflow keeps the teacher editor to five scan-friendly sections.
Workflow order
frame -> ai-draft -> content -> source-materials -> reviewRoute navigation and form sections use one stable step order.
Create page surface
Create pageThe public create page receives the prepared workflow view from the activity editor domain.
Edit page surface
Create/edit formThe same workflow sections are reused when an owned activity is reopened for editing.
Workflow nav
Shared step navThe workflow navigation uses the same step ids, section anchors, labels, and descriptions as the form.
Form section surface
ActivityCreateFormThe activity form renders prepared sections rather than rebuilding step copy locally.
Side preview surface
Template + preview asideThe side panel keeps template entry context, input-shape help, and live preview beside the editor.
Frame section
Set the activity frameThe frame step establishes title, template mode, and starter example context.
Primary fields
ActivityEditorPrimaryFieldsPrimary fields keep the selected template legible before scaffold, AI, or structured content edits.
Template handoff
ActivityEditorTemplateHandoffViewTemplate readiness evidence remains available as a hidden semantic handoff inside the frame step.
Scaffold panel
Template scaffoldThe scaffold panel loads reusable classroom examples into the same editor contract.
AI draft step
Draft from materialThe AI draft step keeps optional generation inside the normal activity editor.
AI source state
ActivityEditorAiDraftPanelViewAI draft state comes from the prepared panel view, including safe source readiness and warnings.
AI source sync
Source material syncThe sync action turns attached material references into safe source notes without reading file bytes.
Content section
Edit reusable contentThe content section owns reusable classroom fields before any template renders them.
Details fields
ActivityEditorDetailsFieldsDetails fields capture title, description, subject, grade, difficulty, language, visibility, and learning goal.
Structured content fields
ActivityEditorStructuredContentFieldsStructured content fields capture vocabulary, questions, pairs, groups, source summary, and teacher notes.
Source materials section
Attach source materialsThe source-material section keeps teacher files attached for provenance and later extraction.
Material picker
Source material pickerThe source-material picker stays owner-scoped and passes only safe material references into the editor.
Review section
Review before savingThe review step keeps readiness checks adjacent to the final save action.
Readiness panel
Template readinessThe readiness panel confirms which templates are playable before the teacher saves.
Save action footerThe sticky save footer remains the only persistence action for the activity editor.
Auth gate
Teacher sign-in requiredUnauthenticated teachers can inspect the editor but must sign in before saving.
Input contract
CreateActivityInputAll save and AI application paths continue through the shared CreateActivityInput contract.
Readiness contract
TemplateRemixPlanReadiness review uses the same template-remix diagnosis that powers scaffold and compatibility views.
AI editor boundary
Draft fills editor onlyAI drafts can fill the editor for teacher review but cannot save or publish by themselves.
Source privacy boundary
Private materials hiddenAttached materials stay private provenance and are not exposed to student payloads by the editor workflow.
Publish boundary
Save before publishPublishing remains a later assignment step after the activity is reviewed and saved.
Privacy guard
Private classroom text hiddenThe workflow handoff exposes structure, counts, section names, and boundaries without prompts, answers, teacher notes, raw input, file ids, or storage keys.
Structured editorMatch up

Create a reusable activity

Step 1

Set the activity frame

Name the activity, choose the classroom mode, and load a coherent starter when it helps.

Words and meanings, examples and categories, cause and effect

Template setup handoff

Semantic handoff for the selected template, scaffold coverage, and current field readiness.

Primary template
Match upLearners connect terms, definitions, translations, images, or examples.
Template badge
MatchShort template names keep badges, cards, and readiness lists stable across the editor.
Classroom mode
IndividualThe selected template chooses the classroom interaction without changing the shared activity input contract.
Required content
match pairsThese field types are required before the selected template can render.
Selected template readiness
Match is selected and ready.Current structured editor fields are parsed through the same deterministic remix model used by saved activities.
Template readiness
8 readyThe same structured content can become multiple Wordwall-style activity formats after saving.
Reusable modes
Quiz, Match, Lines, Sort, Fill, Listen, Pairs, and BoxReady modes can use the current structured content after save.
Suggested remixes
Quiz, Lines, Sort, Fill, Listen, Pairs, and BoxSuggested remixes exclude the currently selected template and can become deterministic draft variants.
Locked templates
0 lockedLocked modes list missing structured fields without exposing teacher draft text.
Locked templates
Add questions, pairs, or groups to unlock playable templates.Locked modes list missing structured fields without exposing teacher draft text.
Quiz choice readiness
4/4 questions readyEach quiz question should have 4 playable choices. Missing distractors can be completed from sibling answers and vocabulary before AI distractor generation is connected.
Load example
Match up example loaded.Loading the scaffold fills the structured editor fields, but teachers still review it before saving.
Playable items
8 playable itemsExample coverage
Reusable modes
8 modes readyExample coverage
Reusable scaffold coverage
ReadyThe loaded scaffold should demonstrate one reusable activity across all template families.
Questions
4 questionsOne question per line. Use vertical bars to separate the prompt, answer, optional choices, and optional explanation. Use / or ; inside the answer field for acceptable alternatives.
Match pairs
8 pairsUsed by matching games, line matching, and pair-card templates.
Groups
3 groupsUsed by drag classification and category sorting.
Vocabulary
8 wordsSeparate terms with commas, semicolons, or new lines.
Teacher notes
2 notesOne note per line.
Shared editor contract
Shared structured inputEvery template uses the same structured activity input for questions, pairs, groups, vocabulary, and notes.
Parsed content
Structured fields parsedThe editor confirms whether the current structured fields can be parsed before template readiness is trusted.
Questions
4 questionsQuestion counts come from parsed editor rows and do not reveal prompts, answers, choices, or explanations.
Match pairs
8 pairsPair counts come from parsed editor rows and do not reveal either side of the match.
Groups
3 groupsGroup counts come from parsed editor rows and do not reveal category names or item text.
Vocabulary
8 wordsVocabulary counts come from parsed editor rows and do not reveal word text.
Teacher notes
2 notesTeacher-note counts come from parsed editor rows and do not reveal note text.
Before saving this example
3 review stepsThe scaffold review checklist keeps teachers in the edit, readiness, and save loop before using an example in class.
Save boundary
Save before publishCreating a student link remains a later publish step after the reusable activity is saved.
Privacy guard
Private editor text hiddenThe handoff exposes only labels, counts, statuses, and boundaries, not teacher draft text or answer keys.
MatchMatch up setup

Learners connect terms, definitions, translations, images, or examples.

Requires match pairs
Example coverage8 playable items8 modes ready
4 questions8 pairs3 groups8 words2 notes
QuizMatchLinesSortFillListenPairsBox

Before saving this example

  • Review fields. Check the generated questions, pairs, groups, vocabulary, learning goal, and teacher notes before saving.

    Review fields

    Go to fields

    Check the generated questions, pairs, groups, vocabulary, learning goal, and teacher notes before saving.

  • Check ready modes. Use the readiness panel to confirm which templates are playable and which fields still need content.

    Check ready modes

    View readiness

    Use the readiness panel to confirm which templates are playable and which fields still need content.

  • Edit before saving. Treat the example as a starting point: edit it for your class, then save it as a reusable activity.

    Edit before saving

    Keep editing

    Treat the example as a starting point: edit it for your class, then save it as a reusable activity.

Step 2

Draft from material

Paste lesson notes, sync safe source materials, or generate a teacher-reviewable draft.

AI draft boundary handoff

30-slice AI draft boundary handoff for authenticated generation, safe source provenance, editor review, no-persistence behavior, draft coverage, and privacy guards.

Source panel
AI draft panelThe visible AI source panel is the teacher review surface before generation.
Generation gate
BlockedThe current source, auth state, and pending state decide whether the generate action is ready.
Auth boundary
Authenticated actionGeneration still goes through the authenticated activity draft server function before any editor fields are changed.
Server function
generateActivityDraftThe client calls one server function instead of persisting activity rows directly.
Input schema
generateActivityDraftInputSchemaDraft requests are validated by the shared generateActivityDraft input schema.
Items
5 itemsRequested item count is bounded before it reaches the draft service.
Focus
Balanced activityThe selected draft focus is sent with the request and displayed as generation provenance.
Template
Match upThe selected primary template is preserved in the draft request and result boundary.
Source sanitization
Sanitized sourceTeacher source notes are normalized and material-note payloads are sanitized before prompting.
Safe sources
0 safe sourcesOnly safe material kind and filename provenance can be included in the AI prompt.
Omitted sources
0 omitted sourcesUnsafe, duplicate, or incomplete material notes are counted but their payloads stay hidden.
File-byte guard
Bytes omittedAttached classroom file bytes are not read by this draft generation boundary.
Storage-key guard
Storage hiddenStorage keys, URLs, path segments, query tokens, and permission metadata stay out of draft requests and handoff values.
Provider
Awaiting draftProvider provenance distinguishes Workers AI output from deterministic fallback drafts.
Model
@cf/meta/llama-3.2-3b-instructModel provenance is shown without raw provider output.
Fallback path
Fallback availableMissing credentials, invalid JSON, or partial output fall back to deterministic local drafting before editor review.
JSON boundary
Schema enforcedProvider output must parse into the expected draft shape or fall back to the local generator.
Local completion
No noticePartial provider drafts may be completed locally so required classroom structures stay present.
Input contract
CreateActivityInputAI output is converted into the same CreateActivityInput contract the editor saves.
Review mode
editor-reviewDraft application mode remains editor review, never direct persistence.
Persistence
not-persistedGenerated drafts remain not persisted until the teacher saves the activity.
Teacher review
RequiredTeachers must inspect generated content, answers, explanations, and readiness before saving.
Editor application
PendingOnly reviewable draft results with the expected review state may be applied to editor fields.
Save boundary
Teacher saves laterThe draft only fills editor fields; saving remains an explicit teacher action.
Publish boundary
Publish laterAssignment links are never published by generation; teachers publish later after saving.
Coverage
PendingCoverage summarizes generated questions, pairs, groups, vocabulary, and notes without showing draft text.
Template readiness
PendingReady and locked template counts come from deterministic readiness, not AI-only claims.
Quiz choices
PendingQuiz choice readiness is summarized without exposing prompts, choices, or answers.
Generation notice
No noticeFallback or local-completion notices are summarized without raw provider errors.
Privacy guard
Private data omittedThis handoff omits source text, draft text, prompts, choices, answers, teacher notes, file ids, storage keys, file bytes, omitted note payloads, and raw provider output.
AI draftTeacher reviews before saving

AI drafting uses the text below plus safe source-material provenance only.

Adds material kind and safe filename only.

Source ready

812/2000 characters

The draft source has teacher-provided text and is ready for AI drafting.

Keeps questions, pairs, groups, vocabulary, and notes balanced for reuse.

Choose how many teacher-reviewable items the draft should generate before you save the activity.

Sign in to generate an AI draft.

Step 3

Edit reusable content

Shape the reusable questions, pairs, groups, vocabulary, and notes that every template reads.

Separate terms with commas, semicolons, or new lines.

One question per line. Use vertical bars to separate the prompt, answer, optional choices, and optional explanation. Use / or ; inside the answer field for acceptable alternatives.

Used by matching games, line matching, and pair-card templates.

Used by drag classification and category sorting.

One note per line.

Step 4

Attach source materials

Attach private classroom files for provenance and later extraction without exposing them to students.

Source materials

Link uploaded audio, worksheet images, documents, or spreadsheets to this draft for future AI extraction and editing. Student assignments will not expose these file references.

0 attached

Source material picker handoff

30-slice source-material picker contract for owner scope, load state, attachment limits, attach/remove controls, upload entry, metadata summaries, AI extraction readiness, and private file guards.

Owner scope
Current teacherThe picker only works with classroom files owned by the current teacher.
Storage load gate
Sign-in requiredThe load gate keeps classroom file queries behind the signed-in teacher workspace.
Picker status
Signed outPicker status resolves from sign-in, loading, error, empty, and available states before controls render.
Selected count
0Selected count is normalized, deduplicated by source-material key, and capped before reaching the editor.
Available count
0Available count reflects the owner-scoped classroom files returned to this picker view.
Visible available limit
Bounded listThe available-file list is intentionally bounded so large source libraries do not overload the editor picker.
Attachment limit
Up to 12 filesThe attachment limit keeps ActivityContent source-material references bounded inside the editor.
Limit gate
Within limitThe limit gate disables new attachment actions once the activity reaches the source-material cap.
Attached summary
0The attached summary reports extraction-capability families without exposing teacher filenames or file ids.
Attached items
0Attached item count is derived from normalized ActivityContent source-material references.
Available items
0Available item rows remain teacher-only file choices and are never copied into student runtime payloads.
Selected state
0Selected-state count marks available rows that are already attached to the current draft.
Attach actions
0Attach actions add source-material references to the draft without reading file bytes or publishing anything.
Disabled attach actions
0Disabled attach actions are caused by already-selected materials or the activity-level attachment cap.
Remove action
Reference-only changeRemove actions detach a source-material reference from the activity draft without deleting the uploaded file.
Upload entry
Upload filesThe upload entry sends teachers to the source-material library instead of creating files inside the activity editor.
Loading state
InactiveThe loading state describes the pending owner-scoped file query before file rows render.
Error state
InactiveThe error state keeps file-loading failure visible without leaking provider errors or storage details.
Empty state
InactiveThe empty state tells teachers that no owner-scoped classroom files are available yet.
Signed-out state
ActiveThe signed-out state blocks file loading and directs teachers to sign in before attaching classroom materials.
Material-kind metadata
Kind and basenameMaterial-kind metadata drives audio, worksheet, spreadsheet, and reference-only summaries.
Content-type metadata
Normalized content typeContent-type metadata is normalized for material classification instead of being trusted as private file content.
Size metadata
Rounded sizeSize metadata is rounded into display-only summaries and does not imply file-byte reads.
Source-material reference
ActivityContent.sourceMaterialsAttached items write compact references into ActivityContent.sourceMaterials.
AI extraction readiness
0The picker summarizes attached audio, worksheet, and spreadsheet capabilities for later teacher-reviewed AI extraction.
Student payload guard
Runtime file list hiddenStudent assignment payloads receive sanitized runtime prompts and choices, not the teacher's source-material list.
File-id guard
File ids hiddenFile ids remain out of the semantic handoff even though attach/remove actions use them internally.
Filename display boundary
Teacher-only basenameTeacher-visible basenames may appear in picker rows, but the handoff itself reports only counts and boundaries.
Storage-key guard
Storage hiddenStorage keys, URLs, query tokens, and permission metadata stay server-side and out of picker semantics.
Privacy guard
Private data hiddenThe handoff hides file bytes, file ids, storage keys, permission metadata, student payload file references, and raw private filenames.

Attached source materials

Up to 12 files

No classroom files are attached to this activity yet.

Available classroom files

Upload files

Sign in to attach classroom files to saved activities.

Step 5

Review before saving

Check playable modes and save only after the structure is ready for students.

Template readiness

The same structured content can become multiple Wordwall-style activity formats after saving.

8 ready
QuizMatchLinesSortFillListenPairsBox

Quiz choice readiness

Each quiz question should have 4 playable choices. Missing distractors can be completed from sibling answers and vocabulary before AI distractor generation is connected.

4/4 questions ready

1. Which word means a red or green fruit?

Explicit choices

4/4 choices are already written in the question row.

Candidate sources: 2 sibling answers, 2 vocabulary terms.

2. Which drink is white?

Explicit choices

4/4 choices are already written in the question row.

Candidate sources: 2 sibling answers, 2 vocabulary terms.

3. Which food is often eaten from a bowl?

Explicit choices

4/4 choices are already written in the question row.

Candidate sources: 1 sibling answers, 3 vocabulary terms.

4. Which item can hold a drink?

Explicit choices

4/4 choices are already written in the question row.

Candidate sources: 2 sibling answers, 2 vocabulary terms.

Quiz choice generation handoff

A teacher-reviewable handoff for completing quiz distractors without leaving the shared question option structure.

Scope
Editor before save
The handoff applies to the editor and AI draft review before the teacher saves the activity.
Target choices
4
The per-question playable choice target used by quiz runtime and readiness checks.
Questions
4
Quiz questions considered by the choice-completion contract.
Ready questions
4
Questions that already have enough playable choices after deterministic completion.
Explicit ready
4
Questions that already have enough explicit choices without local completion.
Completed locally
0
Questions that can reach the target choice count from deterministic local candidates.
Need candidates
0
Questions that still need more explicit choices, vocabulary, or teacher-approved AI distractors.
Explicit choices
16
Teacher-authored or AI-draft option rows already present on the questions.
Local choices
0
Choices added by deterministic sibling-answer or vocabulary completion before future AI distractor generation.
Missing choices
0
Remaining choices needed before every quiz question reaches the target count.
Sibling candidates
7
Candidate distractors collected from other question answers without exposing answer text here.
Vocabulary candidates
9
Candidate distractors collected from lesson vocabulary without exposing vocabulary text here.
Candidate sources
16
Total safe candidate choices counted from sibling answers and vocabulary.
Answer covered
4
Questions whose completed playable choices include the normalized answer.
Missing answers
0
Questions whose completed choice list still does not contain the normalized answer.
Option structure
ActivityQuestionOption[]
Generated distractors must normalize into the same option objects used by teacher-authored choices.
Generation mode
Deterministic now, AI later
Current completion is deterministic; later AI distractors must use the same output target.
Write target
Question options
AI distractor output must write back to the existing question option array.
Teacher review
Review before save
Teachers still review choices in the editor before saving or publishing.
Publish boundary
Save before publish
Publishing still requires saving the reviewed activity and then creating an assignment snapshot.
Completed choices
16
Total playable choices available after explicit options and deterministic local completion.
Explicit answers
4
Questions whose explicit option seed already contains the normalized answer before local completion.
Questions with candidates
4
Questions with at least one deterministic sibling-answer or vocabulary candidate available.
Candidate dedupe
Unique candidates
Sibling-answer and vocabulary candidates are deduplicated before they become playable choices.
Candidate normalization
Shared option normalization
Candidate text is normalized with the same display/key rules used by teacher-authored options.
Stable order
Question-seeded order
Local distractors are sorted with a question-seeded stable rank so repeated renders keep the same choice set.
Runtime choice source
buildQuestionChoices
Quiz runtime and readiness use the same deterministic completion helper before any future AI layer is involved.
Answer guard
Answer retained
The normalized answer is seeded into every completed choice list before any distractors are added.
Empty content guard
Questions present
Empty or non-quiz editor content still reports a safe zero-count handoff rather than leaking draft text.
Privacy guard
Choice text hidden
The handoff exposes counts and boundaries without prompt text, option text, answer text, vocabulary text, or future raw AI output.

Saved activities appear in the teacher dashboard and can later be published as assignments.

Sign in to save

Classroom control semantics handoff

30-slice classroom control semantics contract for prepared help text, route-state controls, result scopes, printable controls, student submission controls, and privacy guards.

AI source textarea
Prepared control
The source textarea is associated with safety, readiness, material capability, and synced-provenance descriptions before generation.
AI safe-source note
Prepared help
The AI source textarea is described by the safe-source note so teachers know only reviewed notes and safe provenance can be used.
AI source readiness
Prepared help
Source readiness describes starter text, teacher-provided notes, synced material provenance, and source length state.
AI material safety
Prepared help
Source-material safety metrics describe safe and omitted provenance without exposing omitted payloads.
AI source capabilities
Prepared help
Attached material capability cards describe audio, worksheet, and spreadsheet readiness from safe material metadata.
AI synced provenance
Prepared help
Synced material notes are described as safe kind and basename provenance, not file ids, storage keys, or file bytes.
AI focus control
Prepared control
The AI draft focus select is tied to the selected focus description so teachers know how the draft will be shaped.
AI generate action
Prepared control
The generate action is described by source readiness and any disabled reason before an AI draft request is made.
AI draft summary
Semantic region
The draft summary exposes provider, model, review gate, coverage, source safety, and save boundary as semantic outputs before persistence.
Activity source filter
Route state
The activity source-material filter uses prepared filter descriptions and URL state so teachers understand source scope before the list updates.
Assignment status filter
Route state
The assignment status filter is described by current lifecycle scope and prepared counts before route state changes.
Publish title field
Prepared control
The assignment title field is described as classroom-specific link, result, and export context without exposing the typed title.
Publish instructions field
Prepared control
The instructions field is described as frozen student-facing guidance for the runner and printable worksheet.
Publish attempt-limit field
Prepared control
The max-attempt field is described by the shared attempt-limit parser and unlimited-attempt guidance.
Publish timer field
Prepared control
The timer field is described by the shared timer parser and no-limit guidance before settings are saved.
Publish close-time field
Prepared control
The close-after field is described by the shared close-time parser and open-link guidance.
Publish delivery toggles
Prepared control
Collect-name, answer-reveal, and shuffle switches are each tied to prepared delivery-policy descriptions.
Publish preview region
Semantic region
The publish preview groups delivery status, rule stats, settings summary, and review checklist before snapshot creation.
Result student search
Route state
The student search control is described by search rules, matched-record summary, and adjusted-status state.
Result student sort
Route state
The student-summary sort control is described by the selected scan-order explanation and adjusted-status badge.
Result item sort
Route state
The item-performance sort control is described by the selected sorting explanation and adjusted-status badge.
Result answer-review filter
Route state
The answer-review filter is described by the selected review mode and default-or-adjusted status.
Result review scope
Semantic region
The review-scope panel groups search, sort, filter, matched record, and copy-scope summaries as semantic output.
Result copy scope
Semantic region
Copy previews and copy actions are associated with the current review-scope summary before artifacts are copied.
Result CSV coverage
Semantic region
CSV export coverage explains the full-assignment export scope independently of current result filters.
Printable answer-key toggle
Prepared control
The printable answer-key toggle is tied to answer-key access state, teacher-only description, and URL state before answers are appended.
Printable print action
Prepared control
The print action is described by the prepared print summary so the handout boundary is clear before printing.
Student identity input
Prepared control
The student identity input is described by normalized name or anonymous-browser identity guidance before submission.
Student submit button
Prepared state
The submit button is described by readiness state, payload summary, and partial-attempt hints before any attempt is sent.
Privacy guard
Private data hidden
The handoff never serializes prompts, answers, student names, raw anonymous tokens, CSV data URLs, assignment title text, or private activity content.