Quizzer
A revision app for iOS and macOS, with quizzes written as XML and played as swipeable cards.
- Swift
- SwiftUI
- iOS
- macOS
- SwiftMath
- Spaced repetition
- XCUITest
- Swift Testing
Eight question types, from labelling diagrams to typing answers in LaTeX, with lenient marking, units and significant figures, and spaced-repetition reviews. One SwiftUI codebase builds native iPhone, iPad and Mac apps.
Quizzer turns revision notes into quizzes in the spirit of Seneca Learning. Each quiz is an XML file with an XSD schema and a format guide. The app loads it into a stack of cards that you answer, check and swipe away. It's a native SwiftUI rewrite of an earlier Android prototype, built from one target for iPhone, iPad and Mac.
Question types
| Type | What you do |
|---|---|
| Multiple choice | Pick one, or select all that apply |
| Fill the gap | Type text, numbers, quantities with units, or LaTeX |
| Ordering | Drag or nudge items into sequence |
| Matching | Pair items from two columns |
| Label the diagram | Drop labels onto numbered points |
| True or false | Including "correct the statement" for false ones |
| Sort into groups | Drag items into categories |
| Tap the spot | Tap a region of an image |
Marking that's fair
Marking is the heart of the app:
- Fuzzy text matching. Typos within a tolerance are accepted and the correction is shown. Synonym groups declared in the quiz (hypermetropia and hyperopia, say) count as the same answer.
- Quantities. Answers like
-0.50 mare parsed into a value and a unit, and checked to the required significant figures. - LaTeX. Answers typed as LaTeX get a live preview and are normalised before they're compared, so differences in spacing and notation don't count against you.
Maths is rendered natively everywhere with SwiftMath, with no web views.
Learning, not just testing
- Wrong answers come back once at the end of the quiz. Skip sends a card to the back, and Undo brings the last one back.
- The results screen shows your first-attempt score, with an option to practise only your mistakes.
- First attempts are scheduled for review with the SM-2 spaced-repetition algorithm, and questions that are due appear at the top of the library.
Engineering
The app is split into model, parsing (an XMLParser-based DOM), grading, session, progress and
library layers, with platform differences kept in one file. There are 59 tests: unit tests in
Swift Testing, and end-to-end XCUITest runs that play real quizzes. Debug launch arguments
(-openQuiz, -startAt, -demo) open any question in any state, and every screenshot here was
taken that way.