Today’s Review

Today’s Review

Skillnote’s Today’s Review feature uses the Spaced Repetition algorithm to automatically surface questions on the days they’re due. All posts and questions scheduled for today appear on a single page, where you can select which posts to include before starting your session.


Screen State Flow

The Today’s Review page displays one of five states depending on the current situation.


State 1: Loading

When you first open the page, a loading screen is shown while the app fetches your review data from the server.

  • A spinner animation appears alongside the text “Loading…”.
  • No other UI elements are interactive during this state.

State 2: No Reviews Today

If there are no questions due today, an empty state message is displayed.

  • “No questions to answer today.”
  • “Write a new post to generate questions.”

As you consistently add posts, the spaced repetition algorithm will automatically schedule review sessions, and daily review questions will begin appearing.


State 3: Cover Page (Before Starting)

When review data is available, the cover page is shown. Before starting your session, you can get an overview of today’s content and choose which posts to include.

Cover Page Elements

Top area

  • A book-stack icon appears alongside the “Today’s Review” heading.
  • Once you select one or more posts, a “{N} sets” badge appears next to the heading.
  • The total number of questions across all selected posts is shown as “{N} questions”.

Progress section

  • Under the “Today’s Progress” label, the number of answered questions vs. the total is shown in “answered/total” format.
  • A progress bar below this gives a visual indication of how much of today’s review you’ve completed.

Start Review button

  • Click the “Start Review” button (with a play triangle icon) to begin your session.
  • If no posts are selected, the button is disabled, or clicking it shows a toast message: “Please select at least one post to review.”

Post List

The lower portion of the cover page displays a list of posts due for review today.

Each post item includes the following information.

ElementDescription
Selection toggleClick to include or exclude this post from the session.
D+{N} badgeShows how many days have passed since the post was written. Example: D+7 means 7 days after writing.
Post titleThe title of the original post from which questions were generated.
{N} questionsThe number of questions generated from this post.

All posts are selected by default. Click individual items to adjust which ones are included. Deselecting a post updates the total question count and set badge at the top accordingly.


State 4: Study Mode (Session in Progress)

Clicking “Start Review” switches the app into study mode, where questions are presented one at a time.

Top Progress Bar and Controls

PositionElementAction
LeftPrevious (chevron-left ‹)Go to the previous question. Disabled on the first question.
Center-leftEnd SessionShows a session-end confirmation modal.
CenterProgressDisplays current position as “{current}/{total}” with a progress bar.
Center-rightSkipSkip the current question and move to the next.
RightNext (chevron-right ›) or Finish (checkmark)The Next button is disabled until an answer is entered. On the last question, Next is replaced by Finish.

Question Card Layout

Each question card displays the following information.

  • Question type badge: Indicates the type of question (e.g., True/False, Multiple Choice).
  • Source post title: The title of the original post this question was generated from.
  • Difficulty stars: Difficulty is shown with 5 stars — more filled stars means a harder question.
  • Question and answer area: The answer interface varies by question type. See the Question Types article for details.

View Original Post (Mobile)

On mobile, a floating action button (FAB) with a book-open icon appears in the bottom-right corner. Tapping it opens the original post content in a modal. Tap the “Close” button inside the modal to dismiss it.

End Session Confirmation Modal

Pressing “End Session” during a session shows a confirmation modal.

  • “End this session?”
  • “Your results will be based on the questions you’ve answered so far.”
  • “Keep Going” button: Dismisses the modal and continues the session.
  • “End Session” button: Submits all answers entered so far and begins grading.

State 5: Grading

Pressing Finish on the last question, or selecting “End Session” in the confirmation modal, transitions the app to the grading screen.

  • A spinner animation appears alongside the text “Grading…”.
  • The message “Analyzing your answers. Please wait a moment.” is displayed.
  • A three-dot (•••) animation is also shown.

True/False, Multiple Choice, and Fill in the Blank questions are graded instantly. Short Answer and Essay questions are evaluated semantically by the AI, which may take a few to several seconds depending on the number of questions. Once grading is complete, the app navigates automatically to the results page.


Full Flow Summary

Open page

[Loading...] spinner

No questions? → "No questions to answer today." message

Questions available? → Cover page (select posts + Start Review)

[Start Review] clicked → Study mode (questions presented one by one)

[Finish] on last question or [End Session] → Grading...

Auto-navigate to results page