Koku

A spaced repetition flashcard app built for developers. Create decks, write cards with Markdown and syntax-highlighted code blocks, and study using the FSRS algorithm to optimize your learning schedule.

Try it at koku.cards

Features

• Spaced repetition powered by FSRS for intelligent review scheduling
• Markdown support with syntax-highlighted code blocks
• Deck organization for grouping related cards
• Image support including HEIC conversion
• Vacation mode to pause reviews when you're away
• Dark mode support
• Keyboard shortcuts for faster workflows

Tech Stack

• Next.js (App Router)
• Supabase (Auth + PostgreSQL database)
• Tailwind CSS
• ts-fsrs (spaced repetition algorithm)
• react-markdown + Shiki (syntax highlighting)

Getting Started - Running Locally

Prerequisites

• Node.js 18+
• A Supabase project

Setup

1. Clone the repository

2. Install dependencies:

   npm install

3. Copy .env.example to .env.local and fill in your Supabase credentials:

   NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
   NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
   

4. Run the development server:

   npm run dev

5. Open http://localhost:3000