+
Skip to content

sakan811/SakuMari

Repository files navigation

SakuMari - Japanese Kana Flashcard App

A web application for practicing Japanese Hiragana and Katakana characters with interactive flashcards and progress tracking.

Web-App Test

E2E Test

Features

  • Interactive Flashcards: Practice Hiragana and Katakana with randomized character selection
  • Progress Tracking: View accuracy statistics and practice history
  • Adaptive Learning: Characters with lower accuracy appear more frequently

Try It Live

🚀 https://saku-mari.vercel.app/ - No setup required!

Local Setup

Prerequisites

For local development, you'll need Google OAuth credentials:

  1. Go to Google Cloud Console
  2. Create/select a project
  3. Set up OAuth consent screen: "APIs & Services" → "OAuth consent screen"
  4. Fill required fields (App name, User support email, Developer contact information)
  5. Create credentials: "APIs & Services" → "Credentials" → "Create Credentials" → "OAuth client ID" → "Web application"
  6. Add redirect URI: http://localhost:3000/api/auth/callback/google
  7. Copy Client ID and Client Secret
  8. Generate AUTH_SECRET at https://auth-secret-gen.vercel.app/

For more details: Google OAuth 2.0 Documentation

Local Development

Prerequisites: Install PNPM

git clone https://github.com/sakan811/SakuMari.git
cd SakuMari
cp .env.example .env
# Edit .env with your Google OAuth credentials and AUTH_SECRET
docker compose up -d saku-mari-db
pnpm install
pnpm exec prisma generate
pnpm exec prisma migrate dev
pnpm exec prisma db seed
pnpm run dev

Open http://localhost:3000

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  
点击 这是indexloc提供的php浏览器服务,不要输入任何密码和下载