A colorful Android app for learning the Bristol Tang Soo Do Academy (BTSDA) one-step syllabus. It comes pre-loaded with short notes for every technique across Hands, Feet, Self Defense and Bo Staff, from White belt up to Blue belt, and links straight through to the matching BTSDA demonstration video on YouTube.
- Three views via the bottom navigation bar, over the same data:
- Syllabus — browse by category (below).
- By Belt — pick a belt and see everything for it across all categories.
- Quiz — revision mode: pick a belt and scope (that belt, or that belt & below) and get flashcard questions ("Hands #5 — what is it?") with reveal and a running score.
- 4 categories — Hands, Feet, Self Defense, Bo Staff — as swipeable tabs.
- Belt sections with rank colours (White → Orange → Green → Brown → Red → Blue for the empty-hand syllabus; the Bo Staff syllabus also uses Brown Tag and Red Tag) and the syllabus sub-notes (e.g. "Opposite stance – front kick attack").
- Forms (Hyung) listed per belt in the By Belt view, each linking to its video; the quiz also asks you to name a belt's forms.
- Pre-populated notes for all 120 techniques — the author's own short-hand.
- Fully editable — tap Edit note on any technique to overwrite the note. Your version is saved on-device and marked your note; Reset restores the original.
- Watch video — jumps to the correct BTSDA video for that block of five (see below).
- Search across notes, belt and technique number.
- Dynamic Material 3 theming (uses your device's wallpaper colours on Android 12+), gradient headers and animated cards. Light & dark mode.
BTSDA publishes its one-steps in blocks of five (1‑5, 6‑10, 11‑15, …):
- Hands, Feet and Self Defense share the "Il Soo Sik Dae Ryun (1 Step Sparring) X‑Y" series.
- Bo Staff has its own "Bo Staff 1 Steps X‑Y" series.
Each Watch video button links straight to the exact BTSDA demonstration
video for that block (see VideoLinks in data/Models.kt). If a block's video
id is ever missing, it falls back to a YouTube search for the block title on
@bristoltangsoodoacademy.
The CI workflow builds the APK on every push and attaches it to the
app-latest GitHub Release. Grab TSD-Syllabus.apk from the
Releases page, copy it to your Android phone and open it
(you may need to allow install from unknown sources).
./gradlew :app:assembleDebug # -> app/build/outputs/apk/debug/app-debug.apk
./gradlew :app:testDebugUnitTest # unit testsRequires JDK 17 and the Android SDK (compileSdk 35).
app/src/main/java/uk/co/btsda/syllabus/
data/ Models, the full syllabus dataset, and the notes repository
ui/ Compose screens, the view-model and the theme
MainActivity.kt
app/src/test/ JVM unit tests for the syllabus data
app/src/androidTest/ Compose UI tests
.github/workflows/ CI: build, test, publish APK
Notes are the author's personal short-hand and are intended as memory aids alongside proper instruction at the dojang.