|
A simple, lightweight Android app built with love for a brother heading on a trip to Kashmir. Designed to help travelers track cash in, cash out, and daily expenses — all in one clean screen. |
My brother was going on a trip to Kashmir and needed a dead-simple way to manage his expenses on the go. No spreadsheets, no complex finance apps — just a clean cash book he could open, log an entry, and close.
So I built this over a weekend: a single-screen Android app that does exactly what he needed and nothing more.
- 💰 Cash In / Cash Out — Log income and expenses with a single tap
- 🧾 Cash in Hand — See your running balance at a glance
- 📅 Today's Balance — Track how much you've spent today
- 🔍 Search — Quickly find past entries
- 📷 Photo Attachments — Attach a receipt photo to any entry via camera capture or gallery pick, then tap the entry to view it full-screen
- 📄 Export to PDF — Save or share your cash book as a clean, table-based PDF for a chosen date range
- 👤 Profile — Set your name and photo, all stored locally on-device
- 🔒 Password Protection — Optionally lock the app with a password; once set, you're asked for it on cold launch (not on quick app-switches), keeping your cash book private
- 🧭 Simple Navigation — Bottom nav for Cash and Profile (Stock / Bill / Staff / Expense coming soon)
| Language | Java |
| Platform | Android |
| Min SDK | Android 7.0+ |
| Local Storage | Room (SQLite) for entries, SharedPreferences + internal file storage for profile/photos |
| UI | XML Layouts + Material Design Components |
| Build | Gradle (Kotlin DSL) |
- Android Studio (latest version recommended)
- JDK 11 or higher
- Android device or emulator (API 24+)
-
Install in your Android Device
-
Have Fun :)
- Clone the repository
git clone https://github.com/inamcodes/KashmirVoyagers.git-
Open in Android Studio
- File → Open → Select the cloned folder
-
Build the project
- Build → Build Bundle(s)/APK(s) → Build APK(s)
-
Run on device
- Connect your Android device via USB with USB Debugging enabled
- Click the ▶ Run button in Android Studio
KashmirVoyagers/
├── app/
│ └── src/
│ └── main/
│ ├── java/ # Java source files
│ ├── res/
│ │ ├── layout/ # XML layouts
│ │ ├── values/ # Colors, strings, themes
│ │ ├── drawable/ # Icons and backgrounds
│ │ └── mipmap/ # App launcher icons
│ └── AndroidManifest.xml
├── gradle/
├── build.gradle.kts
└── settings.gradle.kts
Contributions, bug reports, and feature ideas are welcome! Please read CONTRIBUTING.md for setup steps, coding conventions, and how to submit a pull request.
This project follows a Code of Conduct — by participating, you're expected to uphold it.
Found a security issue? Please don't open a public issue — see SECURITY.md for how to report it responsibly.
This project is open source and available under the MIT License.
inamcodes
GitHub: @inamcodes
Built with ❤️ for travelers. Safe travels, bhai/behin! 🏔️