📝 How to Create a Card Decks for LearnLock

📌 Step 1: Understand the JSONL Format

A custom Card Deck in LearnLock is a JSONL file where each flashcard follows a specific structure. Here’s the required format:

{
  "title": "Newton’s Laws",
  "category": "Physics",
  "content": "Newton's first law states that an object in motion stays in motion unless acted upon by an external force.",
  "extra": "F = ma"
}

💡 Explanation of Each Field

Field	Description	Example
`title`	The main topic or term of the flashcard	`"Newton’s Laws"`
`category`	The general topic area (Optional)	`"Physics"`, `"History"`, `"Vocabulary"`
`content`	The main learning material (definition, explanation, or key information)	`"An object in motion stays in motion unless acted upon."`
`extra`	Additional optional information like formulas, dates, pronunciations	`"F = ma"`

📌 Note: Each card must follow this structure to be recognized by LearnLock.

📌 Step 2: Create Your JSONL File

You can use any text editor to create your custom card deck.

💡 Example for Vocabulary Learning

[
  {
    "title": "Swop",
    "category": "Dance",
    "content": "A fusion of swing and hip-hop dance styles.",
    "extra": "/swɑp/"
  },
  {
    "title": "Abacist",
    "category": "Mathematics",
    "content": "One who uses an abacus in casting accounts; a calculator.",
    "extra": "/ˈæb.ə.sɪst/"
  }
]

💡 Example for Science Concepts

[
  {
    "title": "Newton’s Laws",
    "category": "Physics",
    "content": "Newton's first law states that an object in motion stays in motion unless acted upon by an external force.",
    "extra": "F = ma"
  },
  {
    "title": "DNA Replication",
    "category": "Biology",
    "content": "The process of producing two identical replicas from one original DNA molecule.",
    "extra": "Occurs in the S-phase of the cell cycle."
  }
]

📌 Step 3: Save and Import Your Custom Card Deck

Save the file as .jsonl
- Example: my_deck.jsonl
Transfer the file to your phone
- You can use Google Drive, Dropbox, or a direct USB connection.
Open LearnLock and Import the Card Deck
- Navigate to Manage Sources → Add Source
- Select your JSONL file
Start Learning!
- Your new flashcards will now appear every time you unlock your phone. 🚀

📌 Troubleshooting & Common Issues

🟢 LearnLock isn’t detecting my file
✅ Ensure your file uses valid JSON syntax and follows the correct structure.
✅ Check that the file ends in .jsonl.

⚠️ Limitations & Best Practices

Keep the content concise to ensure readability on the lock screen.
Be careful with your math: no MathJax or LaTeX support is available for formulas in the current version (coming soon).
Avoid special characters that may cause formatting issues as they are not supporting the in the current version (coming soon).
Test your deck by importing it and checking the flashcards on your lock screen.

📝 Get Started with Your Custom Card Deck Today!

🚀 Try creating your own Card Deck now and personalize your learning experience with LearnLock!

📩 Need help? Contact us at: mug.n.ai.dev@gmail.com