Teacher Guide

Getting Started

Creating Your Account

1. Go to the ClassCards homepage and click "Register"
2. Select "Teacher" as your role
3. Fill in your name, email, and create a password
4. Check your email for a verification link
5. Click the link to activate your account

📸 Screenshot: Registration form

Dashboard Overview

Your dashboard is your command center. In the top navigation you'll find: Dashboard, Learning Progress, Vocabulary, Classes, and Tests.

• Quick statistics (students, vocabulary, cards, classes)
• Class selector in the top right to switch between classes
• Quick actions and recent activity from your classes

📸 Screenshot: Teacher dashboard

Managing Students

Creating Student Accounts

You can create accounts for your students in several ways:

Setting Up Classes

Organizing into Classes

Classes help you organize students:

1. Click "Classes" in the top navigation
2. Click "Create New Class"
3. Enter a name (e.g., "English 7A")
4. Add students by selecting from your student list

Lesson Decks

Each class automatically has a lesson deck. Vocabulary you add there is automatically available to all students in the class - no manual assignment needed.

Language Settings

Set the native language and target language for each class. This is important for AI-generated sentences and exercises, which will then be created in the correct language.

XP System

The XP system can be toggled on or off per class. When enabled, students earn daily experience points for consistent practice and see a class leaderboard.

Creating Vocabulary

Manual Card Creation

1. Go to a class and open the lesson deck
2. Click "Add Card"
3. Enter the front (word) and back (translation)
4. Optionally add an example sentence
5. Save the card

List Import

For larger amounts of vocabulary, import from a list:

1. Prepare your list with semicolon separators (word;translation;sentence)
2. Go to the deck and click "Import Cards"
3. Paste the list and review the preview
4. Confirm the import

Using the Deck Library

Browse and copy vocabulary from our library:

1. Click "Vocabulary" in the top navigation
2. Browse by CEFR level (A1-C2) or textbook
3. Click "Copy to My Vocabulary" on any deck you want
4. The vocabulary is now yours to edit

AI-Powered Features

AI Vocabulary Extraction

Extract vocabulary words from any text using AI:

1. Paste text (sentence, paragraph, or passage) into the bulk import field
2. Click "Extract Vocabulary" - AI identifies 3-10 vocabulary words
3. Review and edit words, translations, and sentences in the preview table
4. Click "Generate AI Sentences" to add example sentences for all cards
5. Save approved vocabulary to your deck

AI Sentence Generation

Generate example sentences for your vocabulary cards:

• Look for the "Generate AI Sentences" button at the top of import previews
• AI creates contextual example sentences for cards without one
• Edit any generated sentence before saving

Grading Preferences

Set how strict the AI grading should be during practice. Choose between Strict, Medium, or Lenient in the deck vocabulary view under Settings.

Inline Editing

Edit vocabulary directly without switching modes:

• All card fields are always editable - just click to edit
• Changes auto-save when you click outside the field
• A green flash confirms successful save

Vocabulary Tests

Creating a Test

Create vocabulary tests for your classes. Go to "Tests" in the navigation, select a deck and a class, and set the test parameters.

Test Types

• Manual test: All students receive the same questions
• Individualized Test

  In individualized tests, questions are selected based on each student's weaknesses. Set a minimum success rate and preview the questions per student.

Test Results

View the evaluation of each test with scores, grades, and a detailed breakdown per student and question.

Anti-Cheat

The system detects when students switch tabs during a test (focus loss). The number of tab switches is logged and shown in the results.

Student Suggestions

Students can suggest vocabulary for the class deck. You'll see suggestions in the dashboard or deck view and can accept, reject, or edit them.

1. Students submit suggestions via their deck view
2. You'll see new suggestions with a badge in the navigation
3. Review each suggestion and accept, edit, or reject it

Tracking Progress

Learning Progress

Under "Learning Progress" in the navigation you'll find a detailed overview of the learning status of all students in your selected class.

Deck Performance

See how students are doing with each vocabulary set:

• Cards studied vs total cards
• Average accuracy per student
• Time spent practicing
• Last activity date

Class Performance

Get an overview of your entire class:

• See which students are active
• Identify struggling students who need help
• Compare progress across students

Hard Words

The system automatically detects vocabulary that many students struggle with. These are highlighted in the performance view.

Inactive Students

Students who haven't practiced for several days are automatically flagged so you can follow up with them.

📸 Screenshot: Performance dashboard

Class Sharing & Collaboration

Sharing Overview

Share classes with other teachers for collaborative vocabulary teaching. Shared classes appear with a "(shared)" indicator. Both teachers see the same students, decks, and performance data.

How to Share a Class

1. Go to the Class Detail page
2. Click "Share Class" in the top right
3. Enter the collaborator's username or email
4. They'll receive an invitation to accept

What Collaborators Can Do

• View and manage all students in the class
• Add and edit vocabulary
• View student performance and progress
• See hard words and inactive students
• Add vocabulary via live sessions