Brick Blast

A fast, offline brick-breaker for Android built with Kotlin and Jetpack Compose.

Drag to aim, release to launch a stream of balls, and bounce them off the walls to smash descending bricks before they reach the bottom. Each round the bricks move down and a new row appears — plan your angles carefully.

Package: com.mostafa.brickblast

Screenshots

Gameplay	Main menu

Settings	Game over

Features

• Turn-based aim-and-shoot gameplay with a dotted trajectory preview
• Custom physics engine (60 FPS, spatial-hash collisions, swept ball movement)
• Collectable extra balls — your arsenal grows every round
• Power-ups: bomb, laser, multi-ball, and double damage
• Game modes: Classic, Challenge, Time Attack, Hardcore
• Brick destruction animations and particle effects
• Light and dark themes
• High-score tracking, statistics, and auto-save
• Share your score as an image to social apps
• Completely offline — no ads, no tracking, no internet permission

Tech stack

Layer	Libraries
UI	Jetpack Compose, Material 3
Architecture	MVVM, StateFlow, Coroutines
DI	Hilt
Navigation	Navigation Compose (type-safe routes)
Persistence	Room, DataStore
Rendering	Compose Canvas API

Build

Requirements: Android Studio Panda 3 or newer, JDK 17, Android SDK 37, min SDK 26.

# Debug APK
./gradlew assembleDebug

# Release APK (minified)
./gradlew assembleRelease

The debug APK is written to app/build/outputs/apk/debug/.

Local SDK path

Create local.properties in the project root if it does not exist:

sdk.dir=/path/to/Android/Sdk

F-Droid

This project is prepared for F-Droid submission:

• License: MIT (see LICENSE); Vazirmatn font under SIL OFL 1.1
• Metadata: metadata/com.mostafa.brickblast.yml
• Submission guide: docs/F-DROID.md
• Store listing: fastlane/metadata/android/en-US/
• Screenshots: fastlane/metadata/android/en-US/images/phoneScreenshots/

Current F-Droid target: v1.6.0 (versionCode 10). Signed fdroid APK: GitHub Releases.

Project structure

app/src/main/java/com/mostafa/brickblast/
├── data/          Room entities, DAOs, DataStore, repositories
├── domain/        Models and repository interfaces
├── game/          Engine, physics, particles, renderer, audio
├── navigation/    Type-safe routes and NavGraph
├── di/            Hilt modules
└── ui/            Screens, ViewModels, theme, components

License

MIT — Copyright (c) 2026 Mostafa Ashrafi