jolito

Jolito는 멕시코 스페인어 회화 학습자를 위한 오픈 소스 플래시카드 앱입니다. 간격 반복 복습 루프를 오디오 몰입 및 키보드 기반 연습 흐름과 결합했으며, 설치 가능한 오프라인 지원 웹 앱 또는 네이티브 iOS 패키지로 실행할 수 있습니다. README에 설명된 주요 특징은 다음과 같습니다: - 키보드 우선 복습: Enter로 정답 공개, 1-4번 키로 등급 매기기, Space로 오디오 재생이 가능하며, 입력창에 자동 포커스가 설정되어 손을 키보드에 유지할 수 있습니다. - 청각 우선 오디오: 프롬프트와 정답 모두에 멕시코 스페인어 음성이 첨부되어 있습니다. - 능동적 타이핑 회상: 학습자가 단순히 정답을 인식하는 것이 아니라 직접 타이핑합니다. 즉각적인 시각적 차이(diff) 표시를 통해 철자 오류를 강조하며, 등급 매기기는 학습자 스스로 평가합니다. - 듀얼 카드 워크벤치: 연결된 스페인어-영어 상호 카드를 나란히 미리 보며 일괄 작성하고 함께 생성할 수 있습니다. - 오프라인 어휘 도우미: 번역, 표제어 및 동사 활용 힌트를 제공하는 멕시코 스페인어 사전이 내장되어 있습니다. - 카드 생성, 덱 관리 및 편집 과정에서 중복 감지 기능을 제공합니다. - Anki 가져오기: .apkg 패키지나 텍스트 내보내기를 통해 기존 덱을 가져올 수 있으며, 학습 이력과 복습 일정은 그대로 유지됩니다. - Capacitor를 통한 네이티브 iOS 빌드 및 정답 공개와 등급 매기기 시 햅틱 피드백을 제공합니다. - 로컬 지속성과 서비스 워커 캐싱을 통한 오프라인 우선 저장소 및 PWA 설치 옵션을 제공합니다. - Supabase 기반의 비밀번호 없는 이메일 로그인 및 다중 기기 동기화가 가능한 개인 덱 기능을 제공합니다. 이 프로젝트는 수동으로 카드를 작성해야 하는(오디오 클리핑, 이미지, 템플릿 등) 범용 간격 반복 도구와 고정된 커리큘럼을 가진 게임화된 학습 앱 사이의 중간 지점에 위치합니다. Jolito의 목표는 학습자가 공부할 실제 문구를 직접 제어하면서 마찰 없는 카드 생성을 구현하는 것입니다. 로컬에서 실행하려면 Node.js >= 24와 npm이 필요합니다. 클론 후 `npm ci`로 의존성을 설치하고 `npm run dev`를 실행하면 http://localhost:5173에서 개발 서버가 시작됩니다. 설치 가능한 프로덕션 빌드를 확인하려면 `npm run build && npm run preview`를 통해 http://localhost:4173에서 실행할 수 있으며, 온라인 상태에서 한 번 로드하면 오프라인 재로드 동작을 테스트할 수 있습니다. Mosh 단독으로는 TCP 포트를 전달할 수 없으므로, 포트 포워딩이 설정된 SSH를 통한 원격 개발 방법이 문서화되어 있습니다. 저장소의 추가 문서에는 제품 비전, 디자인 원칙, 로드맵, 로컬 우선 저장소를 참조하는 육각형 도메인 구조의 아키텍처 설명, 테스트 피라미드를 설명하는 품질 가이드, 접근성 불변성 및 CI 계약, 그리고 Supabase 동기화 설정 및 Cloudflare Workers 배포를 위한 개발 가이드가 포함되어 있습니다. 이 프로젝트는 Apache License 2.0 하에 라이선스가 부여됩니다.