Adding and Managing Children

Sunschool allows parents to create and manage multiple learner accounts, each with personalized settings and grade-appropriate content.

Creating Learner Accounts

From the Dashboard

If you don’t have any children yet, you’ll see an inline form on the dashboard. Otherwise, click the “Add Another Child” button.

Using the Dedicated Page

Navigate to /add-learner for a full-page form with more options. From add-learner-page.tsx:12-16:

const [newLearner, setNewLearner] = useState({
  name: '',
  gradeLevel: '',   // "K", "1", "2", ... "12"
});

Required Information

Child's Name

Enter your child’s first name or preferred nickname

// From add-learner-page.tsx:39-42
if (!newLearner.name) {
  setError('Please enter a name');
  return;
}

The name is used throughout the interface to personalize the learning experience.

Grade Level

Select from Kindergarten (K) through Grade 12The grade picker shows all available options:

// From add-learner-page.tsx:30-35
const gradeToNumber = (grade: string): number | null => {
  if (grade === 'K') return 0;
  const num = parseInt(grade, 10);
  if (isNaN(num) || num < 1 || num > 12) return null;
  return num;
};

Grade Level Conversion

How Grade Levels Work

Sunschool uses numeric grade levels internally:

Kindergarten (K) = 0
Grade 1 = 1
Grade 2 = 2
…
Grade 12 = 12

This allows for consistent curriculum mapping and appropriate content difficulty.

Choosing the Right Grade

Select the grade your child is currently in or will be entering. The system will:

Adapt lesson difficulty automatically
Recommend age-appropriate subjects
Adjust vocabulary and complexity
Track grade-level progress

The Add Learner Form

From add-learner-page.tsx:84-150:

return (
  <SafeAreaView style={[styles.container, { backgroundColor: colors.background }]}>
    <SunschoolHeader subtitle="Add Child" />

    <ScrollView contentContainerStyle={styles.scrollContent}>
      <View style={[styles.formContainer, { backgroundColor: colors.surfaceColor }]}>
        <Text style={[styles.title, { color: colors.textPrimary }]}>
          {user?.role === 'ADMIN' ? 'Add New Learner Account' : 'Add Child'}
        </Text>

        {error ? (
          <View style={[styles.errorContainer, { backgroundColor: colors.error + '18' }]}>
            <Text style={[styles.errorText, { color: colors.error }]}>{error}</Text>
          </View>
        ) : null}

        <View style={styles.formGroup}>
          <Text style={[styles.label, { color: colors.textSecondary }]}>
            {user?.role === 'ADMIN' ? 'Learner Name' : 'Child\'s Name'}
          </Text>
          <TextInput
            style={[styles.input, {
              borderColor: colors.divider,
              color: colors.textPrimary,
              backgroundColor: colors.inputBackground,
            }]}
            value={newLearner.name}
            onChangeText={(text) => setNewLearner({ ...newLearner, name: text })}
            placeholder={user?.role === 'ADMIN' ? "Enter learner's name" : "Enter child's name"}
            placeholderTextColor={colors.textSecondary}
          />
        </View>

        <View style={styles.formGroup}>
          <GradePicker
            value={newLearner.gradeLevel}
            onChange={(grade) => setNewLearner({ ...newLearner, gradeLevel: grade })}
          />
        </View>
      </View>
    </ScrollView>
  </SafeAreaView>
);

Form Validation

The system validates input before creating the account:

// From add-learner-page.tsx:37-49
const handleSubmit = async () => {
  // Validation
  if (!newLearner.name) {
    setError('Please enter a name');
    return;
  }

  const gradeLevel = gradeToNumber(newLearner.gradeLevel);
  if (gradeLevel === null) {
    setError('Please select a grade level');
    return;
  }

  // Create learner account
  await apiRequest('POST', '/api/learners', {
    ...newLearner,
    gradeLevel,
    role: 'LEARNER',
    parentId: user?.id,
  });
};

Both name and grade level are required. The form will show an error if either is missing.

Creating the Account

When you submit the form:

Validation - Checks that name and grade are provided
API Request - Sends learner data to the server
Account Creation - Server creates user with LEARNER role
Parent Link - Associates learner with your parent account
Profile Setup - Initializes learner profile with grade level
Redirect - Takes you back to the learners list

From add-learner-page.tsx:50-72:

try {
  setIsSubmitting(true);
  setError('');

  // Create learner account
  await apiRequest('POST', '/api/learners', {
    ...newLearner,
    gradeLevel,
    role: 'LEARNER',
    parentId: user?.id,
  });

  // Show success toast
  toast({
    title: 'Success',
    description: 'Child account created successfully',
  });

  // Refresh learners list
  queryClient.invalidateQueries({ queryKey: ['/api/learners', user?.id, user?.role] });

  // Navigate back to learners page
  setLocation('/learners');
} catch (err: any) {
  setIsSubmitting(false);
  setError(err.response?.data?.error || 'Failed to create account. Please try again.');
}

Managing Existing Learners

The Learners Page

Navigate to /learners to see all your children and manage their settings. From learners-page.tsx:39-50:

const {
  data: learners = [],
  isLoading,
  error: fetchError
} = useQuery({
  queryKey: ["/api/learners", user?.id, user?.role],
  queryFn: async () => {
    const response = await apiRequest('GET', '/api/learners');
    return response.data;
  },
});

Learner Cards

Each learner is displayed in a card showing:

Name and email (if provided)
Current grade level badge
Action buttons for editing and viewing

From learners-page.tsx:362-416:

const renderLearnerItem = ({ item }: { item: any }) => {
  const profile = learnerProfiles?.[item.id];
  const gradeLevel = profile?.gradeLevel !== undefined ? profile.gradeLevel : null;
  
  return (
    <TouchableOpacity style={styles.learnerCard}>
      <View style={styles.learnerInfo}>
        <Text style={styles.learnerName}>{item.name}</Text>
        <Text style={styles.learnerEmail}>{item.email}</Text>
        {gradeLevel !== null && (
          <View style={styles.gradeBadge}>
            <Text style={styles.gradeBadgeText}>
              {gradeLevel === 0 ? 'K' : `Grade ${gradeLevel}`}
            </Text>
          </View>
        )}
      </View>
      
      <View style={styles.learnerActions}>
        <TouchableOpacity
          style={styles.actionButton}
          onPress={() => openEditModal(item)}
        >
          <Edit size={18} color={colors.primary} />
          <Text style={styles.actionButtonText}>Edit</Text>
        </TouchableOpacity>
        
        <TouchableOpacity
          style={styles.actionButton}
          onPress={() => openSubjectsModal(item, profile)}
        >
          <BarChart2 size={18} color={colors.primary} />
          <Text style={styles.actionButtonText}>Subjects</Text>
        </TouchableOpacity>
      </View>
    </TouchableOpacity>
  );
};

Editing Grade Levels

From learners-page.tsx:486-569, you can update a child’s grade level:

const handleUpdateGradeLevel = () => {
  if (!currentEditLearner) {
    setError('No learner selected for editing');
    return;
  }
  
  let gradeLevelNum: number;
  if (editGradeLevel === 'K') {
    gradeLevelNum = 0; // Kindergarten
  } else {
    gradeLevelNum = parseInt(editGradeLevel);
    if (isNaN(gradeLevelNum) || gradeLevelNum < 0 || gradeLevelNum > 12) {
      setError('Please enter a valid grade level (K or 1-12)');
      return;
    }
  }
  
  updateGradeLevelMutation.mutate({
    userId: currentEditLearner.id,
    gradeLevel: gradeLevelNum.toString(),
  });
};

Updating a child’s grade level adjusts their recommended curriculum and lesson difficulty automatically.

Configuring Learner Profiles

Setting Subjects

From learners-page.tsx:329-337, you can configure:

Active subjects - What the child is currently learning
Recommended subjects - Suggestions based on their progress
Struggling areas - Topics needing extra attention

const openSubjectsModal = (learner: any, profile: any) => {
  setCurrentEditLearner(learner);
  setCurrentProfile(profile);
  setSubjects(profile.subjects || ['Math', 'Reading', 'Science']);
  setRecommendedSubjects(profile.recommendedSubjects || []);
  setStrugglingAreas(profile.strugglingAreas || []);
  setSubjectsModalVisible(true);
};

Knowledge Graph

The knowledge graph visualizes learning concepts and their relationships: From learners-page.tsx:339-360:

const openGraphModal = (learner: any, profile: any) => {
  setCurrentEditLearner(learner);
  setCurrentProfile(profile);
  
  if (profile && profile.graph) {
    setGraph(profile.graph);
  } else {
    // Initialize with default concepts
    setGraph({
      nodes: [
        { id: 'math', label: 'Mathematics' },
        { id: 'algebra', label: 'Algebra' },
        { id: 'geometry', label: 'Geometry' },
        { id: 'reading', label: 'Reading' }
      ],
      edges: [
        { source: 'math', target: 'algebra' },
        { source: 'math', target: 'geometry' },
      ]
    });
  }
  setGraphModalVisible(true);
};

Best Practices

Accurate Grade Levels

Keep grade levels up-to-date as children advance to ensure appropriate content difficulty.

Multiple Children

Each child should have their own account for personalized learning paths.

Subject Configuration

Review and update subjects regularly based on school curriculum and interests.

Privacy

Use first names or nicknames rather than full names for additional privacy.

Troubleshooting

Child not appearing in list

If a newly created child doesn’t appear:

Refresh the page
Check for error messages during creation
Verify you’re logged in as a PARENT role
Ensure the creation was successful (look for success toast)

Can't update grade level

If grade level updates fail:

Ensure you selected a valid grade (K-12)
Check your internet connection
Try logging out and back in
Contact support if the issue persists

Missing learner profiles

Learner profiles are created automatically when you add a child. If missing:

The system will create it on first access
Grade level defaults may apply
You can manually set all preferences

Next Steps

View Dashboard

See all your children at a glance

Track Progress

Monitor learning activity and achievements

Set Up Goals

Create learning objectives for your children

Configure Rewards

Set up motivational incentives

Parent Guide

Managing Learning

Advanced

Adding and Managing Children

Adding and Managing Children

Creating Learner Accounts

From the Dashboard

Using the Dedicated Page

Required Information

Grade Level Conversion

The Add Learner Form

Form Validation

Creating the Account

Managing Existing Learners

The Learners Page

Learner Cards

Editing Grade Levels

Configuring Learner Profiles

Setting Subjects

Knowledge Graph

Best Practices

Accurate Grade Levels

Multiple Children

Subject Configuration

Privacy

Troubleshooting

Next Steps

View Dashboard

Track Progress

Set Up Goals

Configure Rewards

Parent Guide

Managing Learning

Advanced

Documentation Index

​Adding and Managing Children

​Creating Learner Accounts

​From the Dashboard

​Using the Dedicated Page

​Required Information

​Grade Level Conversion

​The Add Learner Form

​Form Validation

​Creating the Account

​Managing Existing Learners

​The Learners Page

​Learner Cards

​Editing Grade Levels

​The Edit Modal

​Configuring Learner Profiles

​Setting Subjects

​Knowledge Graph

​Best Practices

Accurate Grade Levels

Multiple Children

Subject Configuration

Privacy

​Troubleshooting

​Next Steps

View Dashboard

Track Progress

Set Up Goals

Configure Rewards

Adding and Managing Children

Creating Learner Accounts

From the Dashboard

Using the Dedicated Page

Required Information

Grade Level Conversion

The Add Learner Form

Form Validation

Creating the Account

Managing Existing Learners

The Learners Page

Learner Cards

Editing Grade Levels

The Edit Modal

Configuring Learner Profiles

Setting Subjects

Knowledge Graph

Best Practices

Troubleshooting

Next Steps