Skip to main content

Overview

Uxie automatically generates flashcards from your PDF documents using AI, helping you study and retain information effectively. Each flashcard tracks your performance over time, making it easy to focus on areas that need more practice.

Key Features

AI Generation

Automatically create question-answer pairs from your document

Performance Tracking

Track correct and incorrect answers for each card

Instant Feedback

Get immediate feedback with detailed explanations

Progress Through Set

Navigate through cards with visual progress indicators

Getting Started

Generating Flashcards

1

Open Flashcards Tab

Click the Flashcards tab in the right sidebar
2

Generate

Click the “Generate Flashcards” button
3

Wait for AI

The AI analyzes your document and creates question-answer pairs (this may take 30-60 seconds)
4

Start Studying

Flashcards appear automatically - begin studying right away!
Flashcard generation uses Google’s Gemini 2.5 Flash model to create clear, focused questions with accurate answers.

How Flashcards Are Created

AI Generation Process

  • PDF is loaded and text extracted
  • Content is split into manageable chunks (1000 characters)
  • Chunks overlap by 200 characters to maintain context
  • Each chunk is analyzed by AI
  • Up to 2 questions created per chunk
  • Questions are designed to be self-contained
  • Focuses on key concepts and important information
  • Questions without clear answers are skipped
  • Duplicate or similar questions are filtered
  • Only high-quality Q&A pairs are kept
Implementation at /src/lib/flashcard.ts.

Page Limits

Maximum pages per document for flashcard generation:
  • Free plan: Limited pages
  • Paid plans: Higher limits
Check your plan details for specific limits.

Using Flashcards

Card Interface

Each flashcard shows:
  • Question side: The study question
  • Progress indicator: “Card X of Y” at top
  • Answer button: Reveals the answer
  • Navigation: Previous/Next buttons

Study Flow

1

Read Question

The question appears on the card
2

Think

Consider your answer before revealing
3

Show Answer

Click “Show Answer” to reveal the correct answer
4

Evaluate Yourself

Choose:
  • Correct - You got it right
  • Incorrect - You got it wrong
  • ℹ️ Show Explanation - Get more context
5

Continue

Move to the next card and repeat

Feedback Options

  • Marks this attempt as correct
  • Increments your correct answer count
  • Tracks performance for future review
  • Automatically advances to next card
  • Marks this attempt as incorrect
  • Helps identify areas needing more study
  • Tracks for spaced repetition
  • Moves to next card
  • Reveals additional context and details
  • Helps deepen understanding
  • Useful when answer is partially correct
  • Learn more about the concept

Performance Tracking

Attempt History

Each flashcard tracks all your attempts:
{
  id: string,
  flashcardId: string,
  isCorrect: boolean,
  createdAt: Date
}

Viewing Progress

Detailed analytics and progress visualization are planned for a future release. Currently, attempts are tracked in the background.

Best Practices for Studying

Space out sessions: Review flashcards over multiple days rather than cramming in one session.
Focus on incorrect cards: Pay extra attention to cards you marked wrong - these indicate knowledge gaps.
Use explanations: Don’t just memorize answers - understand the concepts behind them.
Combine with notes: After studying flashcards, review your notes to reinforce connections.

Moving Between Cards

Forward:
  • Click the Next button
  • Or complete the current card (mark correct/incorrect)
Backward:
  • Click the Previous button
  • Review previous cards anytime
Direct navigation:
  • Use the progress indicator to see position
  • Cards are numbered: “1 of 20”, “2 of 20”, etc.

Keyboard Shortcuts

Keyboard shortcuts for flashcards are planned for a future update to enable faster studying.

Technical Details

Component Structure

<Flashcards>
  {flashcards.length === 0 && <FeatureCard />}
  {flashcards.length > 0 && (
    <IndividualFlashcard
      question={...}
      answer={...}
      attempts={...}
      current={cur}
      total={length}
    />
  )}
</Flashcards>
Component at /src/components/flashcard/index.tsx.

Individual Card Component

Each card manages:
  • Question/answer visibility state
  • Attempt submission
  • Navigation between cards
  • Performance feedback display
Implemented at /src/components/flashcard/card.tsx.

Generation API

Endpoint: tRPC mutation flashcard.generateFlashcards Process:
  1. Validates page count against user plan
  2. Fetches PDF from URL
  3. Extracts and chunks text
  4. Generates Q&A pairs with AI
  5. Saves to database
  6. Returns flashcard set
Logic at /src/lib/flashcard.ts.

Customization

Flashcard customization features (editing questions, creating custom cards, filtering by topic) are planned for future releases.

Current Limitations

  • Cannot edit generated questions or answers
  • Cannot manually add custom flashcards
  • Cannot filter by topic or section
  • Cannot export flashcard sets
  • Cannot shuffle card order

AI Model Details

Model: Google Gemini 2.5 Flash Prompt:
You're using an advanced AI assistant capable of creating 
flashcards efficiently. Your task is to generate clear and 
concise question-answer pairs based on provided text. Each 
question should have a straightforward answer and be 
self-contained. Limit your questions to a maximum of two 
per text segment.
Output Schema:
[
  {
    question: string,
    answer: string
  },
  ...
]

Use Cases

Exam Preparation

Generate flashcards from textbooks and study guides

Research Papers

Create Q&A cards to remember key findings and methods

Technical Documentation

Study APIs, frameworks, and programming concepts

Meeting Notes

Turn meeting minutes into actionable memory aids

Troubleshooting

  • Larger documents take more time (30-90 seconds)
  • Each text chunk requires an AI API call
  • Check your internet connection
  • Refresh if stuck for more than 2 minutes
  • Document may be too short (needs substantial text)
  • PDF might be scanned images (use OCR first)
  • Document may exceed your plan’s page limit
  • Check for error messages
  • AI occasionally generates low-quality questions
  • Source text may be poorly formatted
  • Technical jargon can confuse the AI
  • Regenerate flashcards if quality is low
  • Ensure you’ve clicked “Show Answer” first
  • Check if you have edit permissions on the document
  • Try refreshing the page
  • Check browser console for errors

Note Taking

Create study notes alongside flashcards

AI Chat

Ask AI to explain flashcard concepts

Annotations

Highlight key passages for flashcard generation

Build docs developers (and LLMs) love