Об этом проекте

Jolito — это open-source приложение с карточками, предназначенное для изучающих разговорный мексиканский испанский язык. Оно сочетает в себе цикл повторений с интервальным воспроизведением, аудиопогружение и процесс практики, ориентированный на использование клавиатуры. Приложение может работать как устанавливаемое веб-приложение с поддержкой автономного режима (PWA) или как нативное приложение для iOS. Основные особенности, описанные в README: - Приоритет клавиатуры при повторении: Enter для раскрытия, клавиши 1-4 для оценки, Пробел для воспроизведения аудио; автоматический фокус ввода позволяет не убирать руки с клавиатуры. - Акцент на слух: аудиозаписи на мексиканском испанском прикреплены как к вопросам, так и к ответам. - Активное воспроизведение через ввод: учащиеся печатают ответы, а не просто узнают их; мгновенный визуальный diff подсвечивает орфографические различия, при этом оценка остается субъективной. - Двойной рабочий стол карточек: связанные взаимные карточки (испанский-английский) создаются вместе с предпросмотром side-by-side и возможностью пакетного авторства. - Автономный лексический помощник: встроенный словарь мексиканского испанского для переводов, лемм и подсказок по спряжению глаголов. - Обнаружение дубликатов при создании карточек, управлении колодами и редактировании. - Импорт из Anki: существующие колоды можно импортировать через пакеты .apkg или текстовый экспорт с сохранением истории обучения и графиков повторений. - Нативная сборка для iOS через Capacitor с тактильной отдачей при раскрытии и оценке. - Хранилище с приоритетом автономности (offline-first) с локальным сохранением и кэшированием через service-worker; возможность установки как PWA. - Персональные колоды с беспарольным входом по email и синхронизацией между устройствами на базе Supabase. Проект занимает нишу между двумя крайностями: универсальными инструментами интервальных повторений, требующими ручного создания карточек (нарезка аудио, изображения, шаблоны), и геймифицированными приложениями с фиксированной программой. Цель Jolito — создание карточек с нулевым трением и контроль учащегося над тем, какие реальные фразы изучаются. Для локального запуска требуются Node.js >= 24 и npm. После клонирования `npm ci` устанавливает зависимости, а `npm run dev` запускает сервер разработки по адресу http://localhost:5173. Для проверки устанавливаемой продакшн-сборки используйте `npm run build && npm run preview` (доступно по адресу http://localhost:4173); однократная загрузка при наличии сети позволяет протестировать поведение при автономной перезагрузке. Удаленная разработка задокументирована для SSH с пробросом порта, так как Mosh самостоятельно не может передавать TCP-порт. Дополнительная документация в репозитории охватывает видение продукта, принципы дизайна, дорожную карту, описание архитектуры с гексагональной структурой домена и локальным хранилищем, руководство по качеству с описанием пирамиды тестирования, инварианты доступности и контракты CI, а также руководство по разработке для конфигурации синхронизации Supabase и развертывания в Cloudflare Workers. Проект распространяется под лицензией Apache License 2.0.