Clunii — How it Works

Getting Started

Clunii is an AI-powered flashcard platform built around spaced repetition. You create sets of term/definition cards, study them across four different modes, and the app automatically schedules your reviews so you spend more time on cards you keep forgetting — and less time on ones you already know.

Creating an account

Sign up with an email address and a username. After registration you'll receive a 6-digit verification code by email — enter it to verify your account. Once verified you get immediate access to all free features.

The app tour

On your first login an interactive tour walks you through every major feature — it highlights real UI elements and waits for your clicks before advancing. You can skip it at any time and replay it later from Settings → Replay app tour.

Dashboard

The dashboard is your home screen. It shows your daily greeting, XP / streak / stars at a glance, quick links to Study, Explore, Forge, and New Set, and a list of all your sets.

Flashcard Sets

A set is a named collection of flashcards. Everything in Clunii — study modes, notes, progress tracking — is scoped to a set.

Creating a set

• Title — the name of your set. Keep it short and descriptive.
• Description — a brief summary of what the set covers. Shown in the Explore feed when your set is public.
• Visibility — Private (only you can see it) or Public (visible in the Explore feed for anyone to browse and clone).
• Categories — tag your set with subject areas (medicine, history, etc.) to make it easier to find in Explore.

Cards

Each card has a term (the question/prompt) and a definition (the answer). Optionally you can attach an image URL to any card — the image appears on the card during study sessions.

• Cards within a set are ordered by position. You can drag and drop them on the edit page to reorder.
• To delete a card, hover over it on the edit page and click the trash icon.
• The full card list is saved as one atomic operation — clicking Save on the edit page replaces all cards at once.

Editing a set

From the set detail page, click the pencil icon to open the editor. You can change the title, description, visibility, and categories, and add, edit, reorder, or delete individual cards. Changes only take effect when you click Save cards.

Cloning a public set

On any public set you find in Explore, click Clone to copy the entire set (title, description, and all cards) into your own account. The clone is private by default and completely independent from the original — editing your copy doesn't affect the source.

Deleting a set

Sets can be deleted from the set detail page. Deletion is permanent — it removes the set, all its cards, all study progress, and any notes you wrote for it. There is no undo.

Study Modes

Every set offers four study modes. Each mode lets you choose which cards to study via a filter toggle: All cards, Left today (cards not yet reviewed today and not in your review queue), or Review only (cards you got wrong or skipped).

Flashcards

The classic flip-card experience. The term is shown face-up; tap/click the card to reveal the definition.

• Know — marks the card correct (+20 mastery, doubles the review interval).
• Don't Know — marks it wrong (−10 mastery, resets interval to 1 day, adds to your review queue).
• Skip — leaves the card for the review queue without affecting mastery.
• ← Back — goes to the previous card in the session.
• Progress bar at the top shows how far through the current session you are.

Test

Tests your recall by asking you to type the definition. Three sub-modes are available:

• Written — you type a free-text answer. The AI grades it for meaning, not exact wording — so paraphrases and synonyms count. Each answer gets immediate written feedback explaining why it was marked correct or incorrect.
• Multiple choice — four options are shown; one is correct. Correct answers turn green, wrong ones turn red and reveal the right answer.
• Blitz — a timed version of multiple choice where you race through all the cards as fast as possible.

Flash Quiz

Delivers your cards in batches of 5 multiple-choice questions per round. After each round you see a score summary before moving to the next batch. Great for a quick warm-up or when you only have a few minutes.

Interactive Test

An AI-powered conversational test. The AI acts as a tutor — it asks you questions about each card in a natural, back-and-forth chat. You type free-text replies. The AI probes deeper if your answer is vague, gives hints if you're stuck, and wraps up each card with a short explanation.

• Works through every card in the set sequentially.
• At the end of the session you receive an overall score and per-card feedback.
• Great for subjects where you need to understand relationships, not just recall definitions.

Spaced Repetition

Clunii uses a spaced repetition system (SRS) to schedule your reviews. The core idea: you review a card, and if you get it right, you won't see it again for a progressively longer interval. If you get it wrong, the interval resets and you see it again soon.

Mastery score

Every card has a mastery score from 0 to 100. It starts at 0 for new cards.

• Correct answer → +20 mastery
• Wrong answer → −10 mastery (floored at 0)
• Mastery ≥ 80 → card is considered Mastered

Review intervals

Each correct answer also doubles the interval before you see the card again:

A wrong answer resets the interval back to 1 day, regardless of how far along the card was.

Review queue

When you answer a card incorrectly or skip it, it's added to your Review queue (flagged needsReview). Use the Review only filter on any study mode to work through just these cards. The flag is cleared the next time you answer the card correctly.

Left today

The Left today filter shows cards that haven't been reviewed at all today and are not already in your review queue. Use this for a daily study pass through fresh material.

Active sets (SRS schedule)

From any set detail page you can Activate the set to add it to your SRS schedule. Activated sets appear in the Study section of the dashboard with a "due" badge when it's time to review them. The SRS schedule for whole sets follows a longer cadence:

Notes Panel

Every set has a personal notes panel — a rich block editor that lives right next to your cards. Notes are per-user and per-set, so two people studying the same public set each have their own private notes.

Opening the panel

From any set detail page, click the Notes button in the top-right corner. The panel slides in over the right side of the screen. You can resize it by dragging the left edge.

Block types

The editor is block-based. Each line is a block with its own type. Use slash commands (type / at the start of a line) to change the block type:

Keyboard shortcuts

• Enter — insert a new block below the current one
• Backspace on empty block — delete the block and move up
• Tab — indent a bullet or numbered list item (nesting)
• ↑ / ↓ — move the cursor between blocks (caret-aware navigation)
• ⌘B / Ctrl+B — bold selected text
• ⌘I / Ctrl+I — italic selected text
• ⇧⌘C — open inline colour picker for selected text

AI actions in Notes

Three AI buttons appear in the notes panel header:

• AI Notes — generates a full set of study notes from your cards. Produces headings, paragraphs, bullet summaries, code blocks, and quotes that cover every card. Overwrites the current note content.
• To Cards — scans your existing note text and extracts new flashcards from it. The extracted cards appear in a side drawer where you can review and select which ones to add to your set.
• Merge — a bidirectional operation. It identifies gaps in both directions — cards that are not covered in your notes, and note topics that don't have a corresponding card — and fills both at once. This is the most powerful action: one click keeps your notes and cards in perfect sync.

Additional AI actions are available from the ⋯ menu in the toolbar:

• Summarize — condenses your existing notes into a shorter version.
• Explain — select any text, then click Explain to get a plain-English breakdown of the concept.
• Tag — generates a set of topic tags from your notes. Tags are saved and displayed at the top of the panel.
• Quiz — generates multiple-choice quiz questions directly from your notes text.

AI Forge

Forge is Clunii's AI card generator. Instead of typing cards by hand, you give Forge some raw content and it extracts term/definition pairs automatically. Navigate to Forge in the sidebar to open it.

Text

Paste any block of text — lecture notes, a Wikipedia article, a book excerpt, a study guide — and Forge identifies the key concepts and writes flashcards for each one. The more structured your source text, the more precise the output.

File / Image upload

Upload an image (JPEG, PNG, WebP) or a text-based file (PDF, TXT, DOCX, MD). Forge reads the content and generates cards from it. For images it uses visual understanding — diagrams, charts, annotated photos, and screenshots of text all work.

Audio recording

Record your voice directly in the browser — summarise a topic, read out your notes, or narrate a lecture. Forge transcribes the audio and extracts cards from the transcript. Useful for auditory learners or for converting spoken revision notes.

Notion import

Connect your Notion workspace in Settings, then paste any Notion page URL into Forge. Clunii fetches the page content via the Notion API and generates cards from it. Headers, bullet lists, tables, and callouts are all understood.

Compress

After generating or importing cards, use the Compress button to deduplicate and trim redundant cards. Forge merges near-duplicate definitions, rewrites overly verbose cards, and removes ones that repeat information already covered by another card.

Saving generated cards

Generated cards appear in a preview panel on the right. Review them, delete any you don't want, then either Save to existing set (adds cards to a set you already have) or Create new set (creates a fresh set with these cards). You can also edit card text before saving.

Explore

The Explore page shows all sets that other users have made public. It's a community library — browse it to find ready-made sets you can study or build on.

• Use the search bar to filter by title or keyword.
• Each set card shows the title, description, owner, card count, and categories.
• Click Clone on any set to copy it into your own account. The clone is fully independent — you can edit it freely without affecting the original.
• Sets you clone land in your dashboard under 'My Sets' and are private by default.
• You can make any of your own sets public from the set detail page → Edit → Visibility: Public. Once public it appears in Explore for everyone.

Study Groups

Study Groups (called Classrooms internally) are shared spaces where a group of users can access the same collection of sets. Teachers can use them for a class; friends can use them as a shared study hub.

Creating a group

Go to Study Groups in the sidebar and click Create group. Give it a name and an optional description. As the creator you are automatically the owner.

Joining a group

Every group has an 8-character join code. Share it with anyone you want to invite — they enter it on the Study Groups page to join instantly. Public groups can also be joined from the public groups listing without a code.

Adding sets to a group

As the owner, you can add any of your public sets to the group. Members can then browse those sets and study them directly. Adding a set to a group doesn't affect its visibility — it stays public.

Managing members

The owner can remove any member from the group. Members can leave voluntarily at any time. Removing a member or leaving a group doesn't delete their personal study progress for the group's sets.

Multiplayer Games

Clunii has two real-time multiplayer game modes — both run over a live WebSocket connection so scoring updates instantly for every player.

Live Quiz

A host creates a game room tied to a set and shares the room code. Up to 20 players join and wait in the lobby. When the host starts the game, everyone sees the same question at the same time. The faster you answer correctly, the more points you earn. Up to 20 questions per game, drawn from the set's cards.

• Create a game: Games → New Game → choose a set → share the room code.
• Join a game: Games → Join with code.
• The leaderboard updates live after every question.
• Final scores are saved to the game history.

Race game

A racing-style variant where correct answers move your character forward on a track. First player to reach the finish line wins. The race game uses the same room-code system — create a room, share the code, start when everyone is ready.

XP & Streaks

Clunii rewards consistent study with a lightweight progression system visible on your profile and in the dashboard.

XP (Experience Points)

XP is earned every time you answer a card correctly in any study mode. It accumulates indefinitely and is shown on your profile. There is no XP cap, no levels, and no XP decay — it's a pure record of how much you've studied.

Streaks

Your streak counter increments by 1 each day you complete at least one study session. Miss a day and the streak resets to zero. The dashboard shows your current streak alongside a motivational message, and the sidebar shows a 🔥 icon with your current count. Building a long streak is one of the most effective ways to ensure daily review.

Stars

Stars are awarded for specific achievements — reaching mastery on a full set, completing a certain number of study sessions, winning a multiplayer game, etc. They appear on your public profile.

Mastery progress

On the set detail page, a progress bar shows what percentage of cards you've mastered (mastery score ≥ 80). Below it, individual card-level mastery bars let you see exactly which cards you know well and which still need work.

Settings

Open Settings from the sidebar (bottom-left). Everything account- and preference-related lives here.

Profile

• Username — your public display name. Must be unique across all accounts.
• Email — used for login and notifications. Changing your email requires re-verification.
• Avatar — click your avatar thumbnail to pick from the built-in avatar library.

Appearance

Choose between Dark, Light, or System theme. System automatically follows your operating system's dark/light preference.

Subscription

Clunii has a Free plan and a Premium plan. Click Upgrade to start a Stripe checkout. Premium is billed monthly and can be cancelled at any time — you keep Premium access until the end of the current billing period.

Notion integration

Connect your Notion workspace to enable the Forge Notion import feature. Click Connect under Integrations and complete the Notion OAuth flow. Once connected, your workspace name is shown and you can disconnect at any time. Notion tokens are stored encrypted (AES-256-GCM).

Data & Privacy

• Download my data — exports all your sets, cards, notes, progress, and profile data as a JSON file.
• Privacy Policy — full policy at /privacy.

Danger zone

• Log out — signs you out and clears your session cookie.
• Delete account — permanently deletes your account, all sets, cards, notes, and progress. This cannot be undone.

Replay app tour

Under Account, click Replay app tour to restart the onboarding tour from step 1. Useful if you skipped it initially and want to revisit specific features.