Skip to content
NesiciCoding edited this page Aug 12, 2026 · 1 revision

FAQ

General

Do I need an account to use Rubric Maker?

No. The app runs entirely in the browser — open it and start. Connecting a Supabase backend is optional and only needed for cloud features (sync across devices, colleague sharing, the student portal, the marketplace).

Is my data stored on a server?

Without Supabase, everything stays in your browser's localStorage (plus IndexedDB for recordings) — nothing is sent anywhere. With Supabase, data is mirrored to the instance you connect (your own project or school server). See Data & Privacy.

Which browsers are supported?

Chrome, Edge, Firefox, and Safari (recent versions). Voice grading and voice feedback need Chrome or Edge. The app is installable as a PWA on desktop and mobile.

Does it work offline?

Yes. In local mode everything works offline from localStorage. With Supabase connected, the app keeps working offline and syncs changes when the connection returns.

Can I use it on my phone or tablet?

Yes — the grading interface is optimised for tablets (iPad portrait/landscape), and the student portal works on phones.

Rubrics & grading

What scoring modes are available?

Total points, weighted percentage, and single-point rubric. See Features → Rubric Builder.

Can I grade a group project with one grade?

Yes — select 2+ students from the Rubrics list and grade them as a group; scores fan out to everyone. Individual criteria can be excluded from the fan-out with the per-criterion "Group grading" toggle.

Can students review each other?

Yes — peer review, plus self-assessment. See Features → Self-Assessment & Peer Review.

Can I get a second opinion on a grade?

Yes — send a graded submission to a colleague for co-grading; disputes surface in the Moderation queue. See Features → Co-grading & Moderation.

Tests, flashcards & practice

Can I reuse test questions?

Yes — save any question to the Question Bank and insert it into other tests, including whole reading/listening passage bundles. See Tests & Practice.

Do practice tests affect students' grades?

No. Practice-mode results appear in a separate panel and never blend into the graded CEFR chart or statistics.

How does the placement test know a student's level?

With three calibration-free engines (multistage, staircase, generator) that adapt from the answers the student gives during the test — no historical data needed. See Tests & Practice → Placement.

Sync, sharing & the student portal

How do I get the student portal?

Connect Supabase, add students, then generate share links/QR codes from the Rubrics, Tests, Essays, or Students pages. See Student Portal.

Can I share a rubric with a colleague?

Yes — share a rubric or class with another teacher (viewer or editor), publish to the school Marketplace, or use department sharing. See Supabase Sync.

What's the difference between the Marketplace and department sharing?

The Marketplace publishes a cloned snapshot colleagues can browse, clone, and upvote. Department sharing makes the live rubric read-only-visible to every teacher in your school.

Exports & backups

What can I export?

PDF and Word (.docx) reports (including branded mail-merge templates), CSV score tables, Markdown (essays), JSON backups, Magister/SOMtoday gradebook presets, and .ics calendar files for due dates. See Features → Export.

How often should I back up?

Regularly — especially on shared/managed devices. Use Settings → General → Export backup (or the admin flow in Settings → Administration). See Data & Privacy.

Where do backups go?

They download as a JSON file to your device. With Supabase connected, nightly per-owner backups are also written to the backups storage bucket.

Roles & administration

What do the roles mean?

teacher (default for staff), admin (full control — users, schools, database, retention, audit), observer (read-only access), and student (portal access). Roles are enforced via Supabase Row-Level Security. See Features → Admin Dashboard.

Can I delete a student permanently?

Students can be soft-deleted, then Restore or Anonymize from Admin → Archive. Anonymizing scrubs personal data while keeping aggregate grade history for reporting.

Who can see the audit log?

Only admins — Admin → Audit. It logs role changes, deletions, grade saves, rubric edits, exports, and auth events, with configurable retention (see Data & Privacy).

Privacy & GDPR

Is the app GDPR/AVG compliant?

It's designed for compliance: no telemetry, opt-in network requests, an in-app privacy page, data anonymization, configurable retention, and EU-region hosting guidance for Supabase. The institution running the app is the data controller — see Data & Privacy and the repository's PRIVACY.md.

Does the app use AI?

No AI generation anywhere. Document analysis, grammar checking, vocabulary profiling, and learning-path recommendations are rule-based and deterministic. See Features.

Troubleshooting

The app opens but shows a blank page

Check the browser console (F12). A missing module usually means npm install didn't complete — see Installation → Troubleshooting.

It says "RubricMaker is already open"

By design, only one tab can run the app at a time (a Web Locks API lock prevents two tabs from racing on the same data). Close the other tab or window and reload.

Sync says "Failed to connect"

Check the URL (https:// for cloud, http://127.0.0.1:54321 for local) and that the anon key is the full JWT string — see Supabase Sync → Troubleshooting.

My data is out of sync between devices

Use Pull database → local (or Push local → database) from Admin → Database to force a refresh in the right direction.

Clone this wiki locally