Development Workflow
"/home/yossef/notes/git/projects/inguide/Development Workflow.md"
path: inguide/Development Workflow.md
- **fileName**: Development Workflow
- **Created on**: 2026-06-16 00:48:42
Development Workflow
Purpose: How a developer sets up, runs, changes, and verifies the InGuide project.
Prerequisites
- Android Studio (latest)
- JDK 17+
- Node.js 18+ (for maplibra_web)
- Android device or emulator (API 24+)
Setup
# Clone
git clone <repo>
cd inguide
# Set up environment
cp .env.example .env # Edit API keys
# Install JS deps
cd maplibra_web && npm install && cd ..
# Build web assets
./build-maplibra-web.sh
Run
# Build + install debug on connected device
./gradlew app:installDebug
Build Scripts
| Script | Purpose |
|---|---|
./build.sh |
Debug APK build |
./dev.sh |
Development build |
./release.sh |
Unsigned release APK |
./build-release.sh |
Unsigned release |
./build-release-full.sh |
Full signed release APK |
./build-sign-install.sh |
Build + sign + install |
./build-maplibra-web.sh |
Build web assets |
Change Workflow
- Edit Kotlin files in
app/src/ - Edit JS files in
maplibra_web/src/ - Rebuild:
./build-maplibra-web.sh && ./gradlew app:installDebug - Test:
./gradlew app:testDebugUnitTest
Related: ./Commands.md, ./Testing.md
continue:[[]]
before:[[]]