Vitsmida
Structured lessons, class learning, and self-serve progress.
v0.5.0
HELP AND GUIDES

Find the right guide before you get stuck.

This help hub collects the current learner, teacher, Organisation Admin, Platform Admin, troubleshooting, device, privacy, and what-changed guidance in one place.

Learner quick-start and continuationTroubleshooting and recoveryDevice, browser, offline, and privacy expectationsWhat changed in the current build (0.5.0)
LEARNER GUIDE

Learner quick-start and continuation

Use one learner account for self-serve study, class-linked work, and return visits so progress stays in one place.

Open guide
RECOVERY GUIDE

Troubleshooting and recovery

Use these recovery checks for sign-in, wrong-account invites, join-code issues, and missing-access confusion before escalating.

Open guide
EXPECTATIONS GUIDE

Device, browser, offline, and privacy expectations

Vitsmida supports an installable app shell and local recovery on the current device, but shared class data and fresh server reads still need a connection.

Open guide
WHAT CHANGED

What changed in the current build (0.5.0)

These notes explain the current development-line changes in plain language by role, including whether action is required or only useful to know.

Open guide

Published guides

These sections stay grounded in the current product and link back to the screens that already exist.

LearnersLEARNER GUIDE

Learner quick-start and continuation

Use one learner account for self-serve study, class-linked work, and return visits so progress stays in one place.

Best when you need
  • signing in or signing up as a learner
  • understanding self-serve versus class-linked access
  • finding your next study or assigned step
Start here

New learners create a learner account, finish onboarding, choose a language track, and land in learner home. Returning learners should sign in with the same email so progress and class links stay on one account.

Keep self-serve and school access together

You do not need a second learner account when a teacher later invites you. The same learner account can hold self-serve collections, organisation-linked lessons, and assigned work.

Check these places when something feels missing

Start with Learner home, then check Classes for linked access and Inbox for due work or follow-up signals.

  • Use Classes when a join code or invitation is real.
  • Use Learner home for assigned work, recent study, and self-serve collections.
  • Use Profile to confirm your account details and current learner setup.
TeachersTEACHER GUIDE

Teacher setup, classes, and follow-through

Teacher access is invitation-led, and the current steady path is classes first, then roster or invites, then collections, analytics, and inbox follow-through.

Best when you need
  • accepting teacher access
  • creating classes and linking learners
  • reviewing analytics and assignment follow-through
Teacher access starts with an invitation

Use the invited email, accept the invitation, and treat expired invitations as an access issue that needs a fresh invite rather than a new account.

Use this classroom order

Create or open a class, prepare learner access through roster or join-code flow, then assign collections and monitor what needs follow-up in Analytics or Inbox.

Keep the current product boundary honest

Analytics is a shared aggregate view with comparison and intervention tracking. It is not yet a final learner-by-learner reporting system.

  • Use Analytics to spot lessons or classes that need attention.
  • Use Inbox when you want the next grounded action without scanning every page.
  • Escalate organisation setup or platform-wide issues instead of forcing them through teacher pages.
Organisation AdminsORGANISATION ADMIN GUIDE

Organisation access, staffing, and support boundaries

Organisation Admins work inside one organisation, using the teacher-side operations surfaces to manage access, learner linkage, and support hand-offs.

Best when you need
  • staff-access and invitation follow-through
  • learner roster and linkage health
  • understanding when to escalate to Platform Admins
This role stays inside one organisation

Organisation Admins coordinate staffing, access, learner linkage, and teacher support inside their own organisation. Platform-wide creation, deployment, and release decisions stay outside this role.

Start with operations health

Check staff access, invitation state, and learner roster health before assuming a class or content workflow is broken.

Use this hand-off rule

If the problem is bigger than one organisation, or depends on platform setup, environment changes, or code repair, pass it to a Platform Admin or engineering contact instead of treating it as an organisation-side workflow.

Platform AdminsPLATFORM ADMIN GUIDE

Platform operations, support tasks, and release confidence

Platform Admins handle shared setup, invite delivery watch, platform content tooling, and the bounded release-readiness view across the whole product.

Best when you need
  • creating organisations and issuing first-teacher access
  • reviewing support-safe delivery outcomes
  • checking release readiness before Phase changes
Treat the admin hub as the steady starting point

Platform Admin work is about shared platform setup and support, not one organisation's day-to-day classroom delivery.

Use release readiness as an evidence view

The release-readiness page collects current evidence, operational signals, and residual debt. It is not a deployment button or production incident console.

Separate routine work from engineering-only work

Organisation setup, invitation handling, and content operations are routine product work. Migrations, deployment, secrets, and infrastructure failures are engineering-only escalation paths.

All usersRECOVERY GUIDE

Troubleshooting and recovery

Use these recovery checks for sign-in, wrong-account invites, join-code issues, and missing-access confusion before escalating.

Best when you need
  • password reset or sign-in trouble
  • invitation and wrong-email confusion
  • missing classes, assignments, or access
If sign-in is blocked

Use password reset before creating a second account. If the email is wrong on an invitation, sign out and continue with the invited email instead.

If a join code or invitation does not work

Check whether the code or invite is still current, whether you are signed in with the right account, and whether the role matches the flow you are trying to enter.

  • Learner class invites only work for the invited learner email.
  • Teacher access is invitation-led; it is not a public sign-up route.
  • Expired invitations need a new invite rather than repeated retries.
If expected work is missing

Check Classes first for linked access, then Learner home or the teacher workspace for assigned work and follow-up, then Inbox for grounded reminders. If the issue is really about organisation or platform access, escalate it rather than treating it as a lesson bug.

All usersEXPECTATIONS GUIDE

Device, browser, offline, and privacy expectations

Vitsmida supports an installable app shell and local recovery on the current device, but shared class data and fresh server reads still need a connection.

Best when you need
  • understanding offline and sync limits
  • checking browser and device expectations
  • understanding practical privacy and data behaviour
Main places in the app
Browser and device expectations

Use a current desktop or tablet browser for the most reliable experience. The installable app shell is supported, but the current product should still be treated as an online-first classroom system.

Offline and sync remain bounded

Cached lesson pages and local learner state can survive on the current device, but fresh shared data, class updates, and server-backed reads still need a connection.

Practical privacy expectations

The product keeps learner progress, quiz attempts, and account data tied to the signed-in account. Browser-local lesson analytics is diagnostic and secondary, while shared teacher analytics uses persisted progress and attempt records rather than claiming a wider surveillance model.

All usersWHAT CHANGED

What changed in the current build (0.5.0)

These notes explain the current development-line changes in plain language by role, including whether action is required or only useful to know.

Best when you need
  • understanding recent workflow changes
  • seeing whether your role needs to do anything differently
  • finding the right guide after a bigger change
Learners

Learner home is the steady signed-in destination, with assigned work, organisation-priority content, and self-serve collections kept together. No action is required if you already sign in with the right learner account.

Teachers and Organisation Admins

Teacher workflows now keep classes, collections, analytics, organisation operations, and inbox follow-through easier to reopen from one signed-in workspace. Use the role guide if you are unsure which page now owns a task.

Platform Admins

Platform operations now include a bounded release-readiness view plus the current content and invite-delivery tooling. Use the platform guide if you need a plain-language reminder of which tasks are routine product operations versus engineering-only work.