ulangi/ulangi

Ulangi is a language flashcards app with spaced repetition system and more.

Ulangi

Open-source language learning tools

---

Introduction

Ulangi makes it easy for you to manage and create flash cards to learn languages. It comes with built-in dictionaries, translators, built-in TTS, image search engine and more. You can use different learning methods to memorize them, such as spaced repetition, writing, quiz... Everything about Ulangi (mobile, server, add-on, etc) is hosted in this repository.

Ulangi is completely free thanks to Midterm App. We are going to use some technology from it to make the desktop version.

---

Main apps

Ulangi (Full version)

Platform	Store
iOS	Download on App Store
Android	Download on Play Store
Mac	Not yet available
Windows	Not yet available
Linux	Not yet available

---

Development principles

• Write type-safe code
• Use design patterns
• Make it easy to build/customize tools

---

Documentation

All docs are hosted here: https://ulangi.github.io/ulangi

We're adding more docs. Stay tuned!

---

Change log

Please view CHANGELOG.md file.

---

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. See full detail here.

---

Credits

• social-icons by Just UI
• lesson-icons from Material Design Icons by community (SIL Open Font License 1.1)
• mobile-icons from Material Design Icons by Google (Apache License 2.0)
• flag-icons are not included in this project due to license incompatibility but you can download and add them manually here.

ulangi's Issues

Show more data from dictionary

• IPA for most languages (except Vietnamese)
• Pinyin for Chinese
• Romaji for Japanese
• Romanization for Korean (re-parse required)
• Japanese form (hiragana, romaji,...)
• Chinese form (traditional, simplied)
• Add missing IPA for most languages

Remove manual linking for react-native-navigation

Check for duplicates before adding cards

Assets from main Ulangi apps cannot be used in this open-source project.

Unfortunately, many graphics and icons which are used in the main apps have restrictive licenses.

Solutions:

• We keep icons and graphics for the main apps.
• For open-source apps, we will use Material icons.

Add an option to autoplay audio

Allow to skip in Writing lesson

Avoid using null for env variables

Refactor RandomVocabularyIterator

Sometimes viewing quick tutorial on iOS crashes

Move adapters in saga to its own package (ulangi-adapter)

Allow to archive cards during review

Use custom view TopBar instead of native TopBar

Problems:

• Native TopBar put constraints on design. For example, contentInsetStarts of TopBar on Android is set to 16dp by default.
• It's not possible to add styles for text buttons (e.g. Save, Done buttons)
• Future OS updates may affect the design.

By using custom views,

• we can easily migrate to React-Navigation if required.
• it's easier to update TopBar title and buttons through observables.

Use better voice quality

Add different review strategies in Spaced repetition

Currently, cards are reviewed in forward direction; that is, given a term answer what it means

Add 2 more strategies:

• reversed => given definitions, answer what the term is.
• alternating => change review direction every 3 levels
• 50/50 => from level 1 to 5, cards are reviewed in forward direction; from level 5 to 10, cards are reviewed in reversed direction

opening the project with expo cli

please can you help me open the project with expo cli?
i tried download the files >extract> npm install > expo start
but i am getting error that react native not installed in this project.
actully i want test the app on my phone and try edit the code.
for learning purposes.

(Android) Root saga terminated without any reasons

This bug is hard to reproduce.

Hypothesis:

• jsc bug?
• infinite loop?
• redux-saga bug?
• Android lib error?
• Adblocker?
• Autorun?

Observations:

• root saga was terminated
• can happen after navigating to tab based screen
• only happen on Android

Some users experience constant loading on Android

Make writing better

• Allow users to choose what to write (hanzi/kanji/hiragana)
• Allow to skip
• Add play audio

Display better error message when playing audio without internet

Let users know in the apps that Ulangi is open-source

Solutions:

• Put a notice at the top of MoreScreen
• Create an Open-source screen for full details.

Incorrect level breakdown for Writing

Add IPA, pinyin, romaji

Add category bulk action

Update typescript, eslint, move common deps to root

"@typescript-eslint/eslint-plugin": "^2.24.0",
"@typescript-eslint/parser": "^2.24.0",
"eslint": "^6.8.0",
"eslint-plugin-import": "^2.20.1",
"eslint-plugin-jest": "^23.8.2",
"eslint-plugin-simple-import-sort": "^5.0.2",
"prettier": "^1.19.1",
"typescript": "^3.7.5"

Light box overflow on Android

Move UI related interfaces/enums from ulangi-common to ulangi-observable

Interfaces/enums are used only by views (by ulangi-mobile/ulangi-desktop), can be moved to ulangi-observable.

• DefaultButtonProps
• ButtonStyles
• SetSelectionMenuOptions
• all light box interfaces: ActionItem, ActionMenu

[Google sheets add-on] Sidebar "Set API Key" and other things are NOT doing anything on click

Hey there,

I installed the google sheets add-on and gave all the permissions requested. Still the Set API Key button does absolutely nothing when clicked. Also, the other buttons/links (except Push and Pull) are not clickable.

I'm using Chrome on MacOS.

Fix Wiktionary attribution

Currently, we haven't put the license (CC-BY-SA 4.0) and link to the license along with the source in dictionary picker and in library.

Upgrade to react-native 0.61.5

Remove navigationButtonPressed and trunk files

• navigationButtonPressed in most Containers is no longer needed
• some trunk files: .swp, text files

[Google Sheets add-on] ServiceError occurs when syncing too many new terms

Insightful statistics features

It would be better if ulangi have insightful statistics features like ankidroid.
https://play.google.com/store/apps/details?id=com.ichi2.anki
Your app are awesome and I appreciate your efforts on this project.

A list of features that are guaranteed to be rolled out soon

The order is not guaranteed (usually small features will be rolled out first)

• redesign review action bar
• autoplay audio during review
• allow to skip in Writing lesson
• adjust number of feedback buttons (3, 4, or 5 buttons)
• improve writing (ability to perform more actions during review)
• allow to archive cards during review
• duplicate prevention
• add category bulk action
• built-in IPA (pinyin, romaji,..)
• remove stop words when searching dictionary
• add suggestions picker
• add web view screen (avoid redirecting outside the app)
• add statistics screen (heat map)
• randomize review
• support iPad, tablets (with multi-tasking)
• add more sorting options
• make it compatible with FireOS (for Amazon store)
• show all definitions in writing lesson
• show due and new counts
• randomize review on database level.
• desktop version
• use deep-linking to add terms from outside the app
• add example
• remember sort options
• make font larger for Korean, Chinese, Japanese
• add custom formatting (customize cards)
• allow to hide extra fields during review

Setting TextInput selection on Android may crash the app.

This issue is related to react-native TextInput.
facebook/react-native#25265

Make proprietary libs optional (reduce license incompatibility)

• Make Firebase optional
• Make Appsflyer optional (AppFlyers was removed)
• Make FBSDK optional

App crashes when editing terms while reviewing

Add an option to disable auto focus in Writing

Sometimes audio does not play on Android

Allow to opt-in/opt-out analytical data (improve GPDR compliance)

Add heat map

• Add heat map to track user progress for spaced repetition and writing

Rename uls to ulangi

Refactor Logging

• wrap Logger around Crashlytics.
• make Logger methods static.

Add an option to adjust number of feedback buttons

[Google Sheets add-on] Pushing too many definitions

For each push, the add-on deletes all definitions then recreate them instead of editing them. This causes the app to hang when syncing.

Add an Edit button to edit reviewing cards in Spaced repetition

Change ObservableDarkModeStore to ObservableThemeStore, DarkModeSaga to ThemeSaga

Refactor store

• Move makeInitialState to ulangi-mobile
• Remove StoreEnv, StoreConfig as they no longer needed

Avoid using horizontal scroll view for images

Avoid using horizontal scroll view for images as this makes it harder to tap the vocabulary item and to scroll the list.

Redesign review action bar

Crash when navigate to search screen back and forth too quickly on Android