A beautifully crafted Fate RPG dice roller for Android — fully built with Jetpack Compose.
Originally developed with XML layouts, now modernized with a declarative UI architecture.
| 🎲 Main Screen | 📜 Roll History |
|---|---|
 |
 |
| Roll four Fate dice with a single tap | Full session history in a slide-up bottom sheet |
Fate Core is a narrative-driven tabletop RPG by Evil Hat Productions. Instead of d20s or percentile dice, Fate uses its own special Fate Dice (dF) — each face shows one of three symbols:
┌───────────┬───────────┬───────────┐
│ [ + ] │ [ ] │ [ - ] │
│ │ │ │
│ Plus │ Blank │ Minus │
│ +1 │ 0 │ -1 │
└───────────┴───────────┴───────────┘
You roll 4 dice simultaneously and sum the results. The total ranges from -4 to +4, compared against a skill level or opponent roll to determine the narrative outcome.
| Result | Ladder Rank | Narrative Meaning |
|---|---|---|
+4 |
🌟 Legendary | Beyond extraordinary — a moment for the ages |
+3 |
✨ Fantastic | Things go spectacularly well |
+2 |
👍 Great | Clear, clean success |
+1 |
🙂 Good | Success, but with a small twist |
0 |
😐 Fair | Neutral outcome — something happens |
-1 |
😬 Average | Minor setback, minor cost |
-2 |
😟 Mediocre | Failure with consequence |
-3 |
😨 Poor | Bad failure |
-4 |
💀 Terrible | Catastrophic — the story just got dramatic |
🧙 Learn more at faterpg.com
╔══════════════════════════════════════════════════════════════════╗
║ ║
║ 🎲 4-Dice Roll Roll all four Fate dice simultaneously ║
║ 🌀 Roll Animation Rapid dice shuffle before final reveal ║
║ 💥 Score Bounce Spring animation on result display ║
║ 📜 Roll History Slide-up bottom sheet with session log ║
║ 🎨 Custom Dice Art Hand-designed dice imagery via Figma ║
║ 🟢 Custom Button Distinctive branded "ROLL THE DICE" UI ║
║ 🌙 Indigo Theme Calming, immersive color palette ║
║ ♾️ Infinite Sessions No roll limit, persistent history ║
║ ║
╚══════════════════════════════════════════════════════════════════╝
The dice faces, roll button, and screen layouts were all designed from scratch in Figma before being implemented in Compose.
The Figma file contains:
- 🎲 All three Fate dice face variants (
[+],[ ],[-]) with 3D styling - 🟢 The custom "ROLL THE DICE" button graphic
- 📐 Full screen layout compositions and spacing guides
- 🎨 Color tokens: indigo/periwinkle palette (
#A5B4FC,#2D3748,#4A5568)
┌──────────────────────────────────────────────────────────────┐
│ UI LAYER │
│ DiceScreen.kt │
│ (Jetpack Compose) │
│ │
│ ┌─────────────┐ ┌──────────────┐ ┌────────────────────┐ │
│ │ DiceImage │ │ RollButton │ │ ModalBottomSheet │ │
│ │ @Composable │ │ @Composable │ │ (Roll History) │ │
│ └──────┬──────┘ └──────┬───────┘ └────────────────────┘ │
└─────────┼────────────────┼──────────────────────────────────┘
│ collectAsState()
┌─────────▼────────────────▼──────────────────────────────────┐
│ VIEWMODEL LAYER │
│ DiceViewModel.kt │
│ │
│ diceFaces: StateFlow<List<Int>> │
│ isRolling: StateFlow<Boolean> │
│ rollHistory: StateFlow<List<RollRecord>> │
│ │
│ startRolling() → stopRolling() → updateDice() │
└─────────────────────────┬───────────────────────────────────┘
│ Kotlin Coroutines
┌─────────────────────────▼───────────────────────────────────┐
│ LOGIC LAYER │
│ generateRandomDice() → random pick from [-1, 0, 1] │
│ RollRecord(id, total) → prepended to history list │
└─────────────────────────────────────────────────────────────┘
| Layer | Technology |
|---|---|
| Language | Kotlin |
| UI Toolkit | Jetpack Compose |
| State Management | ViewModel + StateFlow |
| Async / Animation | Kotlin Coroutines |
| UI Components | Material 3 (ModalBottomSheet, Surface) |
| Animation | animateFloatAsState + Spring spec |
| Build System | Gradle KTS |
| CI/CD | GitHub Actions |
| Design | Figma |
This project was originally built using classic Android XML layouts and has since been fully refactored to Jetpack Compose.
BEFORE (XML Views) AFTER (Jetpack Compose)
────────────────────────────── ───────────────────────────────────
activity_main.xml DiceScreen.kt @Composable
res/layout/*.xml files Composable function hierarchy
View Binding / findViewById State-driven recomposition
AnimatorSet / ObjectAnimator animateFloatAsState + spring()
LiveData + Observer pattern StateFlow + collectAsState()
RecyclerView + Adapter LazyColumn + items { }
Fragment transactions Direct composable calls
Manual lifecycle management LaunchedEffect + ViewModel scope
Result: ~60% less boilerplate, dramatically smoother animations, and a far more maintainable codebase.
User taps [ROLL THE DICE]
│
▼
┌──────────────────────┐
│ startRolling() │──► isRolling = true
│ ViewModel call │──► UI shows "Rolling..." text
└──────────┬───────────┘
│
▼
┌──────────────────────────────────────┐
│ LaunchedEffect(isRolling) │
│ Coroutine launches on main thread │
│ │
│ repeat(10): │
│ updateDice(generateRandom()) ◄──┼── visual shuffle
│ delay(50ms) │ every 50ms
└──────────────────────┬───────────────┘
│
▼
┌──────────────────────────────────────┐
│ stopRolling(finalFaces) │
│ diceFaces updated │
│ isRolling = false │
│ rollCounter++ │
│ RollRecord prepended to list │
└──────────────────────┬───────────────┘
│
▼
┌──────────────────────────────────────┐
│ UI recomposes automatically │
│ Score shown with sign (+/-) │
│ Spring bounce animation fires │──► scale 1.0 → 1.2 → 1.0
│ History list instantly updated │
└──────────────────────────────────────┘
Fate-Dice-Roll/
├── .github/
│ └── workflows/
│ └── android.yml # CI/CD pipeline definition
├── app/
│ └── src/main/
│ ├── java/com/stargazer/fatediceroll/
│ │ ├── MainActivity.kt # App entry point
│ │ ├── ui/
│ │ │ └── DiceScreen.kt # All UI composables
│ │ └── viewmodel/
│ │ └── DiceViewModel.kt # State + business logic
│ └── res/
│ └── drawable/ # Dice images & button graphics
├── build.gradle.kts # Module build config
└── settings.gradle.kts
Every push to master triggers the Android CI workflow via GitHub Actions:
Push to master / Pull Request
│
▼
┌─────────────────────────────────┐
│ GitHub Actions Runner │
│ │
│ 1. ✅ Checkout repository │
│ 2. ✅ Set up JDK 17 │
│ 3. ✅ Cache Gradle packages │
│ 4. ✅ ./gradlew build │
│ 5. ✅ Run unit tests │
└─────────────────────────────────┘
│
▼
Build artifact + status badge updated
Latest run: Android CI #1 — ✅ passed in 3m 54s
| Requirement | Minimum Version |
|---|---|
| Android Studio | Hedgehog (2023.1+) |
| JDK | 17 |
| Android minSdk | 24 (Android 7.0) |
| Android targetSdk | 35 |
| Gradle | 8.x |
# Clone the repository
git clone https://github.com/berat-karabuga/Fate-Dice-Roll.git
cd Fate-Dice-Roll
# Build debug APK
./gradlew assembleDebug
# Run unit tests
./gradlew testOr open in Android Studio and press
Contributions, bug reports, and feature ideas are all welcome!
# 1. Fork the repository
# 2. Create your feature branch
git checkout -b feature/your-feature-name
# 3. Commit with a clear message
git commit -m "feat: describe your change"
# 4. Push and open a Pull Request
git push origin feature/your-feature-nameThis project is open source and available under the MIT License.
Made with ❤️ for the Fate RPG community
"In Fate, you are the author of your own story — the dice just add the drama."
⭐ Star this repo if you find it useful! | 🎨 View Figma Design