Guides & FAQ

Documentation & System Help

First-Time Quick Setup
Step 1 Enter Parent Portal

From the main login hub screen, click the big Parent Portal button. This opens your admin dashboard where you control the entire system.

You must establish a 4-digit security PIN upon your first entry. This PIN restricts student access to the administrative and planning sections of the application. To adjust where the PIN is required, access the PIN Security Settings located on the Login Hub.

Step 2 Add Students & Subjects

Go to Settings on the dashboard to set up your foundation.

  • Students: Add names, choose emojis, and set their pacing modes. (Tip: Right-click text boxes on a PC, or use your tablet's on-screen keyboard to insert emojis!)
  • Subjects: Add your custom subjects and label them Core or Non-Core.
  • Starter Pack: (Optional) Click the Starter Pack to instantly add common chores and rewards.
Step 3 Set School Days

Go to the Master Calendar on the dashboard.

  • Toggle the S-M-T-W-T-F-S buttons to select the days you do schoolwork.
  • Click specific dates on the calendar to "Blackout" holidays and time off.
Step 4 Add Your First Task

We recommend creating courses in the Curriculum Vault Curriculum Library tab first. Once built, assign the curriculum to a student and use the Vault Fill button inside the School Planner to automatically schedule their weekly tasks.

Alternatively, you can manually schedule tasks on the fly using the Task Scheduler (the blue tab on the left edge of your screen). This slide-out panel lets you quickly add one-off tasks, recurring assignments, or multi-day projects directly to the calendar.

Step 5 Custom Chores & Rewards

Go to the Chores & Economy section. If you didn't use the Starter Pack, open the Bonus or Rewards tab. Use the input bar to type a name, set points, choose frequency, and click Add.

Step 6 Test the Student App

Once you finish setup, click the 📱 Login Hub button at the very top of the Parent Portal. From there, click a student's profile to see exactly what their daily app looks like!

Step 7 Install on Your Phone

Add Homeschool Tally to your home screen so it opens like an app.

Apple / iOS (Safari only)

  1. Open Safari on your iPhone or iPad. This will not work in Chrome on iPhone.
  2. Go to the page in the app you want on your home screen.
  3. Tap the Share button at the bottom of the screen (square with an arrow pointing up).
  4. Scroll down and tap Add to Home Screen.
  5. Tap Add in the top-right corner. The app icon will appear on your home screen.

Android (Chrome)

  1. Open Chrome on your phone or tablet.
  2. Go to the page in the app you want on your home screen.
  3. Tap the Menu icon in the top-right corner (three vertical dots).
  4. Tap Add to Home screen (or Install app).
  5. Tap Add on the popup to confirm. The app icon will appear on your home screen.
Parent Portal Row Buttons

These quick-access buttons are located at the top of your dashboard.

Weekly Wrap-Up & Grading

Navigating the Week

The top navigation bar displays the current week. Click on any specific day to instantly review or edit its logged tasks and hours.

Global Pacing Thresholds

The pacing percentage sets your target tolerance for expected versus actual time spent. You can adjust this globally, or set custom thresholds per student in their specific view.

Child Dashboard Overview

Each student's card provides a high-level summary of their day. It tracks total completed tasks and shows their current pacing. If tasks require a grade, the grading indicator pulses red. You can enter missing grades directly in the data grid below.

Task List & Editing

The task grid functions like a standard spreadsheet. Click any field to edit time, grades, or attach portfolio evidence instantly.

Overdue Tasks & Chores

When the alarm clock icon is pulsing red, you have past-due tasks or chores to triage.

  • Bulk Actions: Move selected overdue tasks to today, mark them complete, or delete them entirely.
  • Inline Editing: Adjust the date, subject, or expected time directly from the list.
Approval Bell

When the bell icon is pulsing red, you have items requiring parent review.

  • Review Items: Handles reward purchases, free work tasks, bonus chores, and tasks that need manual grading or fell below the minimum grade threshold.
  • Approve or Deny: You can approve items to award points, or deny them.
Checklist

Provides a quick scratchpad and to-do list that persists across all tabs in the portal without obstructing your view. Keep your daily notes organized here.

Settings & Logout

Open the Settings gear icon in the upper-right corner of the Parent Portal. On phones, some top-bar shortcuts (Community Hub, Master Data Log, Master Calendar) also appear here.

  • Light / Dark Mode: Changes the portal appearance. Stored on this device only.
  • Undo / Activity Log: Shows recently completed tasks, chores, and reward redemptions. Click Undo to reverse an accidental completion within the last 24 hours.
  • Report Bug: Sends feedback or error reports to the dev team.
  • System Config: Opens the full family setup panel — students, subjects, economy starter pack, backups, and security. See the dedicated guides below for what each section loads or changes.
  • Guides & FAQ: Opens this documentation window.

Logout: Signs you out of your account. On desktop, the logout icon is at the far right of the portal row; on mobile it appears at the bottom of the Settings menu.

System Config — Student Settings

Settings → System Config → Student Settings

Add, edit, or remove student profiles. This is where child dashboards are created and how each student experiences the app.

  • Add a student: Fill in the new-student cards at the top and click Add. Creates their login profile, dashboard theme, and planner row.
  • Profile (emoji & color): Sets how the student appears on their dashboard and in the parent portal.
  • Account status (Active / School / Chores): Pause all activity, schoolwork only, or chores only without deleting the student.
  • Visibility (Tasks, Chores, Rewards, Extras): Controls which sections appear on that student's dashboard. Turn a section off to hide it completely.
  • Gatekeepers: Locks Rewards or Extras until today's tasks and chores are finished.
  • Pacing (Strict Daily / Earn Tomorrow / Own The Week): Controls how unfinished schoolwork rolls forward on the student dashboard.
  • Grade level & school year: Sets the academic year label shown on their record.
  • Prior hours (Core / Non-core): Enter hours already completed before using the app. Adjusts pacing displays only — not added to the Master Data Log.
  • Grading rules (Enforce grades / Global min %): Requires scores on graded tasks and triggers Approval Bell warnings when grades fall below your threshold.
  • Reset student: Wipes the current year's tasks, hours, and points for that student while keeping their profile.
  • Delete student: Removes the student entirely. Past records can be restored via CSV import if you recreate them with the same name.
System Config — Manage Subjects

Settings → System Config → Manage Subjects

Define the subjects used across the planner, vault, timers, and state hour tracking. The School Planner and Curriculum Vault stay inactive until at least one subject exists.

  • Add a subject: Enter a name, pick an icon (right-click an icon to change it), choose a color, and mark it Core or Non-Core. Core hours count toward Missouri's 600-hour minimum; non-core hours count up to 400 until core is met.
  • Edit or delete subjects: Changes apply to future assignments. Existing logged tasks keep their original subject label.
  • Time-based rewards (pts / 30m): Sets how many economy points a student earns for every 30 minutes spent on academic tasks (timer-based schoolwork). Loaded here; spent in the Rewards store.

School year start/end dates and blackout days are set in Master Calendar (top bar), not in this section.

System Config — Economy Starter Pack

Settings → System Config → Economy Starter Pack

Loads a pre-built set of popular chores, bonus activities, and rewards into your Chores & Economy section. Use this when setting up the points system for the first time instead of creating every item manually.

  • What it loads: Default daily chores, bonus tasks, and reward-store items with point values already assigned.
  • After loading: Edit, delete, or add more items in the Chores & Economy tab. Assign chores to students and days from there.
  • Does not change: Student point balances, completed chores, or school tasks.
System Config — Data Safety & Time Machine

Settings → System Config → Data Safety & Time Machine

Backup, restore, archive, and year-rollover tools. Use this section when you need to download your records, import old data, or start a new school year.

  • Cloud storage preference: Keeps your planner synced across devices via Firebase (recommended). Local-only mode is not yet available.
  • Backup reminders: Opt in to get nudges on the Approval Bell when it is time to download a CSV backup again.
  • Download Full Backup Now: Exports all family academic data to a CSV file on your computer. Your personal safety net — cloud sync is not a substitute for your own backup.
  • Archive & Start New Year: Saves the current year to Time Machine history, then clears tasks and hours for a fresh year. Preserves students, subjects, economy items, and settings.
  • Time Machine (Archived Years): Load a past archived year in read-only mode. Click Return to Live App at the top to come back to the current year.
  • Import CSV Backup: Uploads a previous spreadsheet. Does not delete current data — imported tasks are added to matching students' existing records.
  • Manual CSV Export: Download a single student's academic history or a scoped export from the dropdown.
System Config — Security Settings

Settings → System Config → Security Settings

Account login credentials and parent PIN controls. Separate from student profiles — these protect access to the Parent Portal.

  • Change Account Password: Updates your login email password (Firebase auth). This is not the 4-digit parent PIN.
  • Update Security PIN: Changes the 4-digit PIN required to enter the Parent Portal from student-facing screens.
  • PIN Required To Reach Parent Portal: Toggle PIN prompts on or off for each entry path — Login Hub, Child Dashboard, and Family Mode. Turn a toggle OFF to skip the PIN when coming from that screen.

PIN route toggles on the Login Hub itself are configured separately on the Login Hub screen under PIN Security Settings.

Top Bar Modules
Community Hub

A directory for local events, co-ops, and field trips.

  • Filtering: Enter your ZIP code to filter events by proximity.
  • Direct Scheduling: Click "Add to Planner" on any event to inject it straight into your Master Calendar as a future event.
Master Data Log

The Master Data Log is the raw database of every Academic Task your children have completed. Chores and rewards are intentionally excluded so you have a clean record for state reporting. Open it from the Master Data Log button in the top navigation row (on phone: Settings → Master Data Log). This is also where you open the State Report to review and print your official homeschool records.

Editing on Screen

Click directly into any row to edit it — no separate edit mode required.

  • Date: Click the date field to change when the task was logged.
  • Subject: Use the subject dropdown to reclassify a task (Core vs Non-Core hours follow the subject label).
  • Description: Click the description text to edit what was completed.
  • Time: Click the hours or minutes fields to adjust logged instructional time.
  • Grade: Click the grade cell to enter or change a score.

Filtering & Sorting

  • Filter by student: Use the student buttons above the table to show one child or all students.
  • Filter by subject: Choose a subject from the Subject dropdown, or leave it on All Subjects.
  • Filter by date range: Set a start and end date to narrow the list to a specific period.
  • Search keyword: Type in the search box to find tasks by description text.
  • Sort by column: Click any column header (Date, Student, Subject, Description, Time, Grade, or Img) to sort ascending or descending. Click the same header again to reverse the order.
  • Yellow ! (ungraded items): Click the amber ! icon next to the Grade column header to pull every item that is missing a required grade to the top of the list. Click again to turn the filter off.

Photos & Attachments

In the Img column, use the paperclip icon to upload a file from your device, or the camera icon to take a portfolio photo. Click an existing thumbnail to view it full size. Hover a photo and use the refresh icon to replace it.

Reassign a Task

Click the calendar-plus icon at the end of any row to reassign that task. The completed log entry and its logged hours stay in place — the app copies the same task onto the planner for a new day (Today, Tomorrow, or a date you pick). Use this when a student needs to redo work or you want the same assignment scheduled again.

State Report (Print Official Records)

Click State Report in the top-right toolbar of the Master Data Log to open your printable progress report. It compiles logged academic hours, subjects, and grades from this log into a state-ready document. Review and edit any entries in the log first, then use your browser's print function to save or print the report for your homeschool files.

Export & Delete

  • Export: Click Export in the top-right toolbar to download your full Master Data Log as a CSV spreadsheet.
  • Delete: Check rows and use Delete to remove mistaken entries, or click the trash icon on a single row.
Master Calendar

The Master Calendar defines the boundaries of your school year and controls which days tasks can be scheduled.

  • School Dates: Set start and end dates.
  • Blackout Days: Mark specific dates as holidays or off-days where tasks cannot be assigned.
  • Events: Add field trips or appointments. These block off time for your weekly scheduling.
Login Hub

Clicking this module returns you to the main student login screen where kids can access their individual profiles.

Student Dashboard Guide
Grid Mode
The Condensed Card (Default View)

The default view displays top-level metrics for quick daily assessment.

  • YTD Progress & Hours: Tracks logged hours against the yearly goal.
  • Pacing & Estimated Finish Date: Shows projected completion based on daily pace.
  • This Week: Progress bar tracking weekly hours against the weekly goal.
  • Point Adjuster [-/+ Pts]: Instantly add or remove economy points or grant a reward directly.
  • Daily Tasks & Chores: Summary of task/chore counts. Missed work triggers an "Overdue" alert button.
The Expanded Card

Clicking anywhere on a student's grid card expands it.

  • Subject Hours & Grades: Displays progress, hours, and overall average grade for every active subject.
  • Economy & Stats: Shows available reward point balance, a 7-day trend, and action alerts for approvals/grading.
List Mode

Using the toggle at the top of the dashboard switches the view to a horizontal list.

List View Condensed

Displays students in rows comparing YTD, Pace, Estimated Finish, Weekly Hours, and Task/Day counts side-by-side. Includes the [-/+ Pts] button to adjust points.

List View Expanded

Clicking a row in List View reveals a horizontally scrolling tracker of all Subject totals and Daily Chore completion.

School Planner Guide
Global Controls & Navigation

Weekly Calendar Navigation

Located at the top of the module, the calendar header controls which week you are viewing and editing.

  • Scroll Weeks: Move forward or backward in time.
  • Current Week: Click the return button to instantly snap back to the present week.
  • Jump to Week: Click the calendar icon to jump straight to a specific week.
  • Lesson Plan, List, & Summary: Switch between these views. Lesson Plan and List show scheduling data. Summary tells you how many hours are scheduled per day and per week for a quick glance to make sure you are still on track.
  • Student Filter: Click the funnel icon to show/hide specific students.
  • Vault Fill: Automatically pulls the next sequence of assigned tasks from the Curriculum Vault into the current week.
  • Needs Review: Pulls any task that didn't have a time or grade entered to the top for quick editing. Click it again to return to normal view.
  • Show / Hide Complete: Toggle to show or hide tasks that have already been marked finished.
  • Settings Button: Opens a dropdown containing options to complete the entire week, copy last week's schedule, push all unfinished tasks to next week, or reset the entire week.
Lesson Plan Mode (Grid)

Lesson Plan mode is your primary daily workspace in a standard grid format.

1. Student Header Area
  • Collapsible Side: The student header area can be collapsed to the side using the collapse button at the very top in the student cell to save horizontal space.
  • Bulk Edit Button: Use this tool to quickly complete or delete multiple entries at once.
  • Weekly Hour Tracking: Displays Total Hours, Core Hours, and Non-Core Hours.
2. Task Grid Operations
  • Task Cards: Click the empty circle/checkbox on a card to mark it finished.
  • Editing: Click anywhere else on the card to open it in the Task Scheduler side panel.
  • Moving/Deleting: Use the Task Scheduler panel or List view to move or delete tasks.
  • Group Sessions: Click the group icon in the bottom navigation bar to start a single, synchronized timer for multiple students.
List Mode

List Mode provides a vertical view of scheduled tasks.

  • Organization Toggle: Click the header label to switch between organizing by Student or by Day.
  • Editing Tasks: Click the edit button on a task row.
  • Deleting Tasks: Click the trash button to delete a task.
  • Add Task: Quickly insert a new assignment directly into the schedule.
  • Finish Day: Mark all remaining tasks for a specific day complete.
Grading
Enforcing & Configuring Grades

Grading is an optional feature that must be activated and configured before use.

  • Activating Grading: Go to Settings on the Parent Portal dashboard. Scroll down to Student Settings, find your student's profile, and toggle Enforce Grades in their Academic Profile.
  • Setting Thresholds: Once enabled, you can establish an overall Global Min % baseline. For subjects requiring stricter or more lenient scoring, you can set custom percentage overrides right beneath the baseline.
  • Student vs. Parent Grading: In the same config menu, you decide who is permitted to input grades. Restrict grading permissions to Parents Only, or toggle permissions to allow students to self-grade directly from their Child Dashboard.
Adding, Changing & Reassigning

The data architecture is completely flexible, meaning a grade can be added, changed, or corrected in any of the following locations:

  • The Approval Bell: If a submitted task falls below the minimum threshold, or if self-grading is enabled, it intercepts and pulses at the Approvals Check bell for parent review.
  • Weekly Wrap-Up: The Wrap-Up data grid lets you instantly type in or alter grades. You can also click the checkbox next to any grade box to toggle a task between graded and non-graded on the fly.
  • School Planner: Whether in Lesson Plan (Grid) or List Mode, you can click directly into the grade bubble on a completed task card to add or adjust a score instantly.
  • Master Data Log: Click into any field on a row to edit date, subject, description, time, or grade. Use the reassign button to schedule the same task again while keeping the original logged hours.

Reassigning Low Grades

If a student submits work that is too low or doesn't meet the threshold, you can easily push it back to the student for a retry from the Weekly Wrap-Up, the Master Data Log, or the Curriculum Vault student editor.

Viewing & Reporting
  • Master Data Log: Finalized grades populate immediately into your raw database. Click the amber ! next to the Grade column header to sort ungraded items to the top, or click column headers to sort by grade.
  • State Report: Open Master Data Log and click State Report in the toolbar to print your official records. The report automatically calculates logged hours, subjects, and grades into a compliant progress document.
Curriculum Vault

The Curriculum Vault has three tabs: Dashboards (assigned curriculums per student), Curriculum Library (your family's personal curriculum builder), and Master Library (communal curriculum sharing — currently under construction).

Adding New Curriculum

To begin, open the Curriculum Library tab and click Create New.

1. Basic Info & Task Types
  • Title & Subject: Add your Curriculum Name at the very top of the screen and select the corresponding Subject.
  • Task Types: Decide what types of tasks this curriculum will have (e.g., Reading, Quiz, Test, Practice).
  • Time Estimates: Estimate how long each task type will take a child to complete. Note: This can always be customized later per student. The app will also alert you if a certain amount of tasks in a row are over or under the threshold once assigned to a student, so pacing can be custom-tailored to them.
2. Modules & Tasks
  • Naming Books/Modules: To change the name of the first book or module in the series, look to the left sidebar and edit the text under "Module Title". Once named, you can begin adding your tasks.
  • Adding Tasks: You can add tasks manually row-by-row, or copy/paste a list to generate rows automatically. You can set the Task Type and Graded status individually for each task, or use the bulk tools.
3. Bulk Edit Options

If you need to make sweeping changes, click the Bulk Edit Tool button.

  • Search & Filter: Type a keyword into the search bar (for example, search for any task that says "Test"). The grid will filter to show only those tasks.
  • Bulk Apply: Once filtered, use the bulk tool bar to change the Task Type to "Test" and check the "Graded" box. Click apply, and every filtered task will update at once.
  • Bulk Find & Replace: You can also use the Find and Replace fields at the top of the editor to quickly rename multiple tasks simultaneously.
Assigning Curriculums

Find a curriculum in your Curriculum Library via the search bar, subject filter, or by scrolling through the list. Click Assign and select the student you want to assign it to.

Step 1: Pacing & Time Estimates
  • Pacing Method: Choose whether the app automatically determines how many tasks need to be assigned per week based on your completion date, or if you want to manually assign tasks each week. We highly suggest Auto-Pacing! The app will look at your existing calendar events and automatically distribute curriculum tasks to balance the hours across your week.
  • Estimated Time: Adjust how long each task type might take for this individual student. This can be changed later, and the app will alert you with suggested time changes if the student is consistently going way over or under the threshold on multiple tasks in a row.
Step 2: Dates & Days
  • Start & End Dates: Choose when you want to start and finish the curriculum. You can click the "Start of Yr" and "End of Yr" shortcut buttons to follow your predetermined school year from the Master Calendar.
  • Preferred Days: Decide if you only want this curriculum to fall on certain days of the week, or let the app place it on any day allowed for schoolwork.
Step 3: Curriculum Scope

Decide if you want to use the entire curriculum start to finish, or if you would like to customize your starting point and select exactly which tasks to include or skip.

Student Dashboards

The Dashboards tab organizes assigned curriculums by student. Select a student's tab to view their active "pills".

  • Progress Analytics: Each pill displays the percentage completed, average grade, tasks/books finished, and a breakdown of progress and times by task type.
  • Target & Pacing: Update the Estimated End Date and view live calculations of hours/week needed.
  • Add Tasks: Use this button to pull upcoming tasks from the sequence into the current week. You can use auto-add or jump to a guided manual selection.
  • Vault Fill Behavior: The Vault Fill button on the School Planner automatically pulls these assigned tasks into the calendar.
    • Pulse Alert: The button pulses if a student has active assignments but no tasks scheduled for the week.
    • Mid-Week Clicks: Schedules tasks only across the remaining available school days for that week.
    • Multiple Clicks: Will not duplicate tasks. It only fills what is missing to meet the weekly quota.
    • Returning Items: Delete a task from the planner or Unassign it to send it back to the top of the Vault queue.
    • Overdue Vault Tasks: Overdue tasks stay on the calendar. They must be completed, moved, or manually unassigned to clear the alert.
Student Curriculum Editor

Click Edit Student from any assignment pill on the dashboard to override data specifically for that child without affecting the Curriculum Library master copy.

  • Table Controls: Sort by columns, search tasks by keyword, toggle books open/closed, or hide completed tasks. Completed tasks missing grades or times will automatically sort to the top.
  • Inline Editing: Directly overwrite task text, grades, time spent, or completion dates for that student.
  • Skipping & Check-offs: Mark tasks done, or skip tasks entirely. Skipped tasks move to an archive at the bottom of the list.
  • Reassigning & Unassigning: Select tasks to reassign them to a specific future date, or click Unassign to put them back in the queue for auto-filling. You can also duplicate a completed task as a "Repeated Task" to redo it.
Master Library (Communal — Under Construction)

The Master Library tab is a separate communal space for browsing and sharing curricula across the Homeschool Tally community. It is not where you build your family's personal courses — use Curriculum Library for that.

This feature is still under construction. Full communal curriculum building and sharing tools are coming soon.

When complete, you will be able to discover community-built curricula and duplicate them into your personal Curriculum Library. For now, create and assign curriculums from the Curriculum Library tab.

Chores & Economy Guide
Global Controls & Navigation

Section Expand/Collapse

Clicking anywhere on the main section header will expand or collapse the entire Chores & Economy area.

Weekly Calendar Navigation

Located at the top of the module, the calendar header controls which week you are viewing.

  • Scroll Weeks: Use the left and right arrows to move forward or backward in time, allowing you to schedule future chores.
  • Current Week: Click the return button to instantly snap back to the present week.
  • Jump to Week: Click the calendar icon to open a date picker and jump straight to a specific week.
The Three Tabs
  • 📋 Required: Mandatory daily chores. You can set these to prevent a student from accessing rewards until completed (using Gatekeepers in System Config).
  • ⭐ Bonus: Extra activities, good behaviors, or optional chores that students can do to earn extra points.
  • 🎁 Rewards: Items, privileges, or screen time that students can purchase with their earned points.
  • Ownership Transfer: Drag and drop a chore from one student to another. The system will prompt you to either move the historical completion data to the new student or leave it with the original owner.
Quick Add System

To add a new item, use the input bar at the very top of the economy section. Type the name, set the point value, choose how frequency (Daily, Weekly, One-Time), and click Add. It will automatically drop into whichever tab you currently have open.

The Ledger

Click the Ledger button to view a complete financial history for your household. You can see exactly how students earned their points, what they spent them on, and adjust balances manually if needed.

Reward Requests & Approvals

When a student wants to buy a reward that requires parent permission (like "Go to the park" or "Stay up late"), it will send a notification to your Approvals Bell at the top of the Parent Portal. You can approve or deny the request from there.