🎴 Creating Your First Deck

This guide walks you through creating your first flashcard deck in FlashGenie, from scratch or by importing existing content.

🎯 Methods for Creating Decks

FlashGenie offers multiple ways to create and populate decks:

1. Create from scratch - Build a deck card by card
2. Import from files - CSV, TXT, JSON, and more
3. Use AI suggestions - Let FlashGenie suggest content

📝 Method 1: Create a Deck from Scratch

Step 1: Create an Empty Deck

# Create a new deck with name and description
python -m flashgenie create "Spanish Vocabulary" "Essential Spanish words and phrases"

Step 2: Add Cards Interactively

# Start interactive card creation
python -m flashgenie add "Spanish Vocabulary"

Follow the prompts to add cards:

Question: ¿Cómo estás?
Answer: How are you?
Tags (comma-separated): greetings,basic,question
Add another card? (y/n): y

Step 3: Add Tags and Metadata

# Add tags to your deck
python -m flashgenie tags add "Spanish Vocabulary" --tags "language,beginner"

# Set deck properties
python -m flashgenie set "Spanish Vocabulary" --property difficulty --value beginner

📥 Method 2: Import from Files

Supported File Formats

FlashGenie supports multiple formats with intelligent auto-detection:

=== "CSV Format"

Create a file called `my_flashcards.csv`:

```csv
question,answer,tags
What is the capital of France?,Paris,"geography,europe"
What does CPU stand for?,Central Processing Unit,"technology,computers"
What is photosynthesis?,Process plants use to convert light to energy,"biology,science"
```

=== "TXT Format"

Create a file called `my_flashcards.txt`:

```
Q: What is the capital of Spain?
A: Madrid

Q: What does API stand for?
A: Application Programming Interface

Q: What is machine learning?
A: A subset of AI that learns from data
```

=== "JSON Format"

Create a file called `my_flashcards.json`:

```json
{
  "deck": "Science Facts",
  "cards": [
    {
      "question": "What is the speed of light?",
      "answer": "299,792,458 meters per second",
      "tags": ["physics", "science"]
    },
    {
      "question": "What is the chemical symbol for gold?",
      "answer": "Au",
      "tags": ["chemistry", "elements"]
    }
  ]
}
```

Import Your File

# Import from CSV
python -m flashgenie import my_flashcards.csv --name "My Study Deck"

# Import from TXT
python -m flashgenie import my_flashcards.txt --name "My Study Deck"

# Import from JSON
python -m flashgenie import my_flashcards.json

Auto-Tag Your Content

# Auto-tag your cards based on content
python -m flashgenie autotag "My Study Deck"

🧠 Method 3: Use AI Suggestions

Let FlashGenie suggest content based on your learning goals:

# Get content suggestions for a new deck
python -m flashgenie suggest --topic "Basic Spanish" --cards 10

# Create deck from suggestions
python -m flashgenie create-from-suggestions "Spanish Basics"

🔍 Reviewing Your Deck

After creating your deck, review it:

# List all cards in your deck
python -m flashgenie list-cards "My Study Deck"

# Preview your deck
python -m flashgenie preview "My Study Deck"

# View deck statistics
python -m flashgenie stats "My Study Deck"

🎯 Best Practices for Effective Decks

1. Keep questions clear and concise
2. Use specific, actionable answers
3. Add relevant tags for better organization
4. Include images where helpful
5. Create hierarchical relationships between cards
6. Balance difficulty levels
7. Group related concepts

🎮 Start Learning!

Now that you've created your first deck, start learning:

# Start a basic quiz
python -m flashgenie quiz "My Study Deck"

# Get an adaptive study plan
python -m flashgenie plan "My Study Deck" --time 20 --energy 3

# View your smart collections
python -m flashgenie collections

🚀 Next Steps

Congratulations on creating your first deck! Here's what to explore next:

• Basic Commands - Master essential FlashGenie commands
• Smart Features - Discover AI-powered learning tools
• Advanced Usage - Learn power-user techniques

---

FlashGenie v1.5.0 | Last updated: June 2025