Skip to content
beagle1903 edited this page Aug 31, 2026 · 4 revisions

fund-helper

Local follow-only watchlist of Turkish TEFAS yatırım fonları. Search by code or name, follow or unfollow, and see latest price, returns, type, risk, and fees. Fund detail explains official TEFAS fields in short Turkish.

It is not a chat consultant, broker, or investment adviser. Informational only — not investment advice.

Status

Personal debug APK on a Samsung Galaxy A23 first. Play Store is later. Follows and snapshots stay on the phone (Room). No accounts or backend in v1.

Wiki pages

Screenshots

Wireframes of the v1 screens (sample TEFAS-style data, not live prices).

Takip listesi Boş liste
Takip listesi Boş takip listesi
Fon ara Fon detayı
Fon ara Fon detayı

Stack

Kotlin, Jetpack Compose, Hilt, Room. UI talks only to FundRepository, which uses Room and a swappable TefasClient (tefas.gov.tr JSON).

Build

Needs JDK 17+ and the Android SDK (compileSdk / targetSdk 36, minSdk 26). From the repo root:

.\gradlew.bat :app:assembleDebug

APK: app/build/outputs/apk/debug/app-debug.apk
Package: com.burha.fundhelper

Sideload (A23)

USB debugging, then .\gradlew.bat :app:installDebug (replaces the debug install, keeps Room). Do not uninstall.

CI

Pull requests and pushes to main run :app:testDebugUnitTest on GitHub Actions. No live TEFAS. No emulator.

Docs in repo

File Role
docs/context.md Product one-pager
docs/architecture.md Technical map
docs/decisions.md Architecture decisions
Frozen v1 design Frozen v1 spec
Implementation plan v1 plan
progress.md Short session handoff

Canonical version: README.md

Clone this wiki locally